website/README.md

# Gnuragistes

## todo

* [x] changer le domaine par défaut vers ynh.gnuragist.es
* [x] virer le rediret vers /site pour avoir gnuragist.es/index.html
* [x] passer en revue les warning dans le diagnostic Yunohost (System configuration)

## contenu à reprendre

* [x] https://wiki.gnuragist.es/blog:en_couche
* [x] https://wiki.gnuragist.es/documentation:borg
* [X] https://wiki.gnuragist.es/documentation:gitea:ldap-ssl
* [x] https://wiki.gnuragist.es/documentation:gitea:remote-support-script
* [ ] https://wiki.gnuragist.es/notes:quoi-pour-qui
* [x] https://wiki.gnuragist.es/notes:certificate-renewal-fail
* [ ] https://wiki.gnuragist.es/notes:a-propos
* [x] https://ps.zoethical.org/t/gnuragistes-entre-benevolat-et-remuneration/3838
* [x] https://ps.zoethical.org/t/gnuragistes-dou-ca-vient-et-vers-ou-ca-va/3746
* [x] https://ps.zoethical.org/t/gnuragistes-entre-benevolat-et-remuneration/3838

## makefile

Voir chez [tharyrok](https://gitlab.domainepublic.net/Tharyrok/tharyrok-eu/-/blob/master/Makefile) si besoin.

Pour pouvoir utiliser le `make rsync_upload` il faut un peu adapter le Yunohost.

```
# usermod -a -G ssh.app my_webapp__4 # ajouter le group ssh.app à l'utilisateur de la Webapp 
# nano /etc/passwd # éditer pour autoriser l'utilisation d'un terminal / rsync
Pour y changer le /usr/bin/nologin par /bin/bash pour l'utilisateur my_webapp__4
…
my_webapp__4:x:993:993::/var/www/my_webapp__4:/bin/bash
…
```

### Pour utiliser rsync_upload sur Yunohost

- installer une Custom Webapp
- ajouter le group `ssh.app` à l'utilisateur de la Webapp `usermod -a -G ssh.app my_webapp__X`
- authoriser l'utilisation d'un terminal `nano /etc/passwd` et remplacer `/usr/bin/nologin` par `/bin/bash` pour l'utilisateur de la Webapp
- créer un dossier `.ssh` dans `/var/www/my_webapp__X/.ssh`
- copier / coller votre clé publique dans un nouveau fichiers `/var/www/my_webapp__X/.ssh/authorized_keys`

## Ressources

* [ForkAwsome cheatsheet](https://forkaweso.me/Fork-Awesome/cheatsheet/)
* [Cool and responsive buttons](https://fdossena.com/?p=html5cool/buttons/i.frag)
* [Jinja](https://jinja.palletsprojects.com/en/3.0.x/templates/)
* [Pelican - templates and variables](https://docs.getpelican.com/en/latest/themes.html#templates-and-variables)

## Contenu

Sur le site …

- une page d'acceuil
- des articles
- des auteurs - qui sont potentiellement les gnuragistes
- des mots clés
- de quoi nous contacter


## Menu

Sous forme de boutons, sans sous-menu, qui se mettent les uns à côté des autres.

### Links (dans le pelicanconf.py)

Les liens « statiques » sont définit dans `pelicanconf.py`.

### Catégories (comme Faimaison)

À découvrir : les mécanismes de Pelican.


## Zone de titre(s)

- Un logo pour retourner sur la home page
- Un titre
- Un sous-titre

## Contenu

## Fork-Awsome

Puisque c'est un repo git qui se trouve dans `template/gnuragistes/static/css/Fork-Awesome`.

Pour éviter les problèmes, dans un premier temps le `.gitignore` contient ce chemin et le `pelicanconf.py` ignore aussi ce dossier grâce à `IGNORE_FILES = ['.git']`.

Il faudrait éventuellement approfondir le sujet en utilisant la notion de submodule ou subtree.

Voir : https://delicious-insights.com/fr/articles/git-submodules/

### Base

Se retrouve sur toutes les pages.

### Page d'acceuil

C'est pricipallement le fichier `content/page/home.md` dont le contenu enregistré sous `index.html` grâce à la variable `save_as: index.html`.

### Articles

Je ne sais pas encore…

## Accessibilité

99/100 en février 2022

* https://accessibilitytest.org/results/W6C1LGTDyv_5


## Installation de Pelican

+ a ne pas oublier : pip3 install pelican  markdown