readme
This commit is contained in:
parent
0d60467973
commit
1b92e2ac0e
1 changed files with 69 additions and 0 deletions
69
README.md
69
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`
|
||||
|
|
Loading…
Reference in a new issue