Strukturált írás: Retorika és folyamat

Olvasói vélemények

Ez a könyv a jelölőnyelvek retorikai felépítésével foglalkozik, és azzal, hogyan lehet őket strukturálni a különböző célközönséggel való jobb kommunikáció érdekében. Bár szilárd áttekintést nyújt az olyan fejlett jelölőnyelvekről, mint a DITA és az OWL, a gyakorlati szervezési módszerekre való összpontosítás helyett nagymértékben támaszkodik a jelölés történetére. A szerző hangsúlyozza a közönség elvárásainak fontosságát annak meghatározásában, hogy mi tekinthető szervezett tartalomnak.

⬤ Átfogó áttekintés a fejlett jelölőnyelvekről
⬤ értékes betekintést nyújt a tartalomszervezés retorikai aspektusaiba
⬤ tárgyalja a közönség és az elvárások fontosságát
⬤ bemutatja a jelölés metanyelvét.

⬤ Korlátozott gyakorlati tanácsok az információ felosztásával és szervezésével kapcsolatban
⬤ túlzott hangsúlyt fektet a jelölőnyelvek történetére
⬤ nem feltétlenül felel meg azoknak, akik gyakorlatiasabb útmutatást keresnek.

(1 olvasói vélemény alapján)

Eredeti címe:

Structured Writing: Rhetoric and Process

Könyv tartalma:

A strukturált írás még soha nem volt ennyire fontos és ennyire zavaró. Könnyű elveszni a rövidítések és a divatos szavak tengerében: szemantika, XML, metaadatok, DITA, struktúra, DocBook, hipertext, Markdown, topik, XSLT, újrafelhasználás, LaTeX, silók, HTML, a végtelenségig. A Strukturált írás átvág a zajon, elmagyarázza, mi a strukturált írás, és hogyan használhat különböző struktúrákat különböző célok eléréséhez. Arra összpontosít, hogyan lehet felosztani és kezelni a tartalomfejlesztés és -szolgáltatás összetettségét a hatékony retorika és a hatékony folyamatok biztosítása érdekében.

Bevezetés: meghatározza a strukturált írás fogalmát, a retorika és a folyamatok közötti kapcsolatot, valamint a komplexitás megfelelő felosztásának fontosságát.

A strukturált írás területei: bemutatja a strukturált írás négy területét: a média, a dokumentum, a téma és az irányítás területét, és megmutatja, hogy e területek megértése hogyan segíthet a minőségi írást támogató struktúrák kialakításában.

Folyamat, retorika és struktúra: leírja, hogy a struktúra hogyan támogatja mind a folyamatokat, mind a retorikát. elmélyül az információs architektúrában és az írók szerepében is a szervezet igényeinek megfelelő tartalom létrehozásában.

Algoritmusok: a fő strukturált írási algoritmusokat vizsgálja, beleértve az egyszeri beszerzést, az újrafelhasználást, a linkelést, az aktív tartalmat, a generált tartalmat és a közzétételt.

Struktúrák: a struktúrákat vizsgálja meg alaposan, beleértve a blokkokat, a széles struktúrákat és az összetehető struktúrákat. A metaadatokkal, a terminológiakezeléssel és a konformitással is foglalkozik.

Nyelvek: a strukturált íráshoz jelenleg használt nyelvek áttekintése, a könnyű nyelvektől, mint a Markdown és a reStructuredd104 az olyan nehéz nyelvekig, mint a DITA és a DocBook. Ezután a nyelvek kiterjesztésével és korlátozásával foglalkozik.

Management: a tartalomkezelő rendszerekkel foglalkozik, és feltárja, hogyan lehet támogatni az együttműködést, elkerülni a duplikációkat és ellenőrizni a tartalmat.

Tervezés: azt vizsgálja, hogyan lehet azonosítani a komplexitást és megfelelően felosztani azt a rendszer tervezésekor, majd azt, hogyan lehet kiválasztani a szervezet tartalmi igényeinek támogatásához szükséges folyamatokat és eszközöket.