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.
 
 
 
 
Quentin 91d10a7eb3
Update matrix server
1 month ago
src Update matrix server 1 month ago
.drone.yml Merge CI fix to not deploy on PR 1 year ago
.gitignore Migrate to garage 2 years ago
DEPLOY.md Add a deploy doc 2 years ago
LICENSE Initial commit 3 years ago
README.md Update CI badge to point to main 2 years ago
deploy Deploy Thunderbird conf 2 years ago
package-lock.json Updates CHATONS site web 5 months ago
package.json Ajout de la liste des sources 5 months ago
render.js Update render 2 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