Markdoc

Markdoc отлично подходит для технической документации, руководств, внутренней вики проекта, или статических поколений сайта.
Для технической документации / Руководства, Markdoc может быть использован для написания и сделать рукописные руководства и пособия для программного обеспечения. Такая документация, как правило, отделены от автоматически сгенерированного API документации, и, возможно, дать представление более высокого уровня, чем API Docs только. Это может быть использован для клиентской документации для веб / настольных приложений, или даже разработчик документации рамок.
Для внутреннего проекта вики, вики Markdoc состоять из одного текстовом файле на странице. Объединив вики с DVCS (например, Mercurial или Git), вы можете сотрудничать с несколькими другими людьми. Используйте DVCS отслеживать, совместно использовать и объединить изменения с другом, а также просматривать вики & Rsquo; s историю.
Для статического поколения сайта, Markdoc преобразует вики в сырых HTML файлов и средств массовой информации. Это позволяет вам управлять блог, личный сайт или набор страниц в Markdoc вики, возможно, со стилями CSS обычай, и опубликовать вынесенное HTML на веб-сайт. Markdoc не обязательно быть установлен на хостинг сайта, так как в результате HTML-является полностью независимым

Особенности :.

• Настроить Google Аналитика отслеживания в одной строке конфигурации.
• усеченный вики, что просто смотреть, как каталоги с уценки отформатированных текстовых файлов в них.
• Встроенный HTTP-сервер и WSGI приложения обслуживать до скомпилированный вики с одной командой.
• Непрерывный строит (с помощью Rsync) означает, что сервер может продолжать работать, пока Markdoc повторно компилирует вики. Просто обновите браузер, чтобы увидеть изменения.
• Добавить Pygments-активный подсветку синтаксиса для вашего Markdoc вики с одним параметром конфигурации.
• Markdoc это программное обеспечение общественным достоянием. Она всегда будет абсолютно бесплатна для использования, и вы можете распространять ее (частично или полностью) ни при каких обстоятельствах (с открытым исходным кодом, служебной или иначе) без присвоения или encumberances.

Требования

• argparse
• CherryPy
• jinja2
• уценки
• Pygments
• PyYAML
• WebOb
• Python 2.4 или выше
• Rsync