Zdravim, chystam se vytvorit tutorial na pouzivani daneho softwaru. Tutorial bude obsahovat
- volny text
- formatovany text (ukazky zdrojovych kodu, prikazy - se zvyraznenim syntaxe, cislovani radek)
- obrazky
- videa
Zakladni pozadavky:
Bonus:
- moznost internaciolanizace, tj. prekladu textu, s tim, ze se vysledny tutorial vygeneruje na zaklade sablony
Uvazoval jsem o Sphinx [1] (bez internacionalizace, tutorial by se musel do dalsiho jazyka prelozit jako celek), samorejme Docbook. Mate nekdo nejaky dalsi tip, vlastni zkusenosti? Predem diky za kazdou radu...
ML
Cielovy format je HTML? Alebo chcete aj PDF podporu?
markdown z pandoc
ja mam rad old school txt pripadne html tutorialy viz nasledujici:
v tomhle jsem kdysi sedel neustale: http://www.ucw.cz/~hubicka/skolicky/
ascii art+tutorial to miluju neustale, to mi umozni zapomenout na dnesni silenou dobu milionu frameworku a vzpomenout na dobry jednoduchy linux :-)
http://www.ucw.cz/~hubicka/skolicky/UNIX.Hrdonka.txt
http://www.ludd.luth.se/~vk/pics/ascii/junkyard/techstuff/tutorials/Joan_Stark.html
Kedysi som vyrábal tutoriály v nacustomizovanom PmWiki markupe, potom niektoré v DocBooxu (v XmlMind XM Editore), ale teraz prakticky všetko píšem v Extended MarkDowne. Jednoducho preto, že nemusím sa zdržovať s tagovaním a podobnými vecami a len práskam text v editore.
Je to niečo podobné, ako písal ertwertwert, akurát môj výstup ide do WordPressu, ktorý to sformátuje, osyntaxhighlightuje a urobí z toho civilizovaný text.
Obrázky sú trochu opruz (v porovnaní s DocBookom), ale na lepšie riešenie som neprišiel.