3

I want to use ReadTheDocs, which uses Sphinx, which, in turn, uses restructuredtext.

The reST editors I've found so far are like the 80s word processors where you edited the text to put tags (e.g. "bold on", "bold off", etc.) at the desired spot in the text, then you could see the final result in a different frame. What I am looking for is a post-90s wysiwyg editor, like Word, where you make the screen look the way you want it, and the marked-up text is generated as you work.

For some of you working in the text is most comfortable for you. I'm not looking to take that from you, just make reST editing as comfortable for me as it is for you.

  • For which operating system? – unor Jun 29 '16 at 5:21
  • Welcome to Software Recommendations! What features are needed (e.g. image support)? Shall the generated text just be stored locally, or must it integrate with something else (e.g. a web service)? Any price limit? Please take a look at What is required for a question to contain "enough information"? Then edit your question and fill the gaps. That will increase your chances for good and matching answers dramatically ;) – Izzy Jun 29 '16 at 6:15
  • OSs I use are Windows and Android, but an online version would work too provided I can download the resulting text. As I said in the original post, I intend to use the text for documentation with Sphinx and ReadTheDocs, so it must be transferable to my PC. Obviously, the most efficient would be a Windows version sorting the resulting text locally. Image support is desirable. – Den Jun 30 '16 at 3:11
  • Oh, regarding price: the lower the price, the better. Free is best. – Den Jun 30 '16 at 3:19
  • I don't believe there is such a thing. Mainly because the "market" is too small. It's much easier to build a two-pane editor with the reST source on one side and the rendered preview on the other side, and most programmers and writers seem happy enough with this, so there's not much reason to build the kind of editor you want. I think your best bet is to just use Word and then apply a standalone document converter at the end, like Pandoc. – John Y Jan 14 '18 at 20:15
2

It's been over two years since I asked this question, but I've now found something like I've wanted. It's called Typora. It is a WYSIWYG editor for markdown(not reST, at least yet).

  • It's not very helpful to recommend a restructured text editor that doesn't support restructured text. – Timmmm Apr 25 at 13:18
1

(You have not yet described what platform you want this to run on. I will assume you want a Web app.)

The ‘rsted’ project implements a WYSIWYG text editor that produces reStructuredText.

It is implemented in the Flask web framework (Python, JavaScript). The source code is free software to all recipients.

A demonstration site at http://rst.ninjs.org/ lets you try it.

  • 1
    Unfortunately the ‘rsted’ project is not a WYSIWYG editor. It is a simple text editor that proposes buttons to automatically add tagged structure for rst, and displays result on right side. It's not so bad, and even the best I could find, but far from WYSIWYG editor. – Pascal BERNARD Apr 27 '18 at 7:03
0

I found this script works very well for me. Live preview, works for any environment, but need to follow its steps to setup.

https://github.com/tonyriverms/sphinx_live_preview

0

rstpad seems to work well, although it has not been updated for a couple of years.

It's available for Windows and Mac (and probably Linux if you compile it yourself).

0

On macOS, I got Marked 2 working. I had Sphinx installed on my MacBook already. In Marked I changed the 'processor' to be _pathto_/rst2html.py. It works great so far! Edit in your favorite text editor with live preview in Marked.

  • I wrote a shell script for Marked 2. if this is your processor then it will either render RST files with rst2html.py or fallback to the default Marked settings. This allows Marked to render both RST and MD files without changing your processor preference. – Travler May 26 at 0:34
  • #!/bin/bash RST2HTML="__pathto__/rst2html.py" if [ $MARKED_EXT = "rst" ]; then $RST2HTML /dev/stdin else echo "NOCUSTOM" fi – Travler May 26 at 0:39
0

Another solution that was recommended to me is Visual Studio Code with a reStructuredText extension by LeXtudio. It has side-by-by preview and seems to be working well so far.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.