From 1b92e2ac0eca0fadbd0362eae166d17e13eff287 Mon Sep 17 00:00:00 2001
From: Rodolphe Robles <rodolphe@linux07.fr>
Date: Fri, 30 Jun 2023 02:25:45 +0200
Subject: [PATCH] readme

---
 README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/README.md b/README.md
index b7560da..87656e2 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,71 @@
 # Documentations-Linux07
 
+Architectures des pages du site [https://documentations.linux07.fr](https://documentations.linux07.fr) propulsé par le cms [GRAV](https://getgrav.org/) avec un thème enfant de [Learn2](https://github.com/getgrav/grav-theme-learn2).
+
+## Création d'un thème enfant (sur Yunohost)
+
+* Installer le plugin the DevTools
+* Naviguer en root sur l'installation de grav `cd /var/www/grav`,
+
+ Puis
+
+ `sudo -u grav php7.4 bin/plugin devtools new-theme`
+
+Ce process pose quelques questions pour créer le nouveau thème: on peut créer un thème enfant qui va suivre le thème parent avec `inherit`. J'utilise un thème `inherit` de Learn2.
+    
+Pour activer le  nouveau theme on change le theme par défaut en éditant `user/config/system.yaml` 
+
+```
+pages:
+    theme: monnouveautheme
+```
+
+On ajoute les lignes si elles manquent qui se trouvent dans le fichier `user/themes/themeparent/themeparent.yaml` dans `user/themes/monnouveautheme/monouveautheme.yaml`
+
+`sudo nano user/themes/monnouveautheme/monnouveautheme.yaml`
+
+par example avec un theme enfant du theme `quark`
+
+```
+streams:
+ schemes:
+   theme:
+     type: ReadOnlyStream
+     prefixes:
+       '':
+         - 'user://themes/mytheme'
+         - 'user://themes/quark'
+
+enabled: true
+production-mode: true
+grid-size: grid-lg
+header-fixed: true
+header-animated: true
+header-dark: false
+header-transparent: false
+sticky-footer: true
+blog-page: '/blog'
+spectre:
+  exp: false
+  icons: false
+```
+
+Certains fichiers ou lignes sont indispensables et le theme peut ne pas être fonctionnel avant de les inclure dans son theme enfant.
+
+`blueprints.yaml` - La configuration utiliser par Grav pour avoir des informations du theme.
+
+`monnouveautheme.php` - Ce fichier doit être nommé en accord avec votre theme. 
+    
+`monnouveautheme.yaml` - la configuration de ce fichier est utilisée par les plugins pour définir les options du theme qu'il doit utiliser.
+    
+`templates/` - ce dossier contient les Twig templates pour le rendu des  pages.
+
+On doit editer `user/themes/monnouveautheme/blueprints.yaml`,  comme pour `monnouveautheme.yaml` en copiant les lignes du theme parent par exemple `user/themes/learn2/blueprints.yaml` et les coller à la fin du fichier.
+
+## Personnalisation du thème
+
+Ensuite, si on veut personaliser le css, on peut éditer un fichier `custom.css`
+
+`nano user/themes/monnouveautheme/css/custom.css`
+
+Pour changer le footer `mkdir user/themes/monnouveautheme/templates/partials` et `nano user/themes/monnouveautheme/templates/partials/footer.html.twig`