Markdoc е насочена към управление на техническа документация, но може да се използва за различни цели. Markdoc има няколко забележителни точки за продажба:
* Wikis са съставени изцяло от явен файлове, така че да можете лесно да ги постави под контрол версия.
* Wikis съставят в самостоятелни HTML директории, които могат да бъдат разпределени като архиви или обслужвани от HTTP сървър.
* По желание можете да включва статични средства, които ще бъдат събирани в директорията HTML заедно всичките си оказани страници.
* Markdoc идва с напълно функционална чист-Python WSGI кандидатстване и HTTP сървър за генерирането на компилирани файл.
* Можете да превърнете уики с различни евтино разширения, като например Pygments базиран код Отбелязването разширен синтаксис за списъци дефиниция поколение TOC, и така нататък.
* Можете да напълно да персонализирате начина си уики се оказва чрез редактиране на шаблони Jinja2 използват за преобразуване на постановеното Markdown в пълни HTML документи.
<Силен> Quickstart
Монтаж:
#! / BIN / Баш
Hg клонинг SSH: //hg@bitbucket.org/zacharyvoase/markdoc
CD markdoc /
PIP инсталирате -r ИЗИСКВАНИЯ
питон setup.py инсталиране
Осъществяване на Wiki
#! / BIN / Баш
markdoc първоначален ми-уики
CD-ми уики /
Vim уики / somefile.md
# ... Напиши някои документи ...
markdoc строителство
markdoc служи
# .. Отворена HTTP: // Localhost: 8008 / в браузъра ...
<Силен> Layout
Markdoc уикита имат следното разпределение по подразбиране:
WIKI_ROOT /
| - .html /
| - .templates /
| - .tmp /
| - Статична /
| - Уики /
`- Markdoc.yaml
The .html / и .tmp / директории трябва да бъдат изключени от всякакви VCS, тъй като те съдържат временни файлове.
Консултирайте се с документацията на оформлението в док / уики / layout.md за повече информация относно ролите на различните поддиректории
<силни> Изисквания :.
- <Ли > Python
- Пип
- Rsync
Коментари не е намерена