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í
| 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 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.
| 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. |
| Share | Odkaz, který se otevře přímo na tomto dokumentu — sdílení. |
| Comment | Komentář k dokumentu — níže. |
| 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
- 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
.emls 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.
Práce na nástěnce
Pohyb po plátně, přidávání a uspořádání karet, ostrůvky na okrajích plátna a zpět, které vrací vždy jen vaši vlastní práci.
Sdílení s lidmi zvenku
Sdílené odkazy pro klienty, designéry a testery bez účtu — co odkaz zpřístupní, co host smí, jak na vás práce hostů počká a jak přístup zase vzít zpět.