# Dokumenty a stránky (https://docs.vitrinka.ai/cs/use/documents) ## Dva druhy psaní [#kinds] | Karta | Co to je | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Stránka | Dokument psaný přímo na nástěnce v blokovém editoru, klidně několika lidmi najednou. Agenti tutéž stránku čtou a píšou jako markdown. Stránka publikovaná ze souboru ve vašem repozitáři se obnoví pokaždé, když se ten soubor publikuje znovu. | | Dokument | Složený z prvků — textu, tabulek, grafů, diagramů, galerií, calloutů, kódu — agentem nebo pushem a čtený v zobrazení dokumentu níže. Na nástěnce ✎ otevře jeho prvky jako JSON; text, který píšete sami, patří do stránky. | Co autor může do dokumentu dát a jak ho publikovat, popisuje [autorská část](/cs/dev/skills/authoring) a [reference elementů](/cs/reference/elements). ## Psaní ve více lidech [#together] Otevřete stránku — dvojklikem, tlačítkem ✎ **edit the page** v liště výběru nebo ⌘E — a pište. Každý, kdo stránku upravuje, vidí kurzory ostatních a každou změnu, jak vzniká; nic se neukládá ručně a nic se nezamyká. Přes sdílený odkaz je stránka jen ke čtení. ## Jedno zobrazení dokumentu [#view] Každý publikovaný dokument — složený dokument, `index.html` i složka souborů — se otevře jako jedno zobrazení na vlastní adrese a otevře se tam i karta dokumentu z nástěnky (**open** v její liště výběru). Publikovaná sada snímků obrazovky se místo toho otevře jako nástěnka své cesty. * **Osnova** — panel po straně vypisuje kapitoly dokumentu a dokumenty propojené kolem něj; kliknutí plynule doskočí na místo. Když ji sbalíte, zůstane na tomto zařízení sbalená. * **Odkazy** — každá sekce má kotvu, zadanou autorem nebo odvozenou z nadpisu, takže odkaz může mířit na sekci a zobrazení se otevře právě tam. Dokumenty na sebe odkazují a buňky tabulek mohou vést k důkazu, o který se tvrzení opírá. * **Publikovaná webová stránka** — v hlavičce má z lišty níže Appearance (jen vzhled), Share a Comment a navíc ⤓ ke stažení publikovaných souborů jako ZIP. * **Delete** — ikona koše na konci hlavičky (pro členy, nikdy pro čtenáře ani hosty na odkazu) po potvrzení dokument smaže. Publikovaný artefakt zmizí celý: jeho stránky, jeho místo v Docs › Artifacts i jeho soubory. Undo ho hned vrátí; později jeho adresa 30 dní ukazuje, kdo ho smazal a kdy, s tlačítkem **Restore** — pak je nenávratně odstraněn. Push téhož artefaktu je, dokud je smazaný, odmítnut; obnovte ho, nebo pushněte s `--revive` ([sady](/cs/dev/cli/sets#push)). ## Lišta čtenáře [#viewer-bar] Složený dokument nese v hlavičce řadu menu. | Menu | Co nastavuje | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Appearance | Vzhled, pak text. Vzhled: House (motiv vaší aplikace), Light paper nebo Dark paper (vzhled House připnutý světle nebo tmavě bez ohledu na motiv aplikace), nebo jeden ze stylů nástěnek — vlastní styl nástěnky dokumentu je označený jako výchozí. Text: velikost písma, řádkování, délku řádku, písmo (House nebo Hyperlegible), širší rozestupy textu (WCAG 1.4.12), zvýraznění začátků slov (focus letters) a režim čtení — jen text, bez osnovy a bez komentářů. Reset all vrátí obojí. Drží se jen na tomto zařízení; samotný dokument se nikdy nemění. | | Audience | Ukáže se, když autor označil bloky pro určité čtenáře: Everyone, Public, Technical nebo Internal. Volba skryje bloky psané pro ostatní. | | Export | PDF, HTML, Email nebo Word — [níže](#export). | | Share | Odkaz, který se otevře přímo na tomto dokumentu — [sdílení](/cs/use/sharing#mint). | | Comment | Komentář k dokumentu — [níže](#comments). | | Delete | Smaže dokument — nebo publikovaný artefakt celý — do koše na 30 dní; vrátí ho Undo nebo **Restore** na jeho stránce. Jen pro členy. | ## Export [#export] * **PDF** — stránky připravené k tisku. Na instalaci bez PDF služby se místo toho otevře tiskový dialog prohlížeče; zvolte Uložit jako PDF. * **HTML** — jedna soběstačná stránka, vytvořená ve vašem prohlížeči z toho, co vidíte. * **Email** — koncept `.eml` s obrázky přímo v textu, připravený k otevření v poštovním klientu. * **Word** — upravitelný soubor `.docx`. Každý export zachová zvolené publikum. PDF, Email a Word vyrábí server a zapisuje je do auditního logu jako váš export. Skripty si tytéž soubory stáhnou z `GET /api/v1/boards/{slug}/cards/{id}.pdf` (případně `.eml`, `.docx`) a zúží je parametrem `?audience=`. ## Komentáře [#comments] Označte pasáž a okomentujte ji, nebo u publikované stránky použijte **▭ pin a region**. Vlákno se otevře v postranním panelu u své pasáže a zůstane u ní, i když se stránka přeskládá. V klidu se karta jen čte — kdo, kdy, citovaná slova, komentář a odpovědi na něj; klikněte do ní a objeví se ✓ pro vyřešení a pole pro odpověď. Vlákna, jejichž pasáže odjely z obrazovky, se shromáždí do pilulky nahoře nebo dole v panelu — ↑ 3 comments, ↓ 2 comments — a každé kliknutí na ni doroluje k nejbližšímu z nich a zaměří jeho kartu. Komentář je anotace na kartě dokumentu, takže prochází stejným odkládáním a končí ve stejné frontě agenta jako oblast nakreslená na nástěnce — [anotace](/cs/qa/annotating). Host na odkazu pro anotace komentuje také; jeho komentáře čekají na člena workspace. ## Sdílení dokumentu [#share] **Share** v liště čtenáře vytvoří odkaz, který se otevře rovnou na tomto dokumentu. Pořád ale zpřístupní celou nástěnku, na které dokument leží — [sdílení s lidmi zvenku](/cs/use/sharing).