Dotaz: tvorba tutorialu

[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 (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

Odpovědi

[Josef Kufner]

Sphinx je hezká věc. S překlady by nemusel být problém, k textu si můžeš uložit, v jakém je jazyce, a pak podle toho upravovat váhu výsledku.

Otázkou ale je, jak si představuješ použití takového tutoriálu a jaké technologie máš k dispozici. Ono se celkem hodí mít příklady interaktivní, nejlépe rovnou dema. Něco zas nemůže fungovat offline (sphinx), k něčemu potřebuješ mít nainstalovanou aplikaci, videa zas potřebují přehrávač,...

Nedávno jsem taky řešil jak napsat tutoriál, napsal jsem to jak obyčejný kus HTML a moc spokojený jsem s tím nebyl.