nicopennec / breizhcamp-website

Source du site Web du BreizhCamp

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.

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

Développement

A 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. Etant donné 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 à jours 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 TOCKEN 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é 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 merges 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/