Site web de Scientifiques en rébellion

https://scientifiquesenrebellion.fr/

Comment éditer

Ceci est une mini documentation en attendant que le thème soit extrait et documenté à part entière. Voici l'arcitecture du dossier:

.
├── config.toml     # configuration du site
├── content         # tous les contenus au format markdown
│   ├── appel
│   ├── contact.md
│   ├── _index.md
│   ├── liens
│   ├── medias.md
│   └── textes      # c'est ici que sont les articles
├── public          # dossier où sera placée la version compilée du site
├── README.md       # ce fichier README
├── sass            # les feuilles de style (couleurs, layouts...)
├── static          # les fichiers statiques (images, pdf...)
└── templates       # les templates du thème
    ├── [...]
    ├── custom      # ici sont placées les pages "custom", qui n'utilisent pas un template générique
    └── [...]

Pour ajouter un article, inspirez-vous du fichier content/textes/presse/2099-11-11-TEMPLATE.md par exemple. Pendant l'édition locale, vous pouvez prévisualiser le site avec la commande zola serve qui permet de voir le site sur une url locale (http://127.0.0.1:1111 par défaut).

Liens internes

Pour ajouter un lien interne vers une autre page du site dans un fichier markdown, veuillez utiliser la syntaxe suivante :

[Science is clear](@/actions/2023-05-07-science-is-clear.md)

Cela permet de vérifier que les liens ne sont pas cassés (faute de frappe ou article déplacé) à la compilation, les liens seront remplacés automatiquement par Zola. Le @ permet de spécifier un lien interne vers un fichier du dossier content. Pour plus d'informations, lire la documentation Zola sur les liens internes.

• utiliser le @ uniquement pour les fichiers du dossier content
• pour les images dans le dossier static la vérification n'est pas disponible, utiliser le chemin absolu /chemin/vers/image.jpg

Publier les modifications manuellement

Pour envoyer les modifications manuellement sur le serveur, la commande est la suivante :

zola build && rsync -cvrl public/* scirebel-pic:~/www

rsync permet d'envoyer le contenu du dossier public vers le dossier www via ssh. Vous pouvez également utiliser l'option --delete pour supprimer les fichiers qui ne sont plus nécessaire.

Publication automatique

Les modifications poussées sur la branche master sont publiées automatiquement à l'aide d'un webhook qui déclenche un script (hébergé chez Hugo pour l'instant).

Utilisation de git avec ssh

1. créer une clé ssh si vous n'en avez pas déjà une :

ssh-keygen -t ed25519 -f ~/.ssh/key

2. ajouter cette clé dans vos paramètres gitea

cat ~/.ssh/key.pub
# sortie à copier-coller dans les paramètres

3. cloner le dépôt par ssh ou s'il est déjà cloné par https, changer le remote :

git remote --set-url origin <ssh://git@host:port/chemin/du/dépôt.git>