[Python] attivare sphinx con i commenti

Pietro peter.zamb a gmail.com
Mer 29 Feb 2012 22:53:00 CET


Ciao a tutti,

c'è qualcuno qui in lista, che ha già utilizzato sphinx con il
supporto per i commenti, che è in grado di darmi qualche dritta?

ho creato questo repository su github [0] per avere un mini esempio
funzionante... ma non sono riuscito a capire bene la documentazione
[1], è giusto creare il file build.py?

Servono sqlalchemy e flask.

Se provo ad eseguirlo, ottengo:

$ python2 build.py html
Running Sphinx v1.1.2
loading pickled environment... done
Traceback (most recent call last):
  File "build.py", line 14, in <module>
    support.build()
  File "/usr/lib/python2.7/site-packages/sphinx/websupport/__init__.py",
line 121, in build
    'websupport', status=self.status, warning=self.warning)
  File "/usr/lib/python2.7/site-packages/sphinx/application.py", line
134, in __init__
    self._init_builder(buildername)
  File "/usr/lib/python2.7/site-packages/sphinx/application.py", line
194, in _init_builder
    self.builder = builderclass(self)
  File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py",
line 39, in __init__
    self.env.set_versioning_method(self.versioning_method)
  File "/usr/lib/python2.7/site-packages/sphinx/environment.py", line
404, in set_versioning_method
    raise SphinxError('This environment is incompatible with the '
sphinx.errors.SphinxError: This environment is incompatible with the
selected builder, please choose another doctree directory.

voi sapete come farlo funzionare?

Idee? grazie per l'aiuto!

Pietro

[0] https://github.com/zarch/sphinx-comment-demo
[1] http://sphinx.pocoo.org/web/quickstart.html


Maggiori informazioni sulla lista Python