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