Štruktúrované písanie: Rétorika a proces

Recenzie čitateľov

Táto kniha sa zaoberá rétorickou konštrukciou značkovacích jazykov a tým, ako ich možno štruktúrovať na lepšiu komunikáciu s rôznymi publikami. Ponúka síce solídny prehľad pokročilých značkovacích jazykov, ako sú DITA a OWL, ale namiesto toho, aby sa zamerala na praktické metódy organizácie, opiera sa vo veľkej miere o históriu značkovania. Autor zdôrazňuje význam očakávaní publika pri určovaní toho, čo sa považuje za organizovaný obsah.

⬤ Komplexný prehľad pokročilých značkovacích jazykov
⬤ cenné poznatky o rétorických aspektoch organizácie obsahu
⬤ rozoberá význam publika a očakávaní
⬤ zavádza metajazyk pre značkovanie.

⬤ Obmedzené praktické rady týkajúce sa rozdelenia a organizácie informácií
⬤ prílišné zameranie na históriu značkovacích jazykov
⬤ nemusí spĺňať potreby tých, ktorí hľadajú praktickejšie pokyny.

(na základe 1 čitateľských recenzií)

Pôvodný názov:

Structured Writing: Rhetoric and Process

Obsah knihy:

Štruktúrované písanie nebolo nikdy dôležitejšie ani mätúcejšie. Je ľahké stratiť sa v mori skratiek a módnych slov: sémantika, XML, metadáta, DITA, štruktúra, DocBook, hypertext, Markdown, témy, XSLT, opakované použitie, LaTeX, silá, HTML, ad infinitum. Štruktúrované písanie prechádza cez tento šum a vysvetľuje, čo je štruktúrované písanie a ako môžete používať rôzne štruktúry na dosiahnutie rôznych cieľov. Zameriava sa na to, ako môžete rozdeliť a riadiť zložitosť vývoja a poskytovania obsahu, aby ste zabezpečili efektívnu rétoriku a účinné procesy.

Úvod: definuje štruktúrované písanie, vzťah medzi rétorikou a procesom a dôležitosť správneho rozdelenia zložitosti.

Domény štruktúrovaného písania: predstavuje štyri domény štruktúrovaného písania: médiá, dokument, predmet a riadenie a ukazuje, ako vám pochopenie týchto domén môže pomôcť pri vytváraní štruktúr, ktoré podporujú kvalitné písanie.

Proces, rétorika a štruktúra: opisuje, ako štruktúra podporuje vaše procesy aj rétoriku. venuje sa aj informačnej architektúre a úlohe pisateľov pri vytváraní obsahu, ktorý spĺňa potreby vašej organizácie.

Algoritmy: skúma hlavné algoritmy štruktúrovaného písania vrátane jednotného zdroja, opakovaného použitia, prepojenia, aktívneho obsahu, generovaného obsahu a publikovania.

Štruktúry: podrobne skúma štruktúry vrátane blokov, rozsiahlych štruktúr a skladateľných štruktúr. Venuje sa aj metadátam, správe terminológie a zhode.

Jazyky: prehľad jazykov, ktoré sa v súčasnosti používajú na štruktúrované písanie, od ľahkých jazykov ako Markdown a reStructuredd104 až po ťažké jazyky ako DITA a DocBook. Ďalej sa zaoberá rozšírením a obmedzením jazykov.

Správa: sa zaoberá systémami správy obsahu a skúma, ako podporiť spoluprácu, zabrániť duplicite a kontrolovať obsah.

Návrh: sa zaoberá tým, ako identifikovať zložitosť a vhodne ju rozdeliť pri návrhu systému, a potom sa zaoberá tým, ako vybrať procesy a nástroje potrebné na podporu potrieb obsahu vašej organizácie.