Add a user documentation for Hugo

content/docs/utilisation/_index.md

@@ -0,0 +1,5 @@
+---
+title: Utilisation des services
+---
+
+# Utilisation des services

content/docs/utilisation/hugo.md

@@ -0,0 +1,55 @@
+---
+title: Créer un site statique avec Hugo
+---
+
+# Créer un site statique avec Hugo
+
+Hugo est un générateur de sites statiques écrit en go. Le principe est de lui fournir du contenu écrit en markdown et de lui indiquer un thème à suivre, il génère ensuite l'ensemble du site en HTML, CSS et JS qu'il suffit de téléverser sur son serveur web.
+
+Ce n'est pas un service disponible sur notre infrastructure mais plutôt un programme que l'on installe en local sur sa machine. Ce site de documentation ainsi que le [blog](https://rdelaage.ovh/blog) utilisent ce système.
+
+## Télécharger Hugo
+
+On se rend sur la page GitHub de Hugo puis on sélectionne la version adaptée à son système, on va télécharger l'exécutable dans un dossier inclus dans la varible `$PATH` (par exemple `/usr/bin`)
+
+```
+wget -O /usr/bin/hugo <url>
+```
+
+## Créer un nouveau site
+
+On se rend dans un répertoire de travail dans lequel on placera l'ensemble de nos sites. Pour créer un nouveau projet il suffit de lancer
+
+```
+hugo new site <nom du site>
+```
+
+puis un dossier `<nom du site>` et créé, il contient l'ensemble des fichiers nécessaires pour générer notre site.
+
+Une bonne pratique à faire est d'initialiser un dépôt git dans ce dossier (simplement `git init`) et on peut y ajouter l'ensemble du dossier puis faire un commit (`git add .; git commit -m "First commit"`). On peut ensuite choisir un [thème](https://themes.gohugo.io/) puis on l'ajoute en tant que sous module du dépôt
+
+```
+git submodule add <url vers le dépôt git du thème> themes/<nom du thème>
+```
+
+Cette commande est en général rappellée dans la procédure d'installation des thèmes.
+
+Ce qui suit dépendra de votre utilisation de hugo, il faut penser à éditer le fichier de configuration comme le demande le thème, vous pouvez aussi jeter un oeil au dossier `themes/<nom du thème>/exampleSite` qui donne un aperçu du fonctionnement du thème.
+
+La commande permettant de créer un nouveau fichier pré-rempli est
+
+```
+hugo new <chemin vers fichier>
+```
+
+il sera placé dans content et aura déjà un modèle de ce que doit contenir le fichier, pour un post de blog on le met dans `posts/<nom>.md`, pour de la doc `docs/<nom>.md`.
+
+Quand vous êtes prêt à générer le site il faut lancer tout simplement
+
+```
+hugo
+```
+
+Le site sera généré dans le dossier `public` qu'il faut mettre dans votre serveur web.
+
+Maintenant il suffit de tester et d'explorer les différents exemples pour en apprendre plus !

content/docs/utilisation/miniflux.md

@@ -0,0 +1,39 @@
+---
+title: Utiliser miniflux
+---
+
+# Utiliser Miniflux
+
+## Présentation générale
+
+Miniflux est un agrégateur de flux RSS et Atom, c'est à dire qu'il permet de récupérer les dernières mises à jour d'un site, blog, chaîne youtube, ... au même endroit. Vous pouvez trouver une instance de ce service [ici](https://rdelaage.ovh/miniflux).
+
+{{<hint warning>}}
+Attention la création de compte automatique n'est pas disponible pour ce service, il vous faudra [contacter l'administrateur](mailto:romain.delaage@rdelaage.ovh) !
+{{</hint>}}
+
+Sur la page d'acceuil du service il y a la liste des articles non lus, à la première connexion elle est vide car vous ne suivez aucun flux.
+
+![Page d'acceuil](https://rdelaage.ovh/doc/miniflux1.png)
+
+## S'abonner à un flux
+
+Après avoir récupéré l'adresse du flux auquel vous souhaitez vous abonner, rendez-vous dans l'onglet `Abonnements` ou `Feeds`
+
+![Emplacement de l'onglet abonnement](https://rdelaage.ovh/doc/miniflux2.png)
+
+Une fois dans cet onglet vous pouvez cliquer sur `Ajouter un abonnement` ou `Add subscription`
+
+![Emplacement ajouter un abonnement](https://rdelaage.ovh/doc/miniflux3.png)
+
+Un formulaire s'ouvre alors et vous y copiez l'emplacement du flux
+
+![Formulaire d'ajout d'un abonnement](https://rdelaage.ovh/doc/miniflux4.png)
+
+On peut également changer la catégorie de l'abonnement.
+
+## Ajouter une catégorie
+
+Il est également possible de créer des catégories afin de trier les informations vous viennent. Cela permet de s'y retrouver plus facilement quand on a plusieurs abonnements.
+
+Il faut commencer par se rendre dans l'onglet `Catégorie` à côté de celui `Abonnement`, dans celui ci on peut cliquer sur `Créer une catégorie` il suffit de lui donner un nom.