SW pro správu manuálů

[Exe]

Zdravím,

potřebuji najít program, který pracuje s šablonami a když změním něco v šabloně, změní se to i v dokumentech, které byly dříve vytvořeny na základě té šablony. Šablony zvládá třeba jen MS Word, ale po změně šablony se změní pouze styly, ne text. Stejně tak v nadstavbě doc-to-help či Adobe Indesign.

Jak se pak udržuje třeba 20 různých manuálů, když se nějaké společné info změní? Ručně se to všechno přepisuje? To bych chtěl trochu zautomatizovat.

Díky za návrhy

[Reklama]

[VojtaF]

HTML se spolecnym CSS. Zmenis styl v CSS a zmena se projevi ve vsech HTML dokumentech.

[Exe]

Já právě styl měnit nepotřebuji, potřebuji měnit text v šabloně, čímž se změní i text v existujících dokumentech.

[VojtaF]

Aha, to je taky resitelne ale je potreba uz nejaky builder v node.js napriklad grunt. Tam existuje plugin grunt-html-fragment, ktery jak nazev rika umoznuje spojeni vice fragmentu v jeden dokument. V cilovem html jen zapises na pozadovane misto neco jako

Kód [Vybrat] Rozbalit

<!-- @@include= nejaka/cesta/hlavicka.html -->
Kdyz pak zmenis texty v hlavicka.html a das buildnout tak se ta zmena v hlavicce projevi ve vsech vyslednich dokumentech co jej pouzivaji.
https://www.npmjs.com/package/grunt-html-fragment

Tohle je takove rychle reseni. Pro serioznejsi knihovnu je lepsi uz pouzit neco hotoveho napriklad Assemble

http://assemble.io/
http://assemble.io/docs/Markdown.html

[Exe]

díky za radu, vypadá to dobře

[Reklama]

[blb]

Co hugo, jekyll?

[PavelŽ]

Pro psaní manuálů lze použít i Docbook (XML). Dá se OS prostředky převést na PDF, HTML a další  formáty (CHM). Používám léta k plné spokojenosti.

[Tester]

mne sa paci ako je organizovana/napisana dokumentacia k postgresu a jednotlivym verziam. Viete aky program alebo ako vytvorit a udrziavat dokumentaciu v podobnom style?
Dakujem.

[VojtaF]

Tady jsou nejaky zdrojaky z toho postgresu, markdown dokumenty. Postourejte se v tom a mozna tam je neco v cem to builduji do html.
https://github.com/pgjdbc/pgjdbc/tree/master/docs

[TomBA]

Tiež mi to smeruje ku DocBook

[.]

Jen doplním, že psát přímo v DocBooku je docela opruz, pokud nemáte editor, který to přímo podporuje. Velice rozumným předstupněm je ASCIIDoc, který se snadno do DocBooku převede.

[Sten]

A co Sphinx? Používá to třeba linuxové jádro.

[PavelŽ]

Jen doplním, že psát přímo v DocBooku je docela opruz, pokud nemáte editor, který to přímo podporuje.

Pod Windows používám TextPad s šablonami a barevným zvýrazněním a opruz se mi jeví přijatelným. Asi by šel upravit i Vim.