MkDocs

MkDocs использует те же принципы, что и любой другой статического генератора сайте вокруг.
Это требует от разработчика редактировать файл конфигурации (MKDocs использует YAML для этого), создавать шаблоны страниц (через jinja2), и добавить его содержимое в отдельную папку (в Markdown файлов).
Затем он может открыть Python CLI выполнить несколько команд и собрать окончательный HTML сайт от всех своих ресурсов.
Если он хочет, чтобы обновить что-то, он может сделать все свои изменения в первоначальный источник и повторно скомпилировать сайт с помощью консоли.
Конечный продукт представляет собой набор HTML, CSS, JS и статических активов, которые могут быть размещены с любым типом веб-сервер, доступный на рынке.
MkDocs поддерживает неограниченное количество страниц, автоматической генерации меню, конечные тем веб-сайт, страницы метаданных, и поставляется с базовой структуры проекта, на котором, чтобы начать.
MkDocs работает с обеими версиями языка Python 2.x, 3.x и.

Что нового в этой версии:

• Render 404.html файлы, если они существуют для текущей темы.
• Исправление:
• Длинные навигационные бары, оказание стол и подсветку кода в MkDocs и ReadTheDocs темы.
• проблема с кодом google_analytics.
• Удалить __pycache__ из пакета дегтя.
• Markdown ссылки, которые идут на якорь на текущей странице.
• Не добавлять prettyprint классы и CSS для всех HTML, только добавить его в теме MkDocs.
• Названия разделов Показать в теме ReadTheDocs.
• Используйте опроса наблюдателя сторожевой так восстановления работы с файловыми системами без Inotify.
• Улучшение ошибка выхода распространенных ошибок конфигурации, связанных с.

Что нового в версии 0.13.3:

• Render 404.html файлы, если они существуют для текущей темы.
• Исправление:
• Длинные навигационные бары, оказание стол и подсветку кода в MkDocs и ReadTheDocs темы.
• проблема с кодом google_analytics.
• Удалить __pycache__ из пакета дегтя.
• Markdown ссылки, которые идут на якорь на текущей странице.
• Не добавлять prettyprint классы и CSS для всех HTML, только добавить его в теме MkDocs.
• Названия разделов Показать в теме ReadTheDocs.
• Используйте опроса наблюдателя сторожевой так восстановления работы с файловыми системами без Inotify.
• Улучшение ошибка выхода распространенных ошибок конфигурации, связанных с.

Что нового в версии 0.12.2:

• Render 404.html файлы, если они существуют для текущей темы.
• Исправление:
• Длинные навигационные бары, оказание стол и подсветку кода в MkDocs и ReadTheDocs темы.
• проблема с кодом google_analytics.
• Удалить __pycache__ из пакета дегтя.
• Markdown ссылки, которые идут на якорь на текущей странице.
• Не добавлять prettyprint классы и CSS для всех HTML, только добавить его в теме MkDocs.
• Названия разделов Показать в теме ReadTheDocs.
• Используйте опроса наблюдателя сторожевой так восстановления работы с файловыми системами без Inotify.
• Улучшение ошибка выхода распространенных ошибок конфигурации, связанных с.

Что нового в версии 0.11.1:

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

Требования:

• Jinja 2.7.1 или выше
• Markdown 2.3.1 или выше
• PyYAML 3.1 или выше