Agregar salto de línea a la definición de definition lists

Esto se hace a través de una extensión de Sphinx porque no se encontró
forma de hacerlo via estilos de LaTeX. Lo que hace la extensión es agregar
un nodo "raw" con format=latex y contenido "\\" (salto de línea de LaTeX)
como primer hijo de cada nodo "definition".

diff --git a/ext/fixdl.py b/ext/fixdl.py
new file mode 100644 (file)
index 0000000..610a560
--- /dev/null
+++ b/ext/fixdl.py
@@ -0,0 +1,12 @@
+
+from docutils import nodes
+
+def fix_definition_lists(app, doctree, fromdocname):
+       for def_node in doctree.traverse(nodes.definition):
+               if isinstance(def_node[0], nodes.TextElement):
+                       def_node.children.insert(0, nodes.raw('', r'\\',
+                                       format='latex'))
+
+def setup(app):
+       app.connect('doctree-resolved', fix_definition_lists)
+

diff --git a/source/conf.py b/source/conf.py
index 26636a3376e37ffda617071a10b43269bf10b7ec..f3c7f2c049af92f294595f534d0c3dcc9fd5e19d 100644 (file)
--- a/source/conf.py
+++ b/source/conf.py
@@ -25,6 +25,7 @@ sys.path.insert(0, os.path.abspath('../ext'))
 extensions = [
        'aafig',
        'flt',
+       'fixdl',
        'vref',
        'pcodehl',
        'sphinx.ext.graphviz',