diff --git a/src/content/doc/_index.md b/src/content/doc/_index.md new file mode 100644 index 0000000..d1b80b3 --- /dev/null +++ b/src/content/doc/_index.md @@ -0,0 +1,12 @@ ++++ +title = "Documentation" +template = "section.html" ++++ + +En cours d'écriture 📝...
+S'il vous manque une information, [contactez-moi](/contact). + +
+ Utilisateurs + Administrateurs +
diff --git a/src/content/documentation.md b/src/content/doc/admins.md similarity index 71% rename from src/content/documentation.md rename to src/content/doc/admins.md index ef8e9fd..39630b8 100644 --- a/src/content/documentation.md +++ b/src/content/doc/admins.md @@ -1,42 +1,10 @@ +++ -title = "Documentation" -slug = "documentation" +title = "Le coin de administrateurs" +slug = "admins" template = "documentation.html" +++ -En cours d'écriture 📝...
-S'il vous manque une information, [contactez-moi](/contact). - -## Utilisateurs {#users} - -Vous trouverez ici toutes les informations dont vous pourriez avoir besoin pour -utiliser les services de NETig. - -### NETmail {#netmail} - -Vous pouvez consulter vos mails depuis le [webmail](https://webmail.netig.net), -mais si vous souhaitez utiliser un client tel que Thunderbird, ou bien K-9 Mail -sur Android voici la configuration : - -IMAP - -* Serveur : mail.netig.net -* Type de sécurité : STARTTLS -* Port : 143 -* Nom d'utilisateur : adresse mail complète - -SMTP - -* Serveur : mail.netig.net -* Type de sécurité : STARTTLS -* Port : 587 -* Nom d'utilisateur : adresse mail complète - -## Administrateurs {#admins} - -Le coins des admins 👨‍💻 ! - -### Infrastructure {#infra} +## Infrastructure {#infra} L'infrastructure "matérielle" de NETig repose sur des VPS (Virtual Private Server) de petite capacité afin de suivre les besoins au plus près, d'éviter les @@ -51,7 +19,7 @@ d'administration. Les services sont conteneurisés avec s'agit d'une couche légère de virtualisation qui permet un niveau supplémentaire de cloisonnement mais également de simplifier les tâches de déploiement. -#### Serveurs {#servers} +### Serveurs {#servers} Actuellement les besoins sont faible, un seul VPS suffit, il est fournit par [HostUp](https://hostup.se/en) en Suède avec Proxmox dans leur datacenter de @@ -63,7 +31,7 @@ Stockholm. | RAM | 16Go | | Stockage | 500Go | -#### Réseau {#network} +### Réseau {#network} Les connexion entrantes sont filtrées par un pare-feu, et redirigées sur le réseau local par un reverse proxy. @@ -73,13 +41,13 @@ réseau local par un reverse proxy. | IPv4 | 103.177.249.4 | | IPv6 | 2a13:7c81:157::2 | -#### Sauvegardes {#backups} +### Sauvegardes {#backups} Les données sont sauvegardées automatiquement une fois par jour et stockées sur le serveur même, ainsi que sur un stockage distant en Allemagne chez [Hetzner](https://www.hetzner.com) dans leur datacenter de Falkenstein. -### Maintenance {#maintenance} +## Chimera Linux {#chimera} Quelques petites choses à savoir concernant Chimera Linux avant de mettre les mains dans le cambouis : @@ -92,11 +60,7 @@ mains dans le cambouis : commandes sont les mêmes mais attention certaines options peuvent parfois être différentes. -#### Connexion aux serveurs {#connection} - -... - -#### APK {#apk} +### APK {#apk} Le gestionnaire de paquets APK d'Alpine Linux est utilisé, il est simple, rapide et extrêmement fiable ! @@ -136,23 +100,21 @@ Supprimer un paquet : > fichier `/etc/apk/world` qui contient la liste des paquets explicitement > installés, APK calcule les dépendances à partir de ce fichier. -#### Nerdctl {#nerdctl} +## Dinit {#dinit} ... -#### Services {#services} +## Maintenance {#maintenance} + +### Connexion aux serveurs {#connection} + +... + +### Nerdctl {#nerdctl} + +... + +### Services {#services} Si nécessaire la documentation spécifique à chaque service si se trouve dans le `README.md` du service sur [NETgit](https://git.netig.net). - -### Installation d'un serveur {#server-install} - -... - -#### Preparation {#preparation} - -... - -#### Installation du système {#install} - -... \ No newline at end of file diff --git a/src/content/doc/users.md b/src/content/doc/users.md new file mode 100644 index 0000000..ae1f23c --- /dev/null +++ b/src/content/doc/users.md @@ -0,0 +1,28 @@ ++++ +title = "Le coin des utilisateurs" +slug = "users" +template = "documentation.html" ++++ + +Vous trouverez ici toutes les informations dont vous pourriez avoir besoin pour +utiliser les services de NETig. + +### NETmail {#netmail} + +Vous pouvez consulter vos mails depuis le [webmail](https://webmail.netig.net), +mais si vous souhaitez utiliser un client tel que Thunderbird, ou bien K-9 Mail +sur Android voici la configuration : + +IMAP + +* Serveur : mail.netig.net +* Type de sécurité : STARTTLS +* Port : 143 +* Nom d'utilisateur : adresse mail complète + +SMTP + +* Serveur : mail.netig.net +* Type de sécurité : STARTTLS +* Port : 587 +* Nom d'utilisateur : adresse mail complète diff --git a/src/sass/css/style.scss b/src/sass/css/style.scss index 366f2fb..513bd98 100644 --- a/src/sass/css/style.scss +++ b/src/sass/css/style.scss @@ -109,13 +109,13 @@ h2 { } h3 { - font-size: 2.2rem; - line-height: 2.2rem; + font-size: 2rem; + line-height: 2rem; } h4 { - font-size: 1.8rem; - line-height: 1.8rem; + font-size: 1.6rem; + line-height: 1.6rem; } /* Animations diff --git a/src/templates/documentation.html b/src/templates/documentation.html index 48fd8f0..2f6f7c4 100644 --- a/src/templates/documentation.html +++ b/src/templates/documentation.html @@ -4,11 +4,14 @@
diff --git a/src/templates/partials/header.html b/src/templates/partials/header.html index cf51764..7e33613 100644 --- a/src/templates/partials/header.html +++ b/src/templates/partials/header.html @@ -1,4 +1,4 @@ -{% if not page %} +{% if current_path == "/" %}
diff --git a/src/templates/partials/navbar.html b/src/templates/partials/navbar.html index d3ceb5f..9139754 100644 --- a/src/templates/partials/navbar.html +++ b/src/templates/partials/navbar.html @@ -29,7 +29,7 @@ Maintenance et incidents
  • - Documentation + Documentation
  • Contact diff --git a/src/templates/partials/topbar.html b/src/templates/partials/topbar.html index 30cf8e7..fc7c213 100644 --- a/src/templates/partials/topbar.html +++ b/src/templates/partials/topbar.html @@ -1,5 +1,5 @@
    - {% if page %} + {% if current_path != "/" %} {% endif %} NETmail diff --git a/src/templates/section.html b/src/templates/section.html new file mode 100644 index 0000000..8eeee24 --- /dev/null +++ b/src/templates/section.html @@ -0,0 +1,8 @@ +{% extends "base.html" %} + +{% block content %} +
    +

    {{ section.title }}

    + {{ section.content | safe }} +
    +{% endblock content %} \ No newline at end of file