Markdoc 0.6.6

A lightweight Markdown-based wiki system.
Markdoc is geared towards managing technical documentation, but can be used for a range of purposes. Markdoc has a few notable selling points:

* Wikis are made up completely of plaintext files, so you can easily put them under version control.
* Wikis compile into standalone HTML directories, which can be distributed as tarballs or served by a HTTP server.
* You can optionally include static media which will be compiled into the HTML directory alongside all your rendered pages.
* Markdoc comes with a fully-functional pure-Python WSGI application and HTTP server for serving up compiled wikis.
* You can render your wiki with a variety of Markdown extensions, such as Pygments-based code highlighting, extended syntax for definition lists, TOC generation, et cetera.
* You can completely customize how your wiki is rendered by editing the Jinja2 templates used to convert rendered Markdown into full HTML documents.

Quickstart

Installation:

#!/bin/bash
hg clone ssh://hg@bitbucket.org/zacharyvoase/markdoc
cd markdoc/
pip install -r REQUIREMENTS
python setup.py install


Making a Wiki

#!/bin/bash
markdoc init my-wiki
cd my-wiki/
vim wiki/somefile.md
# ... write some documentation ...
markdoc build
markdoc serve
# .. open http://localhost:8008/ in a browser ...


Layout

Markdoc wikis have the following default layout:

WIKI_ROOT/
|-- .html/
|-- .templates/
|-- .tmp/
|-- static/
|-- wiki/
`-- markdoc.yaml


The .html/ and .tmp/ directories should be excluded from any VCS, since they contain temporary files.

Consult the layout documentation in doc/wiki/layout.md for more information on the roles of various subdirectories.

last updated on:
May 30th, 2011, 15:56 GMT
price:
FREE!
developed by:
Zachary Voase
license type:
MIT/X Consortium License 
category:
ROOT \ Text Editing&Processing \ Markup

FREE!

In a hurry? Add it to your Download Basket!

user rating

UNRATED
0.0/5
 

0/5

Add your review!

SUBMIT