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 | ? | |
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
[editar]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
[editar]Text is available under the CC BY-SA 4.0 license; additional terms may apply.
Images, videos and audio are available under their respective licenses.