wiki / docbook / modello di sistema di documentazione in lattice
-
22-09-2019 - |
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?
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