Toegang
- Open:
http://SERVER_IP
Inhoud bewerken en publiceren
1. Voeg Markdown-bestanden toe of bewerk ze: /opt/mkdocs/docs
2. Als u pagina's toevoegt of hernoemt, werk dan /opt/mkdocs/mkdocs.yml for navigation.
3. Bouw de site opnieuw:
/opt/mkdocs/venv/bin/mkdocs build --clean \
--config-file /opt/mkdocs/mkdocs.yml \
--site-dir /opt/mkdocs/site
Nginx levert de gegenereerde bestanden uit: /opt/mkdocs/site
Na het opnieuw bouwen hoeft Nginx niet te worden herstart.
Belangrijke paden
- Project:
/opt/mkdocs - Inhoud:
/opt/mkdocs/docs - Configuratie:
/opt/mkdocs/mkdocs.yml - Build-uitvoer:
/opt/mkdocs/site - Python-virtualenv:
/opt/mkdocs/venv - Uitvoerbaar bestand van MkDocs:
/opt/mkdocs/venv/bin/mkdocs - Nginx-configuratie:
/etc/nginx/sites-available/mkdocs.conf
Domein en HTTPS
1. Laat uw domein naar het IP-adres van de server wijzen.
2. Bewerk de Nginx-configuratie en vervang server_name _; door uw domein (bijvoorbeeld server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/mkdocs.conf
3. Test de configuratie:
nginx -t
4. Installeer Certbot:
apt install -y certbot python3-certbot-nginx
5. Genereer een Let's Encrypt-certificaat:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Herlaad Nginx:
systemctl reload nginx
7. Werk de MkDocs-site-URL bij: vervang site_url: 'http://<SERVER_IP>/' door site_url: 'https://<YOUR_DOMAIN>/' in /opt/mkdocs/mkdocs.yml.
8. Bouw de site opnieuw:
/opt/mkdocs/venv/bin/mkdocs build --clean \
--config-file /opt/mkdocs/mkdocs.yml \
--site-dir /opt/mkdocs/site
9. Open je browser en bezoek: https://<YOUR_DOMAIN>
Opmerkingen
- Markdown-wijzigingen moeten opnieuw worden gebouwd voordat ze op de publieke site verschijnen.
- Nginx serves the generated files from
/opt/mkdocs/site. - Wijzig
mkdocs.ymlen de projectconfiguratie naar uw voorkeuren.
