MkDocs

MkDocs usa os mesmos princípios que qualquer outra gerador de site estático ao redor.
Ela exige que o desenvolvedor para editar um arquivo de configuração (MKDocs usa YAML para isso), criar modelos de página (via Jinja2), e adicionar seu conteúdo em uma pasta especial (como arquivos de remarcação para baixo).
Ele pode, então, abrir o Python CLI executar alguns comandos e montar um site HTML final a partir de todos os seus recursos.
Se ele quer atualizar alguma coisa, ele pode fazer todas as suas alterações na fonte original e re-compilar o site através do console.
O produto final é uma coleção de HTML, CSS, JS e ativos estáticos que podem ser hospedados com qualquer tipo de servidor Web disponíveis no mercado.
MkDocs suporta um número ilimitado de páginas, geração automática de menu, temas website finais, página meta dados, e vem com uma estrutura básica de projeto no qual começar.
MkDocs trabalha com ambas as versões da linguagem Python, 2.xe 3.x

O que é novo nesta versão:.

< li> Render arquivos 404.html se eles existem para o tema atual.
• Correção:
• bares Longa nav, prestação mesa e código destacando em MkDocs e ReadTheDocs temas.
• Um problema com o código google_analytics.
• Remover __pycache__ do alcatrão pacote.

ligações
• Markdown que vão para uma âncora na página atual.
• Não adicionar classes bem CSS prettyprint a todos HTML, apenas a adicioná-lo no tema MkDocs.
• títulos de seções de exibição no tema ReadTheDocs.
• Use o observador de votação em watchdog tão reconstrução trabalhos sobre sistemas de arquivos sem inotify.
• Melhorar saída de erro para erros de configuração relacionados comuns.

O que é novo na versão 0.13.3:

• Render arquivos 404.html se eles existem para o tema atual.
• Correção:
• bares Longa nav, prestação mesa e código destacando em MkDocs e ReadTheDocs temas.
• Um problema com o código google_analytics.
• Remover __pycache__ do alcatrão pacote.

ligações
• Markdown que vão para uma âncora na página atual.
• Não adicionar classes bem CSS prettyprint a todos HTML, apenas a adicioná-lo no tema MkDocs.
• títulos de seções de exibição no tema ReadTheDocs.
• Use o observador de votação em watchdog tão reconstrução trabalhos sobre sistemas de arquivos sem inotify.
• Melhorar saída de erro para erros de configuração relacionados comuns.

O que é novo na versão 0.12.2:

• Render arquivos 404.html se eles existem para o tema atual.
• Correção:
• bares Longa nav, prestação mesa e código destacando em MkDocs e ReadTheDocs temas.
• Um problema com o código google_analytics.
• Remover __pycache__ do alcatrão pacote.

ligações
• Markdown que vão para uma âncora na página atual.
• Não adicionar classes bem CSS prettyprint a todos HTML, apenas a adicioná-lo no tema MkDocs.
• títulos de seções de exibição no tema ReadTheDocs.
• Use o observador de votação em watchdog tão reconstrução trabalhos sobre sistemas de arquivos sem inotify.
• Melhorar saída de erro para erros de configuração relacionados comuns.

O que é novo na versão 0.11.1:

• Render arquivos 404.html se eles existem para o tema atual.
• Correção:
• bares Longa nav, prestação mesa e código destacando em MkDocs e ReadTheDocs temas.
• Um problema com o código google_analytics.
• Remover __pycache__ do alcatrão pacote.

ligações
• Markdown que vão para uma âncora na página atual.
• Não adicionar classes bem CSS prettyprint a todos HTML, apenas a adicioná-lo no tema MkDocs.
• títulos de seções de exibição no tema ReadTheDocs.
• Use o observador de votação em watchdog tão reconstrução trabalhos sobre sistemas de arquivos sem inotify.
• Melhorar saída de erro para erros de configuração relacionados comuns.

Requisitos :

• Jinja 2.7.1 ou superior
• Markdown 2.3.1 ou superior
• PyYAML 3.1 ou superior