SudWeb 2023

TL;DR

# Récupérer les sources du projet :
git clone https://github.com/sudweb/2023.git sudweb-2023
cd sudweb-2023

# S'assurer d'avoir la bonne version de node :
nvm use

# Installer les dépendances :
npm ci

Générer le site static

npm run build

Mode développement, sans les fonctions

npm start

Mode développement, avec les fonctions

Nécessite d'avoir accès et d'être identifié au compte sur Netlify

# Installer globalement le client Netlify :
npm i -g netlify-cli

netlify develop

Plus en détails

1. S'assurer d'être en node 18
   (sinon utiliser nvm pour gérer différentes version, et passer sur la 18)
2. Ne jamais utiliser npm i/npm install pour autre chose qu'ajouter un nouvelle dépendance. Quand on veut installer les dépendances déjà déclarées, utiliser npm ci.
3. Ajouter l'option --legacy-peer-deps (et non -force) car certaines dépendances sont un peu à la traîne.
4. npm run build permet de générer l'ensemble du site statique dans le dossier /public ensuite npm run serve permet de le servir sur localhost:9000
5. Pour le mode de développement (rafraîchissements automatiques), il faut lancer npm start ou bien npm run develop et le mode dev se lance sur localhost:8000. Tout devrait fonctionner sauf l'envoi des formulaires.
6. Pour que les formulaires fonctionnent :
   • Il faut installer globalement netlify-cli → npm i -g netlify-cli,
   • Avoir les variables d'environnement avec les bons tokens (soit en identifiant netlify-cli avec netlify login qui récupérera les variables en ligne, soit en fournissant directement à l'environnement)
   • Lancer le mode dev avec netlify dev qui va lancer le Gatsby lui même, et nous servir ça sur localhost:8888, et là, même l'envoi des formulaires sera fonctionnel.
7. Pousser sur la branche main du dépôt déploie automatiquement l’environnement de production (en environ 1 minute)

Contribuer

Intervenant·es et conférences

Pour chaque conférence, lightning talk, ou atelier :

• Créer un fichier le-titre-sans-accent-ni-espace.md dans le dossier src/events/.
• Insérer un bloc de frontmatter tel que :

  title: Le titre tel qu'il sera affiché sur le site
  type: conference
  authors: []

  • type peut être conference, lt ou atelier
  • authors est un tableau, vide dans un premier temps, mais dans lequel on mettra ensuite le nom du fichier speaker (sans le .md)
• Après le bloc de frontmatter insérer la description de la conférence/LT/atelier en markdown.

Pour chaque intervenant·es :

• Créer un fichier nom-sans-accent-ni-espace.md dans le dossier src/speakers/.
• Insérer un bloc de frontmatter tel que :

  name: Nom tel qu'il sera affiché

• Après le bloc de frontmatter insérer la bio de la personne en markdown.
• Dans le ou les évènements présentés par cette personne, insérer le nom du fichier (sans le .md) dans le tableau authors.
• Dans le même dossier placer une image portant le même nom que le fichier markdown, mais avec l'extension .png ou .jpg. Cette image doit être au format carré et si possible optimisée/réduite (par exemple via squoosh.app). Inutile de mettre une image de plus de 512px de côté.