ReStructuredText
reStructuredText | ||
---|---|---|
![]() | ||
Desarrollador | ||
David Goodger | ||
https://docutils.sourceforge.io/rst.html | ||
Información general | ||
Extensión de archivo | rst | |
Tipo de MIME | text/x-rst | |
Última versión | Revision 7629 11 de marzo de 2013 | |
Tipo de formato | documentación técnica | |
Formato abierto | ? | |
[editar datos en Wikidata] |
El proyecto 'ReStructured Text es un lenguaje de marcas ligero creado para escribir textos con formato definido de manera cómoda y rápida. Es parte del proyecto Docutils dentro de la comunidad de Python, y es formalizado por el grupo Python Doc-SIG (Documentation Special Interest Group). Tiene la principal ventaja de que ese texto puede usarse para generar documentos equivalentes en HTML, LaTeX, docbook, etc. Es una evolución de Structured Text.
A menudo, el término Restructured Text es abreviada a ReST o reST, causando confusión con el término REST (Representational State Transfer), un tipo de interfaz a través de protocolo HTTP que no tiene relación con el formato que nos ocupa en este artículo.
Ejemplos de sintaxis
Lo que sigue no es un listado exhaustivo de la sintaxis de reST. Véase una referencia más completa de la referencia rápida de rst para obtener más información.
Encabezamientos:
Encabezamiento de sección ========================= Encabezamiento de subsección -----------------------------
Listas:
- Un elemento en una lista no ordenada - Otro elemento en una lista - Un sub-elemento - Tercer elemento
1) Un elemento de una lista numerada 2) Segundo elemento a) Sub-elemento i) Sub-sub-elemento 3) Tercer elemento
# Otro elemento de una lista enumerada # Segundo elemento
Enlaces nombrados:
Una oración que enlaza a Wikipedia_ y al `Linux kernel archive`_. .. _Wikipedia: http://www.wikipedia.org/ .. _Linux kernel archive: http://www.kernel.org/
Enlaces anónimos:
Otra oración con un `enlace anónimo al sitio de Python`__. __ http://www.python.org/
Enlaces embebidos:
`Python <http://www.python.org/>`_ (enlace roto disponible en Internet Archive; véase el historial, la primera versión y la última)..
Nótese que los enlaces encierran textos con el acento grave (`), y no apóstrofo ('). Si su teclado no tiene la tecla de acento grave; en Microsoft Windows puede digitar el número en el teclado numérico con la combinación Alt+96, en GNU/Linux Ubuntu utilice MAYÚS+CTRL+U y a continuación pulse 6,0 y ESPACIO.
Imágenes:
.. image:: images/ball1.gif
Enlaces externos
- Proyecto docutils
Datos: Q287315