wiki / DocBook / documentation latex système de template

Question

Je cherche un système de modèle de documentation ou plutôt allez créer un. Il devrait soutenir les caractéristiques suivantes:

• Créer sortie en PDF et HTML
• Support pour les formules (grandes) et LATEX compliquées
• Références entre documents
• Bibliographies
• Modèles sera rempli par un script Python

Je l'ai essayé avec différents convertisseurs LATEX TeX-à-HTML, mais je ne suis pas satisfait des résultats. Je l'ai utilisé DocBook pendant un certain temps, mais je pense que l'édition DocBook est pas facile à écrire et le support pour les formules ne sont pas encore suffisantes.

Le principal problème est, qu'il y aura des utilisateurs de ce système qui ne connaissent pas la syntaxe LaTeX ou DocBook. J'ai pensé à une alternative pour ces utilisateurs offrant une possibilité d'édition avec la syntaxe Wiki (converti en Python à LaTeX).

Récapitulons: Je veux HTML et la sortie PDF à partir d'au moins LaTeX et entrée Wiki. DocBook pourrait être utilisé comme format intermédiaire.

Quelqu'un at-il eu un problème similaire ou peut me donner un avis sur les outils et les formats de fichiers que je devrais utiliser?

Answer 1

Nous utilisons sphynx: http://sphinx.pocoo.org

Il fait presque tout cela.

Votre script python ou vos utilisateurs ou qui que ce soit (je ne peux pas suivre la question) peuvent créer du contenu en utilisant RST balisage (ce qui est peut-être le plus facile des langages de balisage). Vous exécutez par Sphinx et vous obtenez HTML et latex.

Answer 2

J'ai créé un pré-processeur LATEX et un module python qui vous permet d'intégrer python ou SQL dans un fichier LaTeX. Le python et / ou SQL est exécutée et la sortie est pliée.

Avec latex2html ou latex2rtf vous pouvez utiliser le code LaTeX pour produire HTM et RTF.

Je l'ai posté pour vous à http://simson.net/pylatex/

Answer 3

Arbortext soutient LATEX nativement. Vous pouvez envoyer le moteur d'édition ou imprimer compositeur LaTeX et il va passer directement en sortie.

Il soutient également beaucoup d'autres langues de composition aussi bien et donne même la possibilité de faire la manipulation de mise en page comme vous verriez dans InDesign (sans les maux de tête et les frais généraux d'identité).

Answer 4

Je pense que Asciidoc est mieux cibler ce que vous essayez d'obtenir. Il est un langage de balisage simple, il permet des formules de latex en elle et elle génère des documents DocBook à partir de laquelle vous pouvez encore générer le code HTML lisible ou une représentation en latex