Side-to-side documentation generator, a descendant of Pycco and Docco.
Project description
Side-to-side documentation generator. Fork of the Pycco, grandfork of the Docco. And an object-oriented one.
Installation
At the moment the release on the PyPi is being prepared. In the meanwhile, to use the Pyccoon
git clone https://github.com/ckald/pyccoon.git
cd pyccoon
python setup.py install
And you’re done. Pyccoon is compatible with Python 2.6, 2.7, 3.3, 3.4 and PyPy. Latest test results can be seen on the Travis CI project page.
Usage
To generate the project documentation
pyccoon -s <source folder> -d <documentation folder>
For additional CLI options, see pyccoon --help
At the moment Pyccoon supports Python, Ruby, Javascript, PHP and C/C++ source files. Other project files will be simply copied to the documentation folder. For additional configuration, create a config file of the kind:
{
// Documentation title
"project_name": "pyccoon v0.1.0 documentation",
// Skip files matching any of the list of regular expressions
"skip_files": [".+\\.pyc", "__pycache__", "\\.travis.yml", "\\.git", "\\.DS_Store"],
// Copy files without processing (useful if you have some binary files)
"copy_files": ["pyccoon.svg", "pyccoon_icon.svg", ".+\\.html", ".+\\.css", "\\.pyccoon"],
// MathJax (http://mathjax.org) support - sometimes we want nice formulas
"mathjax": false
}
Development roadmap
[x] Initial version
[x] Python
[x] Ruby
[x] JavaScript (incomplete, but will do)
[x] C/C++ (incomplete)
[x] PHP (incomplete)
[x] Better page layout
[x] Documentation website
[ ] Write test suites and extend supported languages list:
[x] Python
[ ] Ruby
[ ] PHP
[ ] JavaScript
[ ] C/C++
[ ] CoffeScript
[ ] Perl
[ ] SQL
[ ] Scheme
[ ] Lua
[ ] Erlang
[ ] Tcl
[ ] Haskell
[ ] CSS, LESS, SASS
[ ] Fix bugs:
[x] Fix --watch option
[x] Broken cross-referencing (wikilinks)
[x] Fix multiple Python versions compatibility
[ ] Replace Python Markdown with Mistune (because we want nice extensions)
[ ] Restrict extensions to specific block types
[ ] Create LaTeX codeblocks (to avoid unnecessary \begin{equation}...\end{equation} in the docs and restrict MathJax parsing only to specific elements on the page)
[ ] Use glob: replace config file regular expressions with more natural wildcards (also support matching against the whole path, not only filename)
[ ] Add (actually, fix) line numbers feature (tricky)
[ ] Test against multilanguage projects (i.e., what happens if there are index.html and __init__.py in one folder?)
[ ] Link index files instead of renaming (__init__.py -> index.html)
[ ] Release on PyPi
[ ] Additional features:
[ ] Object retrieval and cross-linking (“jump to definition” for classes, functions)
[ ] Search
[ ] Extended docblocks parsing (capturing shortcuts and aliases for cross-linking)
[ ] Mixed documents parsing: HTML/JS/CSS, HTML/PHP, etc.
[ ] TODO: statements, linting and coverage reports
Acknowledgements
Nick Fitzgerald as an author of Pycco that was a starting point of the development
Jeremy Ashkenas as an author of original idea - Docco
Raccoon designed by Christy Presler from the Noun Project
History
0.1.0 (2014-09-07)
First release on PyPI.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyccoon-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 89cb7e092fbf7d1e2af6bd265e7b99cb35ac3e179a02b6a3562ad49cc5012635 |
|
MD5 | 3c27035101e5b201e413245876c5c5e4 |
|
BLAKE2b-256 | 75f33bf996b5dda40108f2d88c708fc3b23eeda39e1b9cdedbe266d20df07581 |