Sady: záznam a publikování
Sada je adresář souborů se sdílecí adresou. vitrinka set je způsob, jak ji založit, naplnit a odeslat — a při každém pushi jde celá znovu, takže push po době offline doplní všechno.
Založení sady
Vytvoří v repozitáři .vitrinka konfiguraci sady, aby pushe věděly, kam míří.
vitrinka set initPořízení snímku
Pořídí snímek rovnou do sady a pushne ho. Umí řídit iOS simulátor, Android emulátor, macOS i prohlížeč — nebo převzít obrázek, který už máte.
vitrinka set capture web \
--route /checkout \
--note "sleva se počítá dvakrát" \
--open https://localhost:3000/checkout--note a --route jsou povinné: snímek bez obojího je obrázek, který nikdo nezařadí.
Přepínače pro capture
| Přepínač | Co dělá |
|---|---|
--route | Povinné. Routa aplikace, na které snímek vznikl. |
--note | Povinné. Popisek. |
--title | Lidský název — zároveň pojmenuje soubor. |
--label | Stabilní označení snímku. Míří na něj propojení cest. |
--next | Větev cesty: označení cílového snímku. Lze opakovat. |
--target | JSON bbox {X,Y,W,H} prvku, na který se kliklo — následuje po --next. |
--open | Deep link, který se otevře před pořízením snímku. |
--settle | Kolik sekund počkat. Výchozí 4 s --open, jinak 0. |
--viewport | WxH nebo WxH@scale, např. 393x852@3. |
--udid | UDID iOS simulátoru. |
--region | Oblast pro macOS, x,y,w,h. |
--file | Převezme existující obrázek místo pořízení nového. |
--hq | Plná kvalita: bez ztrátové rekomprese a bez zmenšení. |
--src | Zdrojový soubor, který to implementuje. Lze opakovat nebo oddělit čárkami. |
--state | Významný stav aplikace nebo přihlášení. |
--url | Adresa původu — v manifestu má přednost před --open. |
--root | Kořen záznamu. Výchozí .vitrinka/screenshots. |
Odeslání sady
Zabalí kořen záznamu a nahraje ho. Idempotentní — celá sada jde pokaždé, takže opakované spuštění obsah nahradí, ne přidá.
vitrinka set push --title "Košík — třetí kolo"| Přepínač | Co dělá |
|---|---|
--root | Kořen záznamu. Výchozí .vitrinka/screenshots. |
--title | Lidský název, posílá se při každém pushi. |
--source | Prováže zdrojovou sadu: project/branchSlug/key. |
Pojmenování a rámec
meta nastaví hlavičku cesty — kicker, název, akcent, úvod a chipy. rename dá sadě stabilní vlastní jméno, takže čitelná adresa funguje vedle číselné.
vitrinka set meta --title "Košík" --kicker "třetí kolo"
vitrinka set rename myapp/main/7 payout-flowArtefakty
Artefakt je samostatná interaktivní stránka, ne galerie. init ji připraví i s konfigurací sady, create postaví report z existující sady snímků.
vitrinka artifact init
vitrinka artifact create