Linguaggio di markup leggero (wiki) per la documentazione

Question

Quando scrivo documenti o documentazione, penso che usare LaTeX o OpenOffice sia eccessivo poiché di solito ho solo bisogno di alcuni elementi di markup (grassetto, titoli, elenchi, ...). Vorrei scrivere i miei documenti usando un markup in stile wiki in quanto è molto efficiente.

Ad esempio:

= Introduction =
'''HTML''' is a markup language...

Alla fine vorrei semplicemente convertirlo in PDF. (Anche multipiattaforma è stato bello.)

compiler.exe -pdf input.wiki output.pdf

Esiste uno strumento (o una semplice catena di strumenti) per fare questo lavoro?

Personalmente vorrei non utilizzare LaTeX come passaggio di trasformazione. Ci sono strumenti che fanno questo lavoro trasformando la sintassi leggera in TeX e poi in PDF / PS.

Answer 1

Potresti scoprire che MarkDown si avvicina molto a ciò che desideri.

MarkDown è una tecnica semplice per contrassegnare i file di testo in modo che possano essere post-elaborati in altri moduli. Una delle cose belle di MarkDown è il loro obiettivo che un documento sottoposto a markup dovrebbe essere semplicemente leggibile come un file di testo semplice:

  

L'obiettivo di progettazione prioritario per   La sintassi di formattazione di Markdown & # 8217;   renderlo il più leggibile possibile. Il   l'idea è che un Markdown formattato   il documento deve essere pubblicabile così com'è,   come testo semplice, senza apparire   & # 8217; s è stato contrassegnato con tag o   istruzioni di formattazione.

PanDoc sembra che potrebbe essere un buon strumento per la conversione di MarkDown direttamente in file PDF. Potrebbero esserci altre opzioni: PanDoc è solo lo strumento migliore che ho trovato con una rapida ricerca su Google.

Answer 2

reStructuredText .

Puoi utilizzare Sphinx per generare HTML e LaTeX (e successivamente PDF con pdflatex).

C'è anche rst2pdf , non so se è maturo.

Answer 3

È possibile utilizzare Markdown ( esempio ) e quindi utilizzare Pandoc (che anche funziona con reStructuredText e diverse altre sintassi simili a wiki) per la conversione in PDF.