Markdoc

Markdoc este orientat spre gestionarea documentației tehnice, dar poate fi folosit pentru o serie de scopuri. Markdoc are câteva puncte de vânzare notabile:
* Wiki sunt formate complet de fișiere plaintext, astfel încât să le puteți pune cu ușurință sub controlul versiunilor.
* Wiki compila în directoare HTML stătătoare, care pot fi distribuite ca tar sau deservite de un server HTTP.
* Puteți include opțional media statice, care vor fi compilate în directorul HTML alături de toate paginile prestate.
* Markdoc vine cu un server complet funcțional aplicație și HTTP pură Python WSGI pentru servire până wiki compilate.
* Puteți face wiki-ul cu o varietate de extensii Markdown, cum ar fi Codul Pygments bazat pe evidențierea, sintaxa extinsă pentru listele definiție, generație TOC, et cetera.
* Puteți personaliza complet modul în care wiki este redat prin editarea template-uri Jinja2 utilizate pentru a converti Markdown prestate în documente complete HTML.
Quickstart
Instalare:
#! / Bin / bash
hg clone ssh: //hg@bitbucket.org/zacharyvoase/markdoc
cd markdoc /
PIP instala CERINȚE-R
python setup.py instala
Efectuarea unui Wiki
#! / Bin / bash
markdoc init meu-wiki
cd meu-wiki /
vim wiki / somefile.md
# ... A scrie o documentație ...
markdoc construi
markdoc servi
# .. Http deschis: // localhost: 8008 / într-un browser ...
Layout
Wiki Markdoc avea următorul aspect implicit:
WIKI_ROOT /
| - .html /
| - .templates /
| - .tmp /
| - Static /
| - Wiki /
`- Markdoc.yaml
Html / și .tmp / directoarele ar trebui excluse de la orice VCS, deoarece conțin fișiere temporare.
Consultați documentația aspect în doc / wiki / layout.md pentru mai multe informații cu privire la rolul diferitelor subdirectoare

Cerințe :.

• Python
• pip
• rsync