Markdoc

Markdoc irányul ügyvezető műszaki dokumentációt, de lehet használni számos célra. Markdoc van néhány figyelemre méltó értékesítési pontok:
* A wikik alkotják teljesen a nyílt szöveg fájlok, így könnyen tegyük ezeket a verziókövető.
* A wikik összeállításához figyelembe standalone HTML könyvtárak, amelyek szerint oszlik forráscsomagokból vagy szolgálja a HTTP szervert.
* Tetszés szerint magában foglalja a statikus média, amely össze kell állítani a HTML könyvtár mellett minden renderelt oldalt.
* Markdoc jön egy teljesen működőképes tiszta Python WSGI alkalmazás és a HTTP szervert kiszolgálását összeállított wikik.
* Meg teheti a wiki, a különféle Markdown kiterjesztésével, mint például Pygments-alapú kód kiemelés, kiterjesztett szintaxis definíciója listákat, TOC generációs, satöbbi.
* Akkor teljesen személyre szabhatja a wiki teszi szerkesztésével Jinja2 sablonokat felhasználni, hogy a nyújtott Markdown a teljes HTML dokumentumokat.
gyorstalpaló
Telepítés:
#! / Bin / bash
hg clone ssh: //hg@bitbucket.org/zacharyvoase/markdoc
cd markdoc /
pip telepíteni -r KÖVETELMÉNYEK
python setup.py telepíteni
Csinálok egy Wiki
#! / Bin / bash
markdoc init my-wiki
cd my-wiki /
vim wiki / somefile.md
# ... Levelet néhány dokumentumot ...
markdoc épít
markdoc szolgálja
# .. Nyitott http: // localhost: 8008 / a böngészőben ...
Layout
Markdoc wikik, amelyek a következő alapértelmezett layout:
WIKI_ROOT /
| - .html /
| - .templates /
| - .tmp /
| - Statikus /
| - Wiki /
`- Markdoc.yaml
A .html / és .tmp / könyvtárakat kell zárni a VCS, mivel azok az ideiglenes fájlokat.
Kérje a layout dokumentációt doc / wiki / layout.md több információt a szerepek különböző alkönyvtárban.

követelmények :

• Python
• pip
• rsync