Sphinx
Comandos principales
>>> sphinx-quickstart >>> make html
Sintáxis
Niveles de titulos:
***** (capítulo) ##### (sección) ===== (titulo) ----- (subtitulo) ^^^^^ (subsubtitulo)
Atributos de fuente:
*cursiva* **negrita** ``codigo``
Listas:
* item de lista.
* mas items.
* Elemento interno de la lista.
1. item de lista enumerado.
2. segundo elemento.
#. tercer item de la lista.
Definiciones:
Elemento
Descripción detallada.
Ejemplos:
deben comenzar con dos puntos seguidos, y lo siguiente debe estar identado, por ejemplo:
Veamos un ejemplo:
import pygame
Listas de campos:
:Author: Gcoop :Versión: 0.1 :Fecha edición: 10 de Junio del 2009
Enlaces:
SugarCRM
Enlaces internos:
nombre del titulo :mod:`os` :ref:`lista`
Destino de vinculo interno:
.. _lista:
Lista de opciones para programas comando:
-a muestra todos los archivos, incluso ocultos. -l usa un formato de lista extenso.
Bloques literales:
Utilice ``::`` y luego una identación para incluir texto en crudo.
Bloques en linea:
| Se resperarán | los saltos de linea.
Referencias:
Este es un texto con nota al pie [1] y puede citarse en cualquier parte.
| [1] | las notas al pie se muestran el final. |
Vínculos:
Puede citar proyectos como GNOME y luego indicar sus web.
Notas al pie:
Cite el proyecto [GNU] y la cita luego al pie.
| [GNU] | y una descripción. |
Referencias internas:
Tiene que indicar el termino y mas adelante, en otro párrafo indicar el destino para llegar.
Este es el parrafo destino del vinculo.
Directivas especiales de Sphinx:
![]()
Note
message.
Warning
message.
Descripción de la clase, sus responsabilidades y tareas.
Comentarios
