Markdoc

Markdoc е отличен за техническа документация, ръководства, вътрешна уикита проект, или статични поколения на мястото.
За Техническо документиране / Ръководства, Markdoc може да се използва, за да пишат и правят ръкописни ръководства и наръчници за софтуер. Тази документация обикновено ще бъде отделно от автоматично генерирани API документация, и може да даде оглед по-високо ниво, отколкото само документи API. Тя може да се използва за клиента документация за уеб / десктоп приложения, или дори разработчик документация за рамки.
За вътрешния Project уикита, Markdoc уикита се състоят от единичен обикновен текстов файл на страница. Чрез комбиниране на уики с DVCS (като Mercurial или Git), можете да си сътрудничи с няколко други хора. Използвайте DVCS за проследяване, акции и се сливат промени с един на друг, и да видите уикито & rsquo; ите история.
За Static Site Generation, Markdoc преобразува файл в HTML файлове суровини и медии. Това ви позволява да управлявате един блог, личен сайт или колекция от страници в Markdoc уики, може би с стилове обичай CSS, и публикува на постановеното HTML към сайт. Markdoc не е необходимо да се монтира на мястото за настаняване, тъй като полученият HTML е напълно независима

<силни> Характеристики :.

• Настройване на Google Анализ не проследява в една линия на конфигурацията.

<> Li Barebones уикита, които просто изглеждат като директории с Markdown форматирани текстови файлове в тях.
• A вграден HTTP сървър и прилагане WSGI да обслужват компилиран уики с една единствена команда.
• Непрекъснато се натрупва (чрез Rsync) означава, че сървърът може да продължи да работи, докато Markdoc повторно компилира уикито. Просто обновите вашия браузър, за да видите промените.
• Добави Pygments задвижена оцветяване на синтаксиса на вашия Markdoc уики с единствен параметър конфигурация.
• Markdoc е софтуер, които са обществено достояние. Тя винаги ще бъде напълно свободен да използва, и можете да го разпространявате (частично или изцяло) при никакви обстоятелства (с отворен код, частна или по друг начин) без авторство или encumberances.

<> силни Изисквания

• argparse
• CherryPy
• Jinja2
• Markdown
• Pygments
• PyYAML
• webob
• Python 2.4 или по-висока
• Rsync