I decided to try Glyph's suggestion first.

By the way, I'm trying to compile twisted documentation on Raspbian, is this platform suitable for that?

The steps I performed just were:

The result was fail, if I understood correctly, due to this error:

Running setup.py bdist_wheel for cryptography: started

Running setup.py bdist_wheel for cryptography: finished with status 'error'

Complete output from command /home/pi/ColourDreams/Twisted-dev/build/narrativedocs/bin/python -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-LEVwwA/cryptography/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" bdist_wheel -d /tmp/tmpTiRC7Rpip-wheel- --python-tag cp27:

Package libffi was not found in the pkg-config search path.

Perhaps you should add the directory containing `libffi.pc'

to the PKG_CONFIG_PATH environment variable

No package 'libffi' found

Maybe it's because Raspbian is not suitable for twisted development? If this is the case, can I use Windows?

Kind regards, Roman Mescheryakov

14.03.2017, 09:49, "Glyph Lefkowitz" <glyph@twistedmatrix.com>:

On Mar 13, 2017, at 9:24 PM, Craig Rodrigues <rodrigc@crodrigues.org> wrote:

On Mon, Mar 13, 2017 at 12:58 PM, Роман Мещеряков <romanmescheryakov@yandex.ru> wrote:

Exception occurred:
File "conf.py", line 45, in <module>
from twisted import version as twisted_version_object
ImportError: No module named twisted

Looks like Twisted needs to be installed in order to build the docs.

I would suggest using a virtualenv for everything, and installing Twisted
from your checkout into it in it.

My suggestion would be to use the tox environments for this that we already provide :).

`tox -e apidocs` will build the API documentation, and `tox -e narrativedocs` will build the narrative documentation. This has the advantage that if we change the required packages for doc-building in the future, these commands will automatically re-build an appropriate virtualenv for the task.

To discover what environments are available, `tox -l`.

-glyph