Requirements and Installation¶
The latest stable version can be always found on PyPI.
Warning
Since doc2dash
is an application, it has hard-coded dependency versions.
I strongly discourage from installing it into your global site-packages
because it will inevitably lead to conflicts.
Either use pipsi or create a virtualenv by hand.
doc2dash
runs on Python 2.7, and 3.3+, and PyPy.
Both Linux and OS X are supported although certain features are only available on OS X.
Note
For best performance when converting large pieces documentation, I strongly recommend using PyPy as the interpreter of choice.
Viewer¶
To view the results, you will need a docset viewer, the most commonly known being Dash.app for OS X.
Other alternatives have been developed in cooperation with Dash.app’s developer Kapeli:
- helm-dash for Emacs,
- lovelydocs for Android,
- velocity for Windows,
- and zeal for Linux and Windows.
doc2dash
is only tested against the original Dash.app though.