MkDocs використовує ті ж принципи, як і будь-який інший статичного генератора сайті навколо.
Це вимагає від розробника редагувати файл конфігурації (MKDocs використовує YAML для цього), створювати шаблони сторінок (через jinja2), і додати його вміст в окрему папку (як Markdown файлів).
Потім він може відкрити Пітон CLI виконати кілька команд і зібрати остаточний HTML сайт від усіх своїх ресурсів.
Якщо він хоче, щоб оновити щось, він може зробити всі свої зміни в початковий джерело і повторно скомпілювати сайт за допомогою консолі.
Кінцевий продукт являє собою набір HTML, CSS, JS і статичних активів, які можуть бути розміщені з будь-яким типом веб-сервер, доступний на ринку.
MkDocs підтримує необмежену кількість сторінок, автоматичної генерації меню, кінцеві тим веб-сайт, сторінки метаданих, і поставляється з базової структури проекту, на якому, щоб почати.
MkDocs працює з обома версіями мови Python 2.x, 3.x і
Що нового У цьому випуску :.
- < Li> 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 файли, якщо вони існують для поточна тема.
- Виправлення:
- Довгі навігаційні бари, надання стіл і підсвічування коду в MkDocs і ReadTheDocs теми.
- проблема з кодом google_analytics.
- Видалити __pycache__ з пакету дьогтю.
- Markdown посилання, які йдуть на якір на поточній сторінці.
- Не додавати prettyprint класи і CSS для всіх HTML, тільки додати його в темі MkDocs.
- Назви розділів Показати в темі ReadTheDocs.
- Використовуйте опитування спостерігача сторожовий так відновлення роботи з файловими системами без Inotify.
- Поліпшення помилка виходу поширених помилок конфігурації, пов'язаних с.
Вимоги
- Дзиндзя 2.7.1 або вище
- уцінки 2.3.1 або вище
- PyYAML 3.1 або вище
Коментар не знайдено