MkDocs

MkDocs използва същите принципи, както всяка друга статично Генератор сайт наоколо.
Тя изисква от предприемача да редактирате конфигурационния файл (MKDocs използва YAML за това), създаване на страници шаблони (чрез Jinja2), и добавете съдържание му в специална папка (като евтино файлове).
След това той може да отвори Python CLI стартирате няколко команди и съберат окончателно HTML сайт от всичките си ресурси.
Ако той иска да се актуализира нещо, той може да направи всичките си промени в оригиналния източник и повторно компилиране на сайта чрез конзолата.
Крайният продукт е колекция от HTML, CSS, JS и статични активи, които може да се хоства с всякакъв тип уеб сървър на разположение на пазара.
MkDocs поддържа неограничен брой страници, автоматично генериране на менютата окончателните уебсайт теми, страница мета данни, и идва с основната структура на проекта, по които да започнете.
MkDocs работи и с двете версии на Python език, 2.x и 3.x

Какво ново в тази версия:.

< Ли> Render 404.html файлове, ако те съществуват за текущата тема.
• Bugfix:
• Long навигация барове, маса за рендиране и код подчертаване в MkDocs и ReadTheDocs теми.
• проблем с кода за google_analytics.
• Премахване __pycache__ от пакетите катран.
• евтино връзки, които отиват на котва на текущата страница.
• Не добавяйте prettyprint класове и CSS за всички HTML, само да го добавите в темата MkDocs.
• раздел Display заглавия в темата ReadTheDocs.
• Използвайте избирателната наблюдател в куче-пазач, така възстановяването на произведения на файлови системи, без inotify.
• Подобряване грешка изход за често срещани грешки в конфигурацията свързани.

Какво ново във версия 0.13.3:

• Render 404.html файлове, ако те съществуват за текущата тема.
• Bugfix:
• Long навигация барове, маса за рендиране и код подчертаване в MkDocs и ReadTheDocs теми.
• проблем с кода за google_analytics.
• Премахване __pycache__ от пакетите катран.
• евтино връзки, които отиват на котва на текущата страница.
• Не добавяйте prettyprint класове и CSS за всички HTML, само да го добавите в темата MkDocs.
• раздел Display заглавия в темата ReadTheDocs.
• Използвайте избирателната наблюдател в куче-пазач, така възстановяването на произведения на файлови системи, без inotify.
• Подобряване грешка изход за често срещани грешки в конфигурацията свързани.

Какво ново във версия 0.12.2:

• Render 404.html файлове, ако те съществуват за текущата тема.
• Bugfix:
• Long навигация барове, маса за рендиране и код подчертаване в MkDocs и ReadTheDocs теми.
• проблем с кода за google_analytics.
• Премахване __pycache__ от пакетите катран.
• евтино връзки, които отиват на котва на текущата страница.
• Не добавяйте prettyprint класове и CSS за всички HTML, само да го добавите в темата MkDocs.
• раздел Display заглавия в темата ReadTheDocs.
• Използвайте избирателната наблюдател в куче-пазач, така възстановяването на произведения на файлови системи, без inotify.
• Подобряване грешка изход за често срещани грешки в конфигурацията свързани.

Какво ново във версия 0.11.1:

• Render 404.html файлове, ако те съществуват за текущата тема.
• Bugfix:
• Long навигация барове, маса за рендиране и код подчертаване в MkDocs и ReadTheDocs теми.
• проблем с кода за google_analytics.
• Премахване __pycache__ от пакетите катран.
• евтино връзки, които отиват на котва на текущата страница.
• Не добавяйте prettyprint класове и CSS за всички HTML, само да го добавите в темата MkDocs.
• раздел Display заглавия в темата ReadTheDocs.
• Използвайте избирателната наблюдател в куче-пазач, така възстановяването на произведения на файлови системи, без inotify.
• Подобряване грешка изход за често срещани грешки в конфигурацията свързани.

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

• Джинджа 2.7.1 или по-висока
• Markdown 2.3.1 или по-висока
• PyYAML 3.1 или по-висока