Documentation generator for python3

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?

+3
source share
1 answer

Xinnext () seems to be doing something in Jinja. In Python 3, instead (x). This should be a simple fix.

+1
source

Source: https://habr.com/ru/post/1793434/


All Articles