Come convertire reStructuredText in testo semplice

Question

Ho intenzione di usare reStructuredText per scrivere la documentazione con lo scopo principale di generare delle belle pagine HTML. Per questo uso lo strumento docutils rst2html.py.

Tuttavia, potrebbe anche essere necessario presentare la documentazione in un formato di testo semplice, ovvero senza il markup reStructuredText, e in cui l'avvolgimento del paragrafo e una formattazione simile sono ancora eseguiti sull'output del testo. Ma non esiste uno strumento rst2txt.py nei docutils.

C'è un modo per convertire reStructuredText in un formato di testo semplice, magari con l'uso di opzioni speciali per docutils?

Answer 1

Sfinge ha un TextBuilder per il formato di output txt. Ho appena provato e sembra fare ciò che stai cercando.

Tuttavia, potrebbe essere un po 'obsoleto perché non è nel Makefile predefinito. Ma ha funzionato bene sulla mia documentazione abbastanza complessa (150 pagine pdf). Per usarlo, basta aggiungere il seguente obiettivo ad esso:

text: 
    $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text 
    @echo 
    @echo "Build finished." 

Inoltre, tenete a mente che Sfinge implementa solo un sottoinsieme delle prime specifiche.

Answer 2

Ho visto anche questo fatto rendendo in html utilizzando rst2html, quindi convertire il codice HTML in testo semplice utilizzando un browser html della riga di comando, come ad esempio:

• lince http://lynx.browser.org
• link http://links.sourceforge.net
• w3m http://w3m.sourceforge.net
• elinks http://elinks.or.cz

Ognuno di questi browser dispone di un interruttore della riga di comando o simili per rendere il suo output in un file .txt, così si potrebbe creare uno script due linea chiamata 'rst2txt', qualcosa di simile:

rst2html docs.rst docs.html 
lynx -dump docs.html > docs.txt 

Answer 3

Il testo in linea NoTex.ch editor (con supporto per rST) include il supporto per la conversione di testo normale (che si basa su Sphinx 'TextBuilder).