|
2 days ago | |
---|---|---|
content | 2 days ago | |
sass | 4 weeks ago | |
static | 1 week ago | |
templates | 2 weeks ago | |
.gitignore | ||
README.md | ||
config.toml | 2 weeks ago |
README.md
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 dossiercontent
- 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
- créer une clé
ssh
si vous n'en avez pas déjà une :
ssh-keygen -t ed25519 -f ~/.ssh/key
- ajouter cette clé dans vos paramètres gitea
cat ~/.ssh/key.pub
# sortie à copier-coller dans les paramètres
- 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>