Přístup
- Otevřete:
http://SERVER_IP
Úprava a publikování obsahu
1. Přidejte nebo upravte soubory Markdown: /opt/mkdocs/docs
2. Pokud přidáte nebo přejmenujete stránky, upravte /opt/mkdocs/mkdocs.yml for navigation.
3. Znovu sestavte web:
/opt/mkdocs/venv/bin/mkdocs build --clean \
--config-file /opt/mkdocs/mkdocs.yml \
--site-dir /opt/mkdocs/site
Nginx servíruje vygenerované soubory z: /opt/mkdocs/site
Po znovusestavení není nutné restartovat Nginx.
Důležité cesty
- Projekt:
/opt/mkdocs - Obsah:
/opt/mkdocs/docs - Konfigurace:
/opt/mkdocs/mkdocs.yml - Výstup buildu:
/opt/mkdocs/site - Virtuální prostředí Pythonu:
/opt/mkdocs/venv - Spustitelný soubor MkDocs:
/opt/mkdocs/venv/bin/mkdocs - Konfigurace Nginx:
/etc/nginx/sites-available/mkdocs.conf
Domény a HTTPS
1. Nasměrujte svou domény na IP adresu serveru.
2. Upravte konfiguraci Nginx a nahraďte server_name _; svou doménou (například server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/mkdocs.conf
3. Otestujte konfiguraci:
nginx -t
4. Nainstalujte Certbot:
apt install -y certbot python3-certbot-nginx
5. Vygenerujte certifikát Let's Encrypt:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Znovu načtěte Nginx:
systemctl reload nginx
7. Aktualizujte URL webu MkDocs: nahraďte site_url: 'http://<SERVER_IP>/' za site_url: 'https://<YOUR_DOMAIN>/' in /opt/mkdocs/mkdocs.yml.
8. Znovu sestavte web:
/opt/mkdocs/venv/bin/mkdocs build --clean \
--config-file /opt/mkdocs/mkdocs.yml \
--site-dir /opt/mkdocs/site
9. Otevři prohlížeč a přejdi na: https://<YOUR_DOMAIN>
Poznámky
- Změny v Markdownu je nutné znovu sestavit, než se objeví na veřejném webu.
- Nginx serves the generated files from
/opt/mkdocs/site. - Změňte
mkdocs.ymla konfiguraci projektu podle svých preferencí.
