Platformy a technologie pro tvorbu wikipedie

Pro tvorbu wikipedie (příp. encyklopedie nebo dokumentace) existuje mnoho platforem a technologií - např:

• MkDocs, ...

Nejlepší blogovací technologie

MkDocs + GitHub Pages

Úvodní informace

MkDocs je nástroj pro vytváření statických webových stánek pomocí Markdownu. GitHub Pages umožňuje hostování statických webových stránek přímo z repozitáře na GitHubu.

Technologie

MkDocs podporuje různé motivy pro přizpůsobení vzhledu dokumentace. GitHub Pages umožňuje snadné, rychlé a automatické nasazení statických stránek přímo z repozitáře.

Jak spustit a upravovat

Nejprve si nainstaluj MkDocs a vytvoř nový projekt pomocí příkazu mkdocs new my-project. Poté přidej obsah do složky docs/ a spusť lokální server pomocí mkdocs serve. Jakmile jsi spokojený s výsledkem, můžeš nasadit svou wiki na GitHub Pages pomocí příkazu mkdocs gh-deploy.

Vlastní doména

Pokud chceš mít vlastní doménu pro svou wiki, můžeš ji snadno nastavit na GitHub Pages. Stačí přidat doménu v nastavení repozitáře a následovat pokyny pro ověření vlastnictví domény. Jakmile je doména ověřena, můžeš ji přiřadit k tvé wiki a začít ji používat.

Výhody a nevýhody

Výhody

• Vše zdarma (včetně CICD a webhostingu).
• Snadná správa obsahu pomocí Markdownu.
• Rychlé a automatické nasazení na GitHub Pages.

Nevýhody

• Mírná závislost na externích službách (pouze GitHub a GitHub Pages).
• Potřeba znalosti Markdownu, Gitu a GitHubu.

TODO

TODO: Lépe popsat, jak se to používá.