Fórum Root.cz

Hlavní témata => Software => Téma založeno: Exe 21. 03. 2018, 11:08:51

Název: SW pro správu manuálů
Přispěvatel: Exe 21. 03. 2018, 11:08:51

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

Název: Re:SW pro správu manuálů
Přispěvatel: VojtaF 21. 03. 2018, 11:16:13

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

Název: Re:SW pro správu manuálů
Přispěvatel: Exe 21. 03. 2018, 11:21:44

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.

Název: Re:SW pro správu manuálů
Přispěvatel: VojtaF 21. 03. 2018, 12:41:31

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]

<!-- @@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

Název: Re:SW pro správu manuálů
Přispěvatel: Exe 21. 03. 2018, 13:12:34

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

Název: Re:SW pro správu manuálů
Přispěvatel: blb 21. 03. 2018, 13:22:53

Co hugo, jekyll?

Název: Re:SW pro správu manuálů
Přispěvatel: PavelŽ 21. 03. 2018, 14:15:08

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.

Název: Re:SW pro správu manuálů
Přispěvatel: Tester 21. 03. 2018, 15:52:05

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.

Název: Re:SW pro správu manuálů
Přispěvatel: VojtaF 21. 03. 2018, 17:33:24

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

Název: Re:SW pro správu manuálů
Přispěvatel: TomBA 21. 03. 2018, 19:46:55

Tiež mi to smeruje ku DocBook

Název: Re:SW pro správu manuálů
Přispěvatel: . 22. 03. 2018, 00:01:17

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.

Název: Re:SW pro správu manuálů
Přispěvatel: Sten 22. 03. 2018, 01:19:16

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

Název: Re:SW pro správu manuálů
Přispěvatel: PavelŽ 22. 03. 2018, 08:07:04

Citace: .  22. 03. 2018, 00:01:17

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.