reStructuredText is a lightweight markup language intended to be highly readable in source format.
Questions tagged [restructuredtext]
1265 questions
-1
votes
1 answer
My `pdf` generated through RTD is having all articles of content in the heading content Why?
I have just recently (yesterday) started using sphinx and read the docs for my project.
Till now I am happy with the Html documentation but the pdf version includes all the articles That appear in the index within the Contents heading. And the…
Aditya ultra
- 942
- 1
- 8
- 15
-1
votes
1 answer
Why Eclipse Pydev uses @author in default template
I have been intrested for python documenting for a while but I can't figured out why @author is default sytnax in python templates. Why it isn't :author: (in restructuredtext style)?
From what reason is used syntax with @ and not with :
I though…
Karlvonbahnhof
- 94
- 10
-2
votes
1 answer
Including a literal block inside an admonition
I'm an RST newbie. I want to create a Warning block that includes a line of code.
Here are four attempts:
.. WARNING:: Base case - This doesn't format the next line as a literal::
$ ls /
.. WARNING:: Split over two lines - This still doesn't…
Oddthinking
- 24,359
- 19
- 83
- 121
-2
votes
1 answer
Is there a lightweight markup language that supports numbered headings?
Languages like Creole, reStructuredText, Markdown, and others allow headings
= Food
== Fruit
=== Apples
and numbered lists
# Food
# Food 2
but I want something that can give me headings I can refer to by number.
Like this type of output:
1.…
Richard
- 14,798
- 21
- 70
- 103
-3
votes
2 answers
Bootstrap theme ugly looking font for inline literal
I am developing a documentation using Sphinx and reStructured text markup. The theme that I would like to use is Bootstrap.
I have a lot of inline literals in my documentation and the resulting html font looks ugly because the inline literals are…
hypersonics
- 1,064
- 2
- 10
- 23