Super User Stack Exchange
Super User Stack Exchange

Questions tagged [restructuredtext]

reStructuredText is a lightweight markup language intended to be highly readable in source format.

6 questions
5
votes
1 answer

Can Emacs be set up to display Python code in Python mode and display docstrings in ReST mode?

I often edit Python code in my Emacs and have it set up to display Python files in Python mode. I often find myself formatting dosctrings as ReStructured Text and I was thinking that it would be great if I could have Emacs show these docstrings as…
Thomas Arildsen
  • 929
  • 2
  • 9
  • 17
4
votes
2 answers

Spell checking reStructuredText

I'm writing and correcting API documentation in Sphinx using reStructuredText. Does anyone know of a good spellchecker that will handle this format, or a bunch of Unix/Linux tools that will allow me to use Aspell with it?
Fred Foo
  • 985
  • 5
  • 12
3
votes
2 answers

How to reformat reStructuredText?

I'm writing reST in vim, which handles line breaks for me (after 80 chars). However, since I frequently go back and edit the text before, lines get ugly again. For example, in tables, it's sometimes annoying to re-format a complete table just…
wal-o-mat
  • 201
  • 2
  • 5
3
votes
2 answers

wiki for sphinx+ReStructuredText server

I've been using Sphinx as a document engine for an internal document server in my company. It uses reStructuredText as its markup language. Today, I need to edit the source files manually, compile the HTML, check that it works and then upload it to…
Adam Matan
  • 8,090
  • 17
  • 59
  • 84
1
vote
2 answers

Text editors; Unicode; the zero-width non-joiner character

I need to edit text files that contain unicode characters (in ReStructuredText for input to Sphinx). I'm pretty confident that most text editors will store and display most Unicode characters correctly, but one, the zero-width space (U+200B), is a…
Jonathan Sachs
  • 161
  • 1
  • 3
0
votes
1 answer

.rst (reStructuredText) files not rendered in the browser

I was told by some people to write my documentation files in .rst since this format was apparently already rendered by default in browsers like Firefox. Now, I open one such file on Firefox under Windows, but it turns out nothing is rendered, just…
Cyril Duchon-Doris
  • 512
  • 8
  • 26