Sud Web 2016

Site internet du cycle de conférences annuel Sud Web, dont la 6e édition aura lieu à Bordeaux les 27 et 28 mai 2016.

http://sudweb.fr/2016

Pré-requis

Le site est généré à l'aide de Jekyll et nécessite Ruby 2.1.x (voir .ruby-version)

Nous vous recommandons de gérer l'installation de Ruby via rbenv.

Sous Mac OS X, vous pouvez utiliser Homebrew pour cela

$ brew install rbenv ruby-build

Sous Ubuntu, certaines librairies sont nécessaires :

sudo apt-get install -y libreadline-dev build-essential

Puis pour rbenv et ruby-build, préférer une installation par git :

$ git clone https://github.com/rbenv/rbenv.git ~/.rbenv
$ cd ~/.rbenv && src/configure && make -C src
$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
$ git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

Installation

Si vous n'avez pas déjà cloné le dépot :

$ git clone https://github.com/sudweb/2016.git 2016 && cd 2016

Si bundler n'est pas installé

$ gem install bundler

Pour installer toutes les dépendances du projet :

$ bundle install

Pour installer la bonne version de Ruby

$ rbenv install

Travailler en local

Pour travailler sur le site et surveiller les modifications :

$ bundle exec foreman start

ou

$ bundle exec jekyll serve

Si vous modifiez le fichier _config.yml, il faut relancer le build

$ bundle exec jekyll build

Le site est maintenant accessible en local à l'adresse http://127.0.0.1:4000/2016/

Pour plus d'information sur l'utilisation de Jekyll, reportez-vous à la documentation officielle.

Styleguide et notes d'intégration

• Styleguide
• Notes d'intégration de @Twikito

Contribution

Pour toute demande, merci de créer une issue sur GitHub.

Si vous souhaitez nous aider, vous pouvez copier le dépôt, faire vos modifications dans une nouvelle branche et faire une demande de fusion.

Toute modification doit faire l'objet d'une pull request et doit passer les tests avant de pouvoir être fusionnée.

Tests

Avant de soumettre votre pull request, lancez le script de test d'intégration continue :

$ script/cibuild
Running ["ScriptCheck", "LinkCheck", "ImageCheck"] on ./_site on *.html...

HTML-Proofer finished successfully.

Licence

Ce code est publié sous licence MIT.