V čem vytvářet tutoriál?

[Martin Landa]

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:

• fulltext
• obsah

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

[Reklama]

[alef0]

Cielovy format je HTML? Alebo chcete aj PDF podporu?

[dumblob]

markdown z pandoc

[ertwertwert]

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

[Róbert Novotný]

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.

[Reklama]