Cách chuyển đổi reStructuredText thành văn bản thuần túy

Question

Tôi định sử dụng reStructuredText để viết tài liệu với mục đích chính là tạo một số trang HTML đẹp. Đối với điều này tôi sử dụng công cụ docutils rst2html.py.

Tuy nhiên, tôi cũng có thể cần trình bày tài liệu ở định dạng văn bản thuần túy đẹp, không có đánh dấu lại cấu trúc lại và đoạn văn bản và định dạng đẹp tương tự vẫn được thực hiện trên đầu ra văn bản. Tuy nhiên, không có công cụ rst2txt.py trong docutils.

Có cách nào để chuyển đổi reStructuredText thành định dạng văn bản thuần túy đẹp, có thể sử dụng các tùy chọn đặc biệt cho docutils không?

Answer 1

Nhân sư có TextBuilder cho định dạng đầu ra txt. Chỉ cần thử nó và nó dường như làm những gì bạn đang tìm kiếm.

Tuy nhiên, có thể hơi lỗi thời vì nó không nằm trong Makefile mặc định. Nhưng nó hoạt động tốt trên tài liệu khá phức tạp của tôi (150 trang pdf). Để sử dụng nó, chỉ cần thêm mục tiêu sau vào nó:

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

Ngoài ra, hãy nhớ rằng Sphinx chỉ thực hiện một tập con của thông số đầu tiên.

Answer 2

Tôi cũng đã thấy điều này được thực hiện bằng cách làm cho html sử dụng rst2html, sau đó chuyển đổi html để văn bản đơn giản bằng cách sử dụng một trình duyệt html dòng lệnh, chẳng hạn như:

• lynx http://lynx.browser.org
• liên kết http://links.sourceforge.net
• w3m http://w3m.sourceforge.net
• elinks http://elinks.or.cz

Mỗi trình duyệt có một chuyển đổi dòng lệnh hoặc tương tự để làm cho sản lượng của nó vào một tập tin .txt, vì vậy bạn có thể tạo ra một kịch bản hai dòng gọi là 'rst2txt', một cái gì đó như:

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

Answer 3

Các NoTex.ch văn bản trực tuyến trình soạn thảo (với hỗ trợ cho rST) bao gồm hỗ trợ chuyển đổi văn bản thuần túy (dựa trên Sphinx 'TextBuilder).