A weboldal inaktív, archivált üzemmódban működik, csökkentett funkciókkal.
Dokumentáció
Forráskód letöltése a Monotone segítségével
Időpont: 2009. Március 29.Ez a leírás azoknak szól akik szeretnének hozzájutni a fejlesztés alatti aktuális Xaraya forráskódhoz a Monotone forráskód kezelő rendszerből.
Akinek a modulok hivatalos kiadásaira van szüksége, használja a Xaraya letöltések oldalt, ne a Monotone-t. Akiknek írás jogosultságra van szüksége a Xaraya forráskódhoz, a Fejlesztés Monotone-nal (angol) című leírás nyújt segítséget.
A Monotone letöltése
A hivatalos oldalról töltsük le a Monotone legfrissebb váloztatát (http://monotone.ca) vagy használjuk az operációs rendszer csomagkezelőjét a telepítéshez (a legtöbb Linux változat alapértelmezésben tartalmazza a Monotone-t, így elég a szokásos telepítőprogramban megkeresni és telepíteni.) Legalább 0.40-es változat szükséges.
A Xaraya forráskód tárolására szolgáló adatbázis fájlok létrehozása
A következő paranccsal létrehozhatunk egy üres adatbázist fájlt:
# mtn -d modules.db db init
Javasolt a Xaraya különböző nagyobb egységeit külön adatbázis fájlokban tárolni, a következők szerint:
- core.db
- modules.db
- themes.db
- languages.db
A forráskód letöltése
Az üres adatbázis fájl létrehozása után beletölthetjük a kívánt fejlesztési ágat, például egy modul kódját. A http://mt.xaraya.com/ oldalon megnézhetjük, hogy milyen fejlesztési ágak (branch) vannak jelenleg. Az egyes modulokat - melyek fejlesztési ágként szerepelnek - általában a modules.db fájlban tároljuk.
# mtn -d modules.db pull mt.xaraya.com com.xaraya.modules.[modul neve]
.
A „modul neve” helyére természetesen a letölteni kívánt modul nevét kell írni, például: articles, xarbb stb.
A -d után a használandó adatbázis neve áll (ez minden „mtn” parancsra igaz), „pull” a letöltési parancs, utána a szerver ahonnan letöltünk, végül pedig a letöltendő fejlesztési ág.
A munkamásolat kicsekkelése
(Közismert magyar fordítás hiányában... a „check out” azt a műveletet jelenti, amikor egy forráskód kezelő rendszerből kimásoljunk a számunkra szükséges fájlokat, úgy, hogy azok továbbra is a forráskód kezelő hatókörében maradnak. A kimásolt fájlokat „working copy”-nak nevezik, ami egy már szerkeszthető, fejleszthető változat az adott program forráskódjából. A „kicsekkeléssel” tulajdonképpen létrehozzuk a munkamásolatot. - szerk)Az adatbázis fájlba letöltött legfrissebb kódot most ki kell nyernünk a saját fájlrendszerünkre:
# mtn -d modules.db co -b com.xaraya.modules.articles articles
Az így kapott munkamásolaton már dolgozhatunk.
Ebben a parancsban is a -d után az adatbázis fájlt jelöljük meg, „co” a check-out parancs, -b után a fejlesztési ág (branch), végül a cél könyvtár áll (amely ilyenkor még nem létezhet. Ha már korábban kicsekkeltük, akkor már csak frissíteni (update) lehet, lásd lentebb.
Javasolt a modulokat egy közös modules
könyvtárba kicsekkelni, vagy akár egy „core” munkamásolat alatti „html/modules” könyvtárba, így közvetlenül futtatható, például:
# mtn -d core.db co -b com.xaraya.core ./xaraya
# mtn -d modules.db co -b com.xaraya.modules.articles ./xaraya/html/modules/articles
A Xaraya kód frissen tartása
Az adatbázis fájlokba letöltött kód frissítésére használjuk ugyanazt a parancsot mint a letöltéshez:
# mtn -d modules.db pull mt.xaraya.com com.xaraya.modules.articles
Majd frissítsük a munkamásolatot:
# cd articles
(vagy cd xaraya/html/modules/articles
)
# mtn update
Használhatunk csillagot a nevekben, így például minden modult egyszerre letölthetünk:
# mtn -d modules.db pull mt.xaraya.com "com.xaraya.modules.*"
(A macskakörmök a shell beheylettesítése miatt szükségesek.) Ezután a parancs után a munkamásolatokat egyesével kell frissítenünk.
Kapcsolódó programok
A Monotone-hoz számos kiegészítő program érhetó el a http://monotone.ca/wiki/InterfacesFrontendsAndTools/ címen.