Laravel Maestro Contributor Tutorial

Starter Kits-களை உருவாக்க Laravel Maestro-வைப் பயன்படுத்துகிறது. இந்த kits-களில் பங்களிப்பதற்கான ஆவணங்கள் மிகக் குறைவாகவே உள்ளன.

நீங்கள் ஒரு Starter Kit-இல் புதிய அம்சங்களைச் சேர்க்க விரும்பினால் அல்லது பிழைகளைத் (bugs) திருத்த விரும்பினால், அதன் பணிப்பாய்வை (workflow) நீங்கள் புரிந்துகொள்ள வேண்டும். Maestro-வை எவ்வாறு சரியாகப் பயன்படுத்துவது என்பதை இந்த வழிகாட்டி விளக்குகிறது.

The Directory Structure

இந்தத் தொகுப்பில் (repository) மூன்று முக்கியப் பகுதிகள் உள்ளன:

  • kits/: இது உண்மையான Starter Kit கோப்புகளைக் கொண்டுள்ளது. நீங்கள் commit செய்யும் ஒரே கோப்புறை இதுதான்.
  • orchestrator/: இது build செயல்முறையை நிர்வகிக்கிறது மற்றும் kits-களை இயக்குகிறது.
  • build/: இது ஒரு தற்காலிகப் பணி இடம் (workspace). நீங்கள் ஒரு build-ஐ இயக்கும்போது Maestro இதை உருவாக்குகிறது.

The Development Workflow

ஒரே நேரத்தில் பல கோப்புகளைப் புதுப்பிக்கவில்லை என்றால், kits/ கோப்புரையில் நேரடியாகப் பணியாற்ற வேண்டாம். அதற்குப் பதிலாக, இந்தப் படிகளைப் பின்பற்றவும்:

  1. Setup the environment orchestrator/ கோப்புறைக்குச் செல்லவும். composer install மற்றும் npm install ஆகியவற்றை இயக்கவும்.

  2. Build your target kit php artisan build என்பதை இயக்கவும். உங்கள் framework, variant மற்றும் அம்சங்களைத் தேர்ந்தெடுக்கவும். இது build/ கோப்புறையை உருவாக்கும்.

  3. Run the kit orchestrator/ கோப்புறையிலிருந்து composer kit:run என்பதைப் பயன்படுத்தவும். இது port 8000-இல் செயலியைத் தொடங்கும்.

  4. Make your changes build/ கோப்புறையைத் திறக்கவும். நீங்கள் மாற்ற வேண்டிய கோப்புகளைக் கண்டறிந்து அவற்றை எடிட் செய்யவும்.

  5. Let the watcher work Maestro ஒரு watcher-ஐப் பயன்படுத்துகிறது. நீங்கள் build/ கோப்புறையில் ஒரு கோப்பைச் சேமிக்கும்போது, அது kits/ கோப்புறையில் உள்ள சரியான கோப்பைத் தானாகவே புதுப்பிக்கும்.

  6. Test your changes முதலில் kit:run செயல்முறையை நிறுத்தவும். kit இயங்கிக்கொண்டிருக்கும்போது உங்களால் சோதனைகளை (tests) இயக்க முடியாது. orchestrator/ கோப்புறையிலிருந்து, பின்வருவனவற்றை இயக்கவும்:

  • composer kits:pint (formatting-க்காக)
  • composer kits:check (PHP சோதனைகளுக்காக)
  • composer kits:lint (JavaScript சோதனைகளுக்காக)
  1. Commit your work உங்கள் git status-ஐச் சரிபார்க்கவும். kits/ கோப்புறையில் மாற்றங்களைக் காண வேண்டும். உங்கள் commit-இல் kits/ கோப்புறையை மட்டும் சேர்க்கவும்.

Example: Changing text from "Log in" to "Log on"

  • build/ உள்ளே இருக்கும் blade அல்லது component கோப்பை எடிட் செய்யவும்.
  • kits/ கோப்புறையைத் புதுப்பிக்க watcher-க்காகக் காத்திருக்கவும்.
  • மற்ற variants-களைப் பாதிக்கவில்லை என்பதை உறுதிப்படுத்த சோதனைகளை இயக்கவும்.
  • kits/ இல் உள்ள கோப்புகளை commit செய்யவும்.

இந்தச் செயல்முறை உங்கள் பங்களிப்பு சுத்தமாகவும் Maestro கட்டமைப்பைப் பின்பற்றியும் இருப்பதை உறுதி செய்கிறது.

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