wiki / docbook / modello di sistema di documentazione in lattice

StackOverflow https://stackoverflow.com/questions/1998677

Domanda

Sono alla ricerca di un modello di sistema di documentazione o, meglio sarà la creazione di uno. Esso dovrebbe sostenere le seguenti caratteristiche:

  • Crea output in PDF e HTML
  • Il supporto per (lattice) formule grandi e complicate
  • I riferimenti tra documenti
  • Bibliografie
  • Modelli sarà riempito da uno script Python

Ho provato LaTeX con vari convertitori TeX-to-HTML ma non sono soddisfatto dei risultati. Sto usando DocBook per un po ', ma penso che la modifica DocBook non è facile da scrivere e il supporto per le formule non è ancora sufficiente.

Il problema principale è, che ci saranno gli utenti di questo sistema che non conoscono la sintassi LaTeX o DocBook. Ho pensato a un'alternativa per questi utenti che forniscono una possibilità di modifica con la sintassi Wiki (convertito da Python a LaTeX).

Ricapitoliamo: Voglio HTML e PDF da almeno LaTeX e di Wiki. DocBook potrebbe essere usato come formato intermedio.

Qualcuno ha avuto un problema simile o mi può dare un consiglio su quali strumenti e quali formati di file devo usare?

È stato utile?

Soluzione

Usiamo sfinge: http://sphinx.pocoo.org

Si fa quasi tutto di questo.

Lo script Python o gli utenti o chiunque (non riesco a seguire la questione) possono creare contenuto utilizzando RST markup (che è forse il più facile dei linguaggi di markup). Si esegue attraverso Sfinge e si ottiene HTML e lattice.

Altri suggerimenti

Ho creato un modulo di LaTeX pre-processore e python che permette di incorporare Python o SQL all'interno di un file LaTeX. Il pitone e / o SQL viene eseguita e l'uscita è piegato.

Con latex2html o latex2rtf è possibile utilizzare il codice LaTeX per produrre HTM e RTF.

ho postato per voi ad http://simson.net/pylatex/

Arbortext supporta nativamente LaTeX. È possibile inviare il motore di pubblicazione o di stampa compositore LaTeX e che passerà attraverso direttamente.

Inoltre, supporta un sacco di altre lingue composizione come bene e dà anche l'opportunità di fare la manipolazione di impaginazione come si vedrebbe in InDesign (senza il mal di testa e sovraccarico di ID).

Credo che AsciiDoc è meglio mirata a ciò che si sta cercando di ottenere. E 'un semplice linguaggio di markup, permette formule di lattice in esso e genera documenti DocBook da cui è possibile generare ulteriormente il codice HTML leggibili o la rappresentazione in lattice

Autorizzato sotto: CC-BY-SA insieme a attribuzione
Non affiliato a StackOverflow
scroll top