Site Web BreizhCamp

Ce site Web est généré avec Hugo, A Fast and Modern Static Website Engine. La rapidité de génération est une des raisons du choix de cet excellent outil. Ce site est généré en quelques dizaines de millisecondes !

La majorité des contenus est écrit en Markdown ou sous forme de fichiers structurés YAML. Il est facile d'y contribuer directement depuis l'interface de GitHub.

Ami·es du BreizhCamp, n'hésitez pas à proposer des PR si vous voulez améliorer ce site!

Développement

À la racine se trouve un wrapper pour lancer Hugo, qui se chargera de télécharger le binaire Hugo s'il n'est pas disponible. Pour lancer localement le site:

./hugow -w serve

puis accéder à http://localhost:1313. Hugo activera le rechargement automatique des pages modifiées. Étant donnée la vitesse de génération, les modifications effectuées dans les sources sont visibles en quasi-temps réel dans le navigateur Web.

Passage à une nouvelle édition du BreizhCamp

Voir la documentation sur le wiki du BreizhCamp

Mise à jour des données

Liste des speakers

1. Dans le fichier bin/getSpeakers.groovy, remplacer __TODO_TOKEN__ par votre token d'authentification. NE FAITES PAS UN COMMIT DE CE FICHIER AVEC VOTRE TOKEN DEDANS !
2. Lancer le script bin/update-json-speakers.sh
3. Faire un commit du fichier data/speakers.json

Le fichier static/json/speakers_others.json est réservé aux speakers "hors-CFP" (Keynotes...)

Liste des talks du programme

Si vous utilisez la méthode de récupération static pour récupérer les talks du programme, il faut mettre à jour le fichier static/json/talks.json :

1. Lancer le script bin/update-json-talks.sh
2. Faire un commit du fichier static/json/talks.json

Le fichier static/json/talks_others.json est réservé aux talks "hors-CFP" (Meet'n Greet, Keynotes...)

Actions classiques

Ouverture/Fermeture du CFP

1. Fichier config.toml : Ajouter/décommenter/commenter l'item de menu (bandeau) avec icône ouvert/fermé et l'URL du CFP

   [[params.menu]]
       name = "CFP"
       url  = "https://sessionize.com/breizhcamp-2022/"
       target = "_blank"
       image= "/img/cfp-icon-64.png"
       label= '<span class="label label-success">Ouvert</span>'
   #    label= '<i class="note fa fa-times-circle text-muted" title="Clos"></i>'
       weight = 1

2. Fichier content/conference/cfp.md, mettre à jour l'URL du CFP

Ouverture/Fermeture de la billeterie

1. Fichier config.toml : Ajouter/décommenter/commenter l'item de menu (bandeau) avec icône ouvert/fermé et l'URL du CFP

   [[params.menu]]
       name = "Billets"
       url  = "https://docs.google.com/forms/d/e/1FAIpQLSc3CbFbwKtGOCX7tbU4pXPg6LOOEB9xbp5LCpgfVlNiqFy8hg/viewform"
       target = "_blank"
       label= '<i class="note fa fa-check-circle text-success" title="Billetterie avec tirage au sort : inscriptions ouvertes"></i>'
       #    label= '<i class="note fa fa-times-circle text-muted" title="Billetterie avec tirage au sort : inscriptions closes"></i>'
       weight = 1

2. Fichier content/faq/_index.md, mettre à jour l'URL et les dates d'ouvertures du tirage au sort billeterie

   # Comment acheter un billet ?
   
   ...
   Si vous êtes intéressé·e pour venir au BreizhCamp cette année, inscrivez-vous au tirage au sort via
   [ce formulaire](https://docs.google.com/forms/d/e/1FAIpQLSc3CbFbwKtGOCX7tbU4pXPg6LOOEB9xbp5LCpgfVlNiqFy8hg/viewform)
   avant le **31 mai minuit**.

Configuration

Récupération des talks pour le programme

Fichier config.toml, section params.breizhcamp, paramètre programme_get_talks_method :

• "cfp_api" : récupération via l'API du CFP
• "static" : récupération via le fichier static/json/talks.json (pensez à mettre à jour ce fichier !)

Récupération des speakers

Fichier config.toml, section params.breizhcamp, paramètre programme_get_speakers_method :

• "cfp_api" : récupération via l'API du CFP
• "static" : récupération via le fichier static/json/speakers.json (pensez à mettre à jour ce fichier !)

Organisation des branches

Ce dépot possède 2 branches, staging et production. La branche production doit être alimentée par des merge requests depuis la branche staging.

Déploiement

Netlify permet de déployer automatiquement les branches principales de ce dépôt:

• la branche staging est déployée sur http://staging.breizhcamp.org
• la branche production est déployée sur http://www.breizhcamp.org

Dévelopment Web et Hugo

Quelques liens pour les non-professionels du CSS et de Hugo

• http://cssreference.io/