Sphinx (instrumento de documentación): set tamaño de la pestaña de la producción

Question

¿Cómo se establece tamaño de la pestaña en la salida HTML de Sphinx fragmentos de código de relieve por Pygments? Por defecto es el molesto 8, pero quiero 4. No encuentra una palabra acerca de esta configuración en Sphinx conf.py.

Answer 1

Usted tendrá que escribir una extensión Sphinx. Añadir su costumbre lexer , y aplicarlo con VisibleWhitespaceFilter .

Answer 2

añadir algo como esto a su conf.py:

import re

def process_docstring(app, what, name, obj, options, lines):
    spaces_pat = re.compile(r"( {8})")
    ll = []
    for l in lines:
        ll.append(spaces_pat.sub("    ",l))
    lines[:] = ll

def setup(app):
    app.connect('autodoc-process-docstring', process_docstring)

docstring preprocesamiento documentación.

Answer 3

Me hice la misma pregunta en el grupo Sphinx-dev y resulta que es un problema con Docutils que es utilizado por la esfinge. Docutils reemplazan todas las pestañas con 8 espacios y actualmente no hay manera de cambiar ese valor de Sphinx.

http://groups.google.com/group/sphinx -dev / browse_thread / hilo / 35b8071ffe9a8feb

La única solución viable parece ser la de seguir el consejo de S. Lott y John Paulett en los comentarios a mi pregunta -. Espacios de uso en lugar de pestañas