Skip to main content

Create example API documentation in multiple languages

Project description

Flockdoc
========

Create example API documentation in multiple languages (like [Stripe's API
docs][stripe-api])

[stripe-api]: http://stripe.com/docs/api

Usage
-----

### Directory

You need (roughly) this directory structure.

├── code
│   ├── test.py
│   └── test.rb
├── docs
│   └── index.md
└── layout
│ └── index.html
├── static
├── styles.css
└── some_img.jpg

It will be transformed into (roughly) this directory structure:

├── code
│   ├── test.py.html
│   └── test.rb.html
├── index.html
└── static
├── some_img.jpg
└── styles.css

### Individual Files

For code, just write code as normal. Flockdoc will try to take care of
formatting for you. The output will look a little like [Docco][docco].

For markdown, think [Jekyll][jekyll]: header with layout specified, and then
your code. YAML header with Markdown body. Example:

title: Test
context:
key: value
---
This is a test document with a key: {{ key }}

Documents are passed through Jinja2 rendering before they are output.

[docco]: http://jashkenas.github.io/docco/
[jekyll]: http://jekyllrb.com/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for flockdoc, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size flockdoc-0.0.4.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page