reStructuredText is a lightweight markup language intended to be highly readable in source format.
Questions tagged [restructuredtext]
1265 questions
0
votes
1 answer
emphasis and not emphasis in the same word
In ReStructuredText, is it possible to have emphasis and no emphasis in the same word? For example:
*emph*not-emph
leading to "emph no-emph", but with no white space in between? I can't find a way to do it, not even with a substitution.
gozzilli
- 8,089
- 11
- 56
- 87
0
votes
1 answer
xhtml/rst to excel conversion
I am working on a reporting tool and need to generate reports in various formats including pdf, html and excel(.xls or any format which can be easily opened in excel)
I am thinking of generating basic report in xhtml or restructuredtext(rst) and…
Anurag Uniyal
- 85,954
- 40
- 175
- 219
0
votes
1 answer
clearfix paragraph in restructured text
I've got a reStructuredText document for which I have a set of images and paragraphs that explain them. I want the images to be left justified and the text to flow around them. If I were doing this in html, I'd just insert
dino
- 3,093
- 4
- 31
- 50
0
votes
1 answer
Numbered list of images and code using reStructeredText
In reStructuredText, how can one achieve a numbered list of elements with non trivial entries?
Example:
1. foo
2. bar
*code block*
3. waldo
*image*
Jarek Rozanski
- 780
- 1
- 6
- 13
0
votes
1 answer
batch rst2html conversion in a bash script
maybe a simple question for bash coders, but I'm not able to figure out this issue.
I have multiple .rst files in multiple folders and sub-folders.
How can I create a script that converts all the .rst files in html (with the rst2html command) and…
matteo
- 4,683
- 9
- 41
- 77
0
votes
0 answers
Plain text markup with programable extentions point?
I look for plain text markup what allow extension of syntax through standard way and ability to include/program own writers (or register routines to writer extension points) in order to get final document in different form with handling additional…
gavenkoa
- 45,285
- 19
- 251
- 303
0
votes
1 answer
ReST custom directive's output causes built in writer to traceback
I've written a custom ReST directive that takes input like this:
.. foo::
abcdef
ghijkl
mnopqr
a = apple; apple.png
b = banana; banana.png
(etc.)
And outputs a table. The table is shaped like the block of letters above,…
Thanatos
- 42,585
- 14
- 91
- 146
0
votes
2 answers
External documentation for PHP, no DocBook
I need a documentation system for a PHP project and I wanted it to be able to integrate external documentation (use cases, project scope etc.) with the documentation generated from code comments. It seems that phpDocumentor has exactly the right…
Leonth
- 711
- 1
- 9
- 19
0
votes
1 answer
How to check reST wellformedness with Sphinx?
When uploading README in reStructuredText to PyPI they should be valid reST documents. We already have Sphinx as a requirement to build docs. Is it also possible to check one file with Sphinx?
anatoly techtonik
- 19,847
- 9
- 124
- 140
0
votes
5 answers
Using sphinx for very basic structure
This is my file hierarchy:
InfoRescue
|
|_ src
|
|_ _ _ includes
|
|_ _ _ _ _ i1.py
|_ _ _ _ _ i2.py
|_ _ _ _ _ init.py
|
|_ _ _ utils
|
|_ _ _ _ _ u1.py
|_ _ _ _ _ u2.py
|_ _ _ _ _ init.py
|
|_ _ _ doc
|
|_ _ _ _ _ index.rst
|_ _ _ _ _…
Abhishek Gupta
- 6,465
- 10
- 50
- 82
0
votes
1 answer
How to download all repo's markdown pages on GitHub and convert them to reStructuredText?
My repository has a lot of wiki pages written Markdown.
I want to convert them all to reStructuredText so they can be compiled into a separate Sphinx documentation project.
caduceus
- 1,542
- 2
- 16
- 21
0
votes
1 answer
Reading Django documentation with restview
I am using Fedora 18 on Virtual Box on my Windows XP desktop to learn Django. After going through the .txt documentation files, I discovered these files were written using restructuredText. I've been spending the last day or so trying to figure out…
Dave
- 503
- 1
- 8
- 21
0
votes
1 answer
Using jinja inside sphinx raw html
So I have a sphinx-generated website. Parts of it are in raw html, parsed by sphinx + jinja.
Now I want to use links to certain parts of the toc-tree inside the raw html.
Is there a way to achieve this?
Currently I'm exiting the raw html and use…
Andreas Mueller
- 27,470
- 8
- 62
- 74
0
votes
1 answer
Non breaking spaces in RstDocument in Kivy
Is there any chance to perform non breaking spaces in RstDocument?
I need move one letter words to next line if this word is on the end of line.
I tried define Substitution:
.. |nbsp| unicode:: 0xA0
:trim:
and then use it in text:
some text some…
Lukasz Koziara
- 4,274
- 5
- 32
- 43
0
votes
1 answer
Sphinx restructuredText to HTML hyperlink conversion
I have a collection of reStructuredText files which link to each other in the following manner:
further reading at `document name `.
I have noticed that this works really well on BitBucket and Github, as .rst files are rendered quite…
dmeu
- 3,842
- 5
- 27
- 43