Jak przekonwertować tekst reStructuredText na zwykły tekst

Question

Mam zamiar użyć reStructuredText do napisania dokumentacji z głównym celem generowania ładnych stron HTML. Do tego używam narzędzia docutils rst2html.py.

Jednak może również zajść potrzeba przedstawienia dokumentacji w ładnym formacie zwykłego tekstu, czyli bez znacznika reStructuredText, oraz w przypadku, gdy w tekście jest nadal wykonywane zawijanie akapitów i podobne ładne formatowanie. Ale nie ma żadnego narzędzia rst2txt.py w docutils.

Czy istnieje sposób przekonwertowania pliku reStructuredText na ładny format zwykłego tekstu, być może przy użyciu specjalnych opcji do dokumentów?

Answer 1

Sphinx ma TextBuilder dla formatu wyjściowego txt. Po prostu wypróbowałem i wydaje się, że robię to, czego szukasz.

Może to być jednak trochę nieaktualne, ponieważ nie znajduje się w domyślnym pliku Makefile. Ale działało dobrze na mojej dość złożonej dokumentacji (150 stron pdf). Aby z niego skorzystać, wystarczy dodać do niego następujący cel:

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

Ponadto, należy pamiętać, że Sfinks implementuje tylko podzbiór specyfikacji RST.

Answer 2

widziałem też to zrobić przez renderowania HTML za pomocą rst2html, następnie konwersja html do zwykłego tekstu przy użyciu przeglądarki HTML wiersza polecenia, takie jak:

• rysia http://lynx.browser.org
• linki http://links.sourceforge.net
• w3m http://w3m.sourceforge.net
• elinks http://elinks.or.cz

Każda z tych przeglądarek posiada przełącznik wiersza polecenia lub podobnego do renderowania jego wyjście do pliku txt, więc można utworzyć skrypt dwóch linii o nazwie „rst2txt”, coś jak:

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

Answer 3

The NoTex.ch tekstu internetowego edytor (z obsługą rST) obejmuje obsługę konwersji tekstowej (która jest oparta na TextBuilder Sphinx).