Markdoc

Markdoc ay nakatuon sa pamamahala ng mga teknikal na dokumentasyon, ngunit maaaring magamit para sa isang hanay ng mga layunin. Markdoc ay may ilang mga litaw nagbebenta ng mga puntos:
* Wiki ay ganap na binubuo ng plaintext file, kaya madali mong ilagay ang mga ito sa ilalim version control.
* Wiki sumulat ng libro sa standalone na direktoryo ng HTML, na maaaring ipamahagi bilang tarballs o nagsilbi sa pamamagitan ng isang HTTP server.
* Maaari mong opsyonal na magsama static media na kung saan ay naipon sa direktoryo ng HTML sa tabi ng lahat ng iyong mga nai-render na pahina.
* Markdoc lumapit sa isang ganap na-pagganap purong-sawa WSGI application at HTTP server para sa paghahatid up naipon wikis.
* Maaari mong render ang iyong wiki sa isang iba't Markdown extension, tulad ng mga code highlighting-based Pygments, extended syntax para sa mga listahan ng kahulugan, toc henerasyon, at iba pa.
* Maaari mong ganap na i-customize kung paano ang iyong wiki ay nai-render sa pamamagitan ng pag-edit ang Jinja2 template na ginagamit upang i-convert render Markdown sa buong HTML na dokumento.
Quickstart
Pag-install:
#! / Bin / malakas na palo
hg clone ssh: //hg@bitbucket.org/zacharyvoase/markdoc
cd markdoc /
PIP install r KINAKAILANGAN
python setup.py install
Paggawa ng isang Wiki
#! / Bin / malakas na palo
markdoc init my-wiki
cd my-wiki /
kalakasan wiki / somefile.md
# ... Sumulat ng ilang mga babasahin ...
markdoc build
markdoc maglingkod
# .. Open http: // localhost: 8008 / sa isang browser ...
Layout
Markdoc wiki ay may mga sumusunod default layout:
WIKI_ROOT /
| - .html /
| - .templates /
| - Tmp /
| - Static /
| - Wiki /
`- Markdoc.yaml
Ang .html / at tmp / directories ay dapat na ibinukod mula sa anumang VCS, dahil naglalaman ang mga ito ng pansamantalang file.
Kumonsulta sa dokumentasyon layout sa doc / wiki / layout.md para sa karagdagang impormasyon sa mga tungkulin ng iba't-ibang mga subdirectory

Kinakailangan .

• Sawa
• pip
• rsync