deuxfleurs.fr
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Vincent cbc0b048af Description de Diplonat 2 weeks ago
src Description de Diplonat 2 weeks ago
.drone.yml Merge CI fix to not deploy on PR 2 months ago
.gitignore Migrate to garage 5 months ago
DEPLOY.md Add a deploy doc 4 months ago
LICENSE Initial commit 1 year ago
README.md Update CI badge to point to main 2 months ago
deploy Deploy Thunderbird conf 5 months ago
package-lock.json Mise à jour des dépendances 2 months ago
package.json Mise à jour des dépendances 2 months ago
render.js Deploy Thunderbird conf 5 months ago

README.md

site

Build Status

Ce dépôt git contient les sources pour le site deuxfleurs.fr. C'est ici que vous pourrez apporter des modifications au site.

Comment ajouter du contenu ?

Prérequis :

  • Un compte sur cette instance gitea.
  • Le logiciel git d'installé. téléchager.

Pour commencer, assurez-vous d'être connecté. Ensuite cliquez sur le bouton "Bifurcation" en haut à droite (fork en anglais). Finalement, vous pourrez cloner votre dépôt en local :

git clone https://git.deuxfleurs.fr/<votre nom d'utilisateur>/site.git

Pour ajouter du contenu, vous pouvez tout simplement ajouter un fichier dans le dossier src. Par exemple, le fichier src/Association/Statuts.md se retrouve à l'adresse https://deuxfleurs.fr/Association/Statuts.html.

Deux formats de fichiers différents sont supportés pour l'instant :

  • .md pour Markdown. documentation. Rapide à apprendre, il est très pratique pour rajouter du contenu sans se poser la question de l'apparence.
  • .pug pour Pug. documentation. PugJS est une syntaxe différente pour représenter du HTML. Elle offre donc toute la souplesse de ce dernier et s'adapte plus à des mises en page complexe.

Si vous ne savez pas par où commencer, choisissez markdown ! N'hésitez pas à vous inspirer des fichiers existants.

Une fois vos modifications terminées, vous pouvez commit et push :

git add src/Association/MonFichier.md
git commit -a
git push

Ensuite, vous pouvez créer une demande d'ajout (pull request ou merge request en anglais) depuis cette adresse (ou en cliquant sur l'onglet éponyme) : https://git.deuxfleurs.fr/Deuxfleurs/site/pulls

Comment prévisualiser mes modifications ?

Prérequis :

Vous pourriez vouloir vérifier que vos modifications rendent bien avant de faire votre demande d'ajout. Pour cela, nous utilisons un script de notre cru nommé render.js. Il convertit le dossier src/ vers un site web contenu dans le dossier static/ et peut, optionnellement, servir de serveur web.

La façon la plus simple de prévisualiser vos modifications est donc de :

npm install # installer les dépendances
LISTEN=3000 node render.js # effectuer le rendu puis démarrer un serveur web sur le port 3000

Votre aperçu est alors disponible à cette URL : http://127.0.0.1:3000

À chaque modification, vous pouvez arrêter la dernière commande (CTRL+C) et la relancer pour forcer le rendu.

Comment le site est mis à jour depuis ce dépôt ?

Nous sommes actuellement dans une phase de transition sur ce point. Veuillez contacter un·e des maintainers. Si vous êtes maintainer ou curieux·se, vous pouvez vous réferrer au fichier DEPLOY.md