A sphinx document tranformer


This is a sphinx document transformer with xdv and an open source design.


  • You are familiar with zc.buildout.
  • You are familiar with xml and perhaps xslt.


  • libxml2 and libxslt to use lxml.


  1. Setup your buildout.

  2. Run install command with document_root variable.:

    ./bin/buildout buildout:document_root=target_sphinx_html_directory install

    The variable must be the path to root of sphinx output html directory. This transformer assumes the sphinx document is generated with basic theme.

    Then some buildout dependant files must exist at the local buildout directory.

  3. Check layout with Paste.:

    ./bin/paster serve wsgi.ini

    Then open the url http://localhost:8000/ with your browser.

  4. If everything looks like OK, make static output.:


    Few seconds later, the generated files must be in output directory if no error happened.


  • If you are new for xdv, static/rule.xml might be good knowledge.
  • The template way now I taken is horrible. Should be smart. :^)


MURAOKA Yusuke <>

Feel free to mail me any question or comment.