Laravel Maestro Katılımcı Eğitimi

Laravel, Starter Kit'leri oluşturmak için Maestro kullanır. Bu kitlere katkıda bulunmaya yönelik dokümantasyon oldukça kısıtlıdır.

Bir Starter Kit'e özellik eklemek veya hataları düzeltmek istiyorsanız, iş akışını anlamanız gerekir. Bu kılavuz, Maestro'nun nasıl doğru kullanılacağını açıklar.

Dizin Yapısı

Deponun üç ana bölümü vardır:

  • kits/: Gerçek Starter Kit dosyalarını barındırır. Commit yapacağınız tek dizin budur.
  • orchestrator/: Derleme sürecini yönetir ve kitleri çalıştırır.
  • build/: Bu geçici bir çalışma alanıdır. Maestro, bir derleme çalıştırdığınızda bunu oluşturur.

Geliştirme İş Akışı

Aynı anda birçok dosyayı güncellemiyorsanız, doğrudan kits/ dizini içinde çalışmayın. Bunun yerine şu adımları izleyin:

  1. Ortamı kurun orchestrator/ klasörüne gidin. composer install ve npm install komutlarını çalıştırın.

  2. Hedef kitinizi derleyin php artisan build komutunu çalıştırın. Çerçevenizi, varyantınızı ve özelliklerinizi seçin. Bu, build/ klasörünü oluşturur.

  3. Kiti çalıştırın orchestrator/ klasöründen composer kit:run komutunu kullanın. Bu, uygulamayı 8000 portunda başlatır.

  4. Değişikliklerinizi yapın build/ dizinini açın. Değiştirmeniz gereken dosyaları bulun ve düzenleyin.

  5. Watcher'ın çalışmasına izin verin Maestro bir watcher kullanır. build/ içindeki bir dosyayı kaydettiğinizde, kits/ dizinindeki doğru dosyayı otomatik olarak günceller.

  6. Değişikliklerinizi test edin Önce kit:run işlemini durdurun. Kit çalışırken testleri çalıştıramazsınız. orchestrator/ klasöründen şunları çalıştırın:

  • composer kits:pint (biçimlendirme için)
  • composer kits:check (PHP testleri için)
  • composer kits:lint (JavaScript testleri için)
  1. Çalışmanızı commit'leyin Git durumunuzu kontrol edin. kits/ klasöründe değişiklikleri görmelisiniz. Commit'inize yalnızca kits/ dizinini ekleyin.

Örnek: Metni "Log in" yerine "Log on" olarak değiştirmek

  • build/ içindeki blade veya component dosyasını düzenleyin.
  • Watcher'ın kits/ dizinini güncellemesini bekleyin.
  • Diğer varyantları bozmadığınızdan emin olmak için testleri çalıştırın.
  • kits/ içindeki dosyaları commit'leyin.

Bu süreç, katkınızın temiz kalmasını ve Maestro mimarisini takip etmesini sağlar.

Kaynak: https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89