Dead Simple Documentation
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Install lib with pip:

pip install doccito

- OR -

Put the "doccito" directory somewhere in your python path


Doccito allows quick and easy documentation for your project by taking a readme.markdown file and constructing an html page with a table of contents corresponding to the document's <\h> tags.

More markdown syntax and examples can be found on the Markdown website, here.

###Command-Line Arguments###

Running Doccito on the command-line allows use of either a provided base.html page for your document or a custom one with the [--template] command.

Running Doccito without any arguments will bring up it's help menu with optional arguments:

-h, --help     show help message and exit
--stdio        specifies stdio
--template     specifies custom html template
--version      show program's version number and exit

cat README.markdown | doccito --stdio > docs.html

- OR -

python README.markdown > docs.html

will take the README.markdown file and throw it into the default base.html template and create and send it to docs.html.

cat README.markdown | doccito --stdio --template layout.html > docs.html

will use layout.html as it's template.


Using Doccito as a library allows use of several functions:


  • input is a string containing the documentation in .markdown
  • template is the .html template to be used (optional)

Example usage:

from doccito.doc_generator import create_docs 

create_docs(input, template="./base.html")