Témaparancsok
Hozz létre egy témát, ellenőrizd, töltsd le és töltsd fel egy piszkozatba, nézd meg az élő előnézetét, tedd közzé vagy állítsd vissza egy korábbi verzióra – mindezt a poltura parancssorból.
Ezen az oldalon
A poltura theme a saját gépedről és a saját szerkesztődből kezeli a bolt témáit: tölts le egy témát egy mappába, szerkeszd, majd töltsd fel egy piszkozatba, amelyet egy előnézeti linken megtekinthetsz. A böngészős kódszerkesztő ugyanezeket a piszkozatokat szerkeszti, így mindkettőt használhatod. A telepítésről és a bejelentkezésről a CLI oldalon olvashatsz. Még nincs npm-en
| Parancs | Leírás |
|---|---|
poltura theme init <dir> | Létrehoz egy új témát a Poltura alaptémájából. |
poltura theme check <dir> | Ellenőrzi a témamappát: layout, szekciók, beállítások és típusok. |
poltura theme list | Kilistázza a bolt témáit. |
poltura theme pull | Letölti a téma fájljait és azok hash-értékeit egy mappába. |
poltura theme push | Feltölti a módosított fájlokat egy piszkozat témába. |
poltura theme dev | Minden mentést feltölt az élő téma egy fejlesztői másolatába, és kiírja annak előnézeti linkjét. |
poltura theme open | Kiírja a piszkozat előnézeti linkjét. |
poltura theme share | Kiírja a piszkozat előnézeti linkjét, mint az open elérési út nélkül. |
poltura theme publish | Közzéteszi a piszkozatot, vagy kiírja a linket, ahol valaki jóváhagyhatja. |
poltura theme rollback | Visszaállít egy korábbi verziót a piszkozatba. |
poltura theme package [dir] | Zipfájlba csomagolja a témamappát a témabolt számára. |
Az init, a check és a package csak fájlokkal dolgozik, és nem igényel bejelentkezést. A többi parancs egy hitelesítő adattal kommunikál a bolttal: először a --token, majd a POLTURA_TOKEN, végül a poltura login bejelentkezésed alapján, a Bejelentkezés vagy token használata részben leírtak szerint. A következő opciókat fogadják el: --api, --store, --dir <dir> (a téma mappája, alapértelmezés szerint az aktuális) és --json.
Jogosultságok
A szükséges jogosultság az adott parancstól függ:
| Parancs | Jogosultság | Szükséges jóváhagyás? |
|---|---|---|
list, pull, rollback a --revision nélkül | theme.read | Nem. |
open, share, és a dev által kiírt előnézeti link | theme.code.write és theme.write | Nem. |
push, dev | theme.code.write, valamint theme.write a fejlesztői másolathoz | Fájlok írásakor nem. Fájlok törlésekor igen: a CLI ezt jelzi, és kiírja a jóváhagyási linket. |
rollback --revision <id> | theme.write | Igen, mindig. |
publish | theme.publish | Igen, mindig. |
Egy API token pontosan azokat a jogosultságokat tartalmazza, amelyeket a létrehozásakor megadtál neki. A poltura login bejelentkezés alapértelmezés szerint minden olvasási jogosultságot elkér; add hozzá a szükséges írási jogosultságokat a poltura login --permissions theme.read,theme.code.write,theme.write,theme.publish paranccsal, és hagyd jóvá őket a böngészőben. A kérést egy ember hagyja jóvá a bolt adminfelületén az AI-ügynök kérései menüpont alatt. A jóváhagyás menetéről a Hogyan hajtanak végre műveleteket az ügynökök a boltodban oldalon olvashatsz.
Téma indítása és ellenőrzése
poltura theme init my-theme --name "My theme"
cd my-theme
poltura theme check .Az init egy üres mappába írja ki az alaptémát. A check ugyanaz az ellenőrzés, amely a kódszerkesztőben minden mentés után lefut, és minden hibánál megjelöli a fájlt, a sort és az oszlopot.
| Opció | Jelentés |
|---|---|
--types <packRoot> | A téma type checkingjéhez használt típuscsomag. A POLTURA_THEME_TYPES környezeti változóból is beolvasható. |
--json | Egyetlen JSON-sorként írja ki a jelentést. |
--base <dir> | A módosítás előtti állapot. Azoknak az elemfájloknak, amelyek eltérnek ettől, meg kell felelniük a készítési szabályoknak. |
--task-pack <file> | A Poltura AI-témafeladatai használják. Szükséges hozzá a --done-summary. |
--done-summary <text> | A Poltura AI-témafeladatai használják. Szükséges hozzá a --task-pack. |
Az ellenőrzéshez szükség van a téma típuscsomagjára: a --types vagy a POLTURA_THEME_TYPES nélkül (vagy ha nincs csomag telepítve az /opt/theme-types helyre) a parancs a következő hibával áll le: Requested typecheck did not run. A típuscsomag még nincs közzétéve, így a típusokat egyelőre a kódszerkesztő ellenőrzi, amely minden mentéskor lefuttatja ugyanezt az ellenőrzést. A parancs 1-es hibakóddal lép ki, ha a témában hiba van. A poltura check ezt az ellenőrzést a Poltura kódszabályaival együtt, egyetlen értékelésben futtatja le.
Letöltés, szerkesztés, feltöltés
poltura theme pull # the live theme into the current folder
poltura theme dev # a development copy, pushed on every saveA pull letölti az élő témát (vagy a --theme <id> által megadottat), és létrehozza a .poltura/theme.lock.json fájlt, amely megjegyzi az egyes fájlok letöltéskori hash-értékét. A parancsok egy letöltött téma bármely almappájából működnek. Az élő témába közvetlenül nem lehet feltölteni.
A dev az első alkalommal létrehozza az élő téma fejlesztői másolatát, és annak azonosítóját a lock fájlban tárolja. Feltölti a fájljaidat, kiírja az előnézeti linket, majd figyeli a mappát, és egy rövid szünet után minden elmentett fájlt feltölt. Az előnézetben a mentés a piszkozat buildelése után jelenik meg. A leállításhoz nyomj Ctrl+C-t.
A push feltölti a módosításokat egy piszkozatba: a fejlesztői másolatba, ennek hiányában a letöltött témába, vagy a --theme <id> által megadott témába. Biztonságos a szerkesztővel és más felhasználókkal szemben: ha egy fájl megváltozott a boltban, miután letöltötted, a feltöltés fájlonként egy-egy conflict sorral leáll, és semmit sem ír felül. Töltsd le újra a témát, vagy használd a --force opciót, amely csak olyan piszkozaton működik, amelyet ez a helyi munkapéldány hozott létre. A helyileg törölt fájl csak akkor törlődik a piszkozatból, ha valaki jóváhagyja.
Előnézet, megosztás, közzététel, visszaállítás
poltura theme open --path /products/hat
poltura theme share
poltura theme publish --wait
poltura theme rollback
poltura theme rollback --revision <id> --waitAz open kiírja a piszkozat előnézeti linkjét, a --path opcióval pedig megadhatsz egy webáruházi route-ot, például: /products/hat. A share ugyanezt a linket írja ki route nélkül. A link a piszkozat aktuális buildjéből származik, így ha a piszkozat még buildelődik, a parancs hibaüzenettel leáll; futtasd újra egy perccel később.
A publish a piszkozat közzétételét kéri a Polturától. A közzétételhez mindig emberi jóváhagyás szükséges: a parancs kiírja a jóváhagyási linket, a lejáratot és a futtatási azonosítót, majd 3-as kóddal kilép. A --wait opcióval megvárja a döntést, majd kiírja az eredményt. A jóváhagyási kártyán látható a téma neve, a módosított fájlok elérési útja, az előnézeti link és az esetleges új külső hosztok; külön code review lépés nincs. Lásd: Jóváhagyás.
A rollback a --revision nélkül kilistázza a piszkozat korábbi verzióit. A --revision <id> megadásával visszaállítja az adott verziót a piszkozatba, miután valaki jóváhagyta. Az élő bolt nem változik meg, amíg közzé nem teszed.
Csomagolás a témabolt számára
A poltura theme package [dir] egyetlen <name>.zip fájlba (vagy a --out <file> által megadott fájlba) tömöríti a mappát (a rejtett fájlok, a node_modules és a dist kivételével).