You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
80 lines
3.1 KiB
Markdown
80 lines
3.1 KiB
Markdown
# 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](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 :
|
|
|
|
```md
|
|
[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](https://www.getzola.org/documentation/content/linking/).
|
|
|
|
- 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 :
|
|
|
|
```sh
|
|
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](https://git.42l.fr/user/settings/keys)
|
|
|
|
```
|
|
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>
|
|
```
|