Recently, I felt a desire to create documentation for my small project. I thought it would be pretty easy, since I had a set of good docksters. It turns out the whole process is much more complicated in python 3.1.
Here is what I tried:
- epydoc: does not work because it is for python 2. 2to3 does not solve the problem
- pydoc: I cannot find any information on how you can create documentation for your own modules, it seems like a server for reading python documents offline
- sphinx: The most promising so far, I built it from my repository, however it fails with a very cryptic error message (jinja2.exceptions.UndefinedError: b'b "\ 'sphinx.jinja2glue.idgen object \" does not have the attribute \ "nearby \" )
My question is: what should I do now? Are there any other non-profit documentation generators that work with python3?
source
share