vitrinka.docs
Práce ve vitrince

Dokumenty a stránky

Jedno zobrazení dokumentu pro každý push, čtenářská nastavení, publika, export do PDF, HTML, e-mailu a Wordu, komentáře na okraji a stránky psané společně naživo.

Dva druhy psaní

KartaCo to je
StránkaDokument 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.
DokumentSlož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 a reference elementů.

Psaní ve více lidech

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

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).

Lišta čtenáře

Složený dokument nese v hlavičce řadu menu.

MenuCo nastavuje
AppearanceVzhled, 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í.
AudienceUkáže se, když autor označil bloky pro určité čtenáře: Everyone, Public, Technical nebo Internal. Volba skryje bloky psané pro ostatní.
ExportPDF, HTML, Email nebo Word — níže.
ShareOdkaz, který se otevře přímo na tomto dokumentu — sdílení.
CommentKomentář k dokumentu — níže.
DeleteSmaž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

  • 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

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. Host na odkazu pro anotace komentuje také; jeho komentáře čekají na člena workspace.

Sdílení dokumentu

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.

Na této stránce