MkDocs bruger de samme principper som alle andre statisk websted generator rundt.
Det kræver bygherren til at redigere en konfigurationsfil (MKDocs bruger YAML for dette), skabe sideskabeloner (via Jinja2) og tilføje hans indhold i en særlig mappe (som Markdown filer).
Han kan derefter åbne Python CLI køre et par kommandoer og samle en endelig HTML websted fra alle hans ressourcer.
Hvis han ønsker at opdatere noget, kan han gøre alle hans ændringer i den oprindelige kilde og re-kompilere websted via konsollen.
Det endelige produkt er en samling af HTML, CSS, JS og statiske aktiver, der kan hostes med enhver form for webserver findes på markedet.
MkDocs understøtter et ubegrænset antal sider, automatisk menu generation, endelige website temaer, side meta data, og kommer med en grundlæggende projektstruktur, som at komme i gang.
MkDocs arbejder med begge versioner af Python sproget, 2.x og 3.x
Hvad er nyt i denne udgivelse:.
- < li> Render 404.html filer, hvis de findes for den aktuelle tema.
- Bugfix:
- Lang nav barer, tabel rendering og kode fremhæve i MkDocs og ReadTheDocs temaer.
- Et problem med google_analytics koden.
- Fjern __pycache__ fra pakken tjære.
- Markdown links, der går til et anker på den aktuelle side.
- Du må ikke tilføje prettyprint godt CSS klasser til alle HTML, kun tilføje det i MkDocs tema.
- Skærm sektion titler i ReadTheDocs tema.
- Brug polling observatør i vagthund så genopbygge værker på filsystemer uden inotify.
- Forbedre fejl udgang til fælles konfiguration relaterede fejl.
Hvad er nyt i version 0.13.3:
- Render 404.html filer, hvis de findes for aktuelle tema.
- Bugfix:
- Lang nav barer, tabel rendering og kode fremhæve i MkDocs og ReadTheDocs temaer.
- Et problem med google_analytics koden.
- Fjern __pycache__ fra pakken tjære.
- Markdown links, der går til et anker på den aktuelle side.
- Du må ikke tilføje prettyprint godt CSS klasser til alle HTML, kun tilføje det i MkDocs tema.
- Skærm sektion titler i ReadTheDocs tema.
- Brug polling observatør i vagthund så genopbygge værker på filsystemer uden inotify.
- Forbedre fejl udgang til fælles konfiguration relaterede fejl.
Hvad er nyt i version 0.12.2:
- Render 404.html filer, hvis de findes for aktuelle tema.
- Bugfix:
- Lang nav barer, tabel rendering og kode fremhæve i MkDocs og ReadTheDocs temaer.
- Et problem med google_analytics koden.
- Fjern __pycache__ fra pakken tjære.
- Markdown links, der går til et anker på den aktuelle side.
- Du må ikke tilføje prettyprint godt CSS klasser til alle HTML, kun tilføje det i MkDocs tema.
- Skærm sektion titler i ReadTheDocs tema.
- Brug polling observatør i vagthund så genopbygge værker på filsystemer uden inotify.
- Forbedre fejl udgang til fælles konfiguration relaterede fejl.
Hvad er nyt i version 0.11.1:
- Render 404.html filer, hvis de findes for aktuelle tema.
- Bugfix:
- Lang nav barer, tabel rendering og kode fremhæve i MkDocs og ReadTheDocs temaer.
- Et problem med google_analytics koden.
- Fjern __pycache__ fra pakken tjære.
- Markdown links, der går til et anker på den aktuelle side.
- Du må ikke tilføje prettyprint godt CSS klasser til alle HTML, kun tilføje det i MkDocs tema.
- Skærm sektion titler i ReadTheDocs tema.
- Brug polling observatør i vagthund så genopbygge værker på filsystemer uden inotify.
- Forbedre fejl udgang til fælles konfiguration relaterede fejl.
Krav :
- Jinja 2.7.1 eller højere
- Markdown 2.3.1 eller højere
- PyYAML 3.1 eller højere
Kommentarer ikke fundet