ReStructuredText

reStructuredText (RST, ReST, or reST) é um formato de arquivo para dados textuais usado principalmente na comunidade da linguagem de programação Python para documentação técnica.

Faz parte do projeto Docutils do Python Doc-SIG (Documentation Special Interest Group), que visa a criação de um conjunto de ferramentas para Python semelhante ao Javadoc para Java ou Plain Old Documentation (POD) para Perl. Docutils pode extrair comentários e informações de programas Python e formatá-los em várias formas de documentação de programa.[1]

Deste modo, reStructuredText é uma linguagem de marcação leve projetada para ser (a) processável por software de processamento de documentação, como Docutils, e (b) facilmente legível por programadores humanos que estão lendo e escrevendo código-fonte em Python.

Exemplos de marcações

[editar | editar código-fonte]

Cabeçalhos:

Cabeçalho da seção


Sub-cabeçalho da seção

----------------------

Listas:

- Primeiro item

- Segundo item

- Um sub item

- Terceiro item

1) Lista numerada

2) Segundo item

a) Sub item

i) Sub-sub item

3) Terceiro item

Ligações para nomes:

Uma sentença com links para o Google_ e para 'Arquivos do Linux'_.

.. _Google: http://www.google.com/ .. _Arquivos do Linux: http://www.kernel.org/

Outras ligações:

Outra sentença com 'links anônimos para o site do Python'__.

__ http://www.python.org/

Referências

  1. Mertz, David (1 de fevereiro de 2003). «XML Matters: reStructuredText» (em inglês). IBM developerWorks. Consultado em 5 de outubro de 2016 

Ligações externas

[editar | editar código-fonte]