PLDB
Languages Features Calendar CSV Lists Blog About Sponsor Add Language
GitHub icon

reStructuredText

reStructuredText

reStructuredText is a text markup created in 2002.

#259on PLDB 20Years Old 1.0kUsers
0Books 0Papers 31Repos

Try now: Riju

reStructuredText (sometimes abbreviated as RST, ReST, or reST) is a file format for textual data used primarily in the Python programming language community for technical documentation. It is part of the Docutils project of the Python Doc-SIG (Documentation Special Interest Group), aimed at creating a set of tools for Python similar to Javadoc for Java or POD for Perl. Docutils can extract comments and information from Python programs, and format them into various forms of program documentation. Read more on Wikipedia...


Example from Riju:
Hello, world!
Example from hello-world:
============ Hello World ============
Example from Linguist:
Contributing to SciPy ===================== This document aims to give an overview of how to contribute to SciPy. It tries to answer commonly asked questions, and provide some insight into how the community process works in practice. Readers who are familiar with the SciPy community and are experienced Python coders may want to jump straight to the `git workflow`_ documentation. Contributing new code --------------------- If you have been working with the scientific Python toolstack for a while, you probably have some code lying around of which you think "this could be useful for others too". Perhaps it's a good idea then to contribute it to SciPy or another open source project. The first question to ask is then, where does this code belong? That question is hard to answer here, so we start with a more specific one: *what code is suitable for putting into SciPy?* Almost all of the new code added to scipy has in common that it's potentially useful in multiple scientific domains and it fits in the scope of existing scipy submodules. In principle new submodules can be added too, but this is far less common. For code that is specific to a single application, there may be an existing project that can use the code. Some scikits (`scikit-learn`_, `scikits-image`_, `statsmodels`_, etc.) are good examples here; they have a narrower focus and because of that more domain-specific code than SciPy. Now if you have code that you would like to see included in SciPy, how do you go about it? After checking that your code can be distributed in SciPy under a compatible license (see FAQ for details), the first step is to discuss on the scipy-dev mailing list. All new features, as well as changes to existing code, are discussed and decided on there. You can, and probably should, already start this discussion before your code is finished. Assuming the outcome of the discussion on the mailing list is positive and you have a function or piece of code that does what you nee
Example from Wikipedia:
:: some literal text This may also be used inline at the end of a paragraph, like so:: some more literal text .. code:: python print("A literal block directive explicitly marked as python code")

Language features

Feature Supported Example Token
Semantic Indentation
api-blueprint.html · restructuredtext.html · bourne-shell.html

View source

PLDB - Build the next great programming language · v2022 · Day 32 · Docs · Build · Acknowledgements · Traffic Today · Traffic Trends · Mirrors · GitHub · feedback@pldb.com