Miért fejleszt az ember a Drupal.org-ra egy saját modult?
Akkor készítünk contrib modult, ha van egy olyan ötletünk, amit sokan tudnának használni és még nincsen meg a funkció modulként a Drupal.org-on vagy máshol a világon. Ha azt akarom, hogy a modulomat a világon sokan használják, akkor a fejlesztett modult a Drupal.org-ra teszem fel. A Drupal.org-on van egy minőségbiztosítási felület is, ezért is érdemes odatenni a modult.
Kezdés
- Kell egy account a Drupal.org-ra: Itt lehet készíteni
- Meg kell ismerkedni a GIT verziókezelő rendszerrel, mert a drupal.org azt használja.
- Telepíteni kell a GIT-et a saját gépre.
- Néhány alap parancsot el kell sajátítani
- A Drupal.org-on létre kell hozni egy új projektet: Belépés => My Dashboard => Your Projects => Add new project
- Készíteni kell egy Module projectet (vagy akármi mást)
- Ki kell választani a nevét
- A rövid nevét
- A típusát (Full project vagy Sandbox project) - A Sandbox projektet nem lehet publikálni, a Full projektet mindenki eléri.
- A kezelési gyakoriságát (Maintenance Status - Aktív, minimálisan karbantartott, társak keresése, új karbantartó keresése, nem támogatott)
- A fejlesztés állapota (aktívan fejlesztett, hibajavítások csak, nincsenek további fejlesztési tervek, nem továbbfejlesztendő)
- a modul kategóriáját.
- A modul leírását el kell készíteni szövegesen, erre nem térek ki. A mentés után létrejön a leírás
A Drupal org-on a projekt létrejötte után az alábbi parancsokat kell használni a GIT-en
mkdir project_rovid_nev
cd project_rovid_nev
git init
git add *
git checkout -b @branch
echo "Projekt neve" > README.txt
git add README.txt
git commit -m "Initial commit."
git add *
git remote add origin git@git.drupal.org:project/fz_songbook.git
git push origin @branch
Ha tag-et (=végleges verziót) akarunk készíteni a Drupal.org-on, akkor
git tag 7.x-1.0 //vagy valami más verziószám...
git push --tags
Ha csak egy tag-et akarunk feltölteni, akkor
git push origin tag 7.x-1.0
Ha csak ellenőrizni akarjuk a tag-eket, akkor
git tag -l
Branchokkal (development verzió = fejlesztési verzió) való munka
Készítsünk új fejlesztési verziót
git checkout -b 7.x-2.x
Ha készítettünk egy fejlesztési verziót, azt töltsük fel a remote adatbázisba
git push origin 7.x-2.x
az aktuális brancj kikérése
git checkout 7.x-2.x
A létező branch-ok listája
git branch -v
Az -u hatására a helyi aktuális kód lesz a remote aktuális
git checkout -b 7.x-1.x
git push -u origin 7.x-1.x
Branch / tag törlése
Ha tag-et akarunk törölni. A második parancs akkor kell, ha a remote szerveren fel van töltve a branch
git branch -d brach_neve
git push origin :branch_neve
Ha tag-et akarunk törölni. A második parancs akkor kell, ha a remote szerveren fel van töltve a tag
git tag -d tag_neve
git push origin :tag_neve