LoOPS

Contribuer au site web

Comment est construit le site ?

Ce site web est hébergé sur github. Il est développé avec Jekyll, un générateur de sites web et blogs.

La modification du site web se fait en modifiant ses sources, gérées sous git dans ce dépôt. A la suite du push des modifications vers le dépôt, jekyll est automatiquement lancé sur github pour mettre à jour le site d'après les nouvelles sources. Plus d'informations ici.

Comment contribuer ?

La façon la plus simple de contribuer est de

  1. se créer un compte sur github,
  2. faire un fork du dépôt du site à partir de l'interface github,
  3. faire ses modifications et tester sur sa machine (cf. ci-dessous) puis les pousser dans son dépôt "forké",
  4. faire un "pull request" sur github pour soumettre des modifications à répercuter sur le dépôt du site.

Les billets du blog sont les fichiers du répertoire _posts/. Lorsqu'on ajoute une page pour une journée ou un autre événement, il faut également ajouter un billet pour l'annoncer. Le fichier du billet commence par des champs spéciaux, qui permettent par exemple de mettre à jour le calendrier au format ical disponible sur le site. Voici un exemple d'entête de fichier : 

---
layout: post
title: JupyterDay
ev_link: https://reseau-loops.github.io/journee_2016_12_jupyter.html
ev_keywords:
  - jupyter
  - python
ev_startDate: Tue, 6 December 2016 9:15:00 +0200
ev_endDate: Tue, 6 December 2016 17:30:00 +0200
---

Tester sur sa machine

Paquets à installer sur une debian (stretch) pour pouvoir tester en local:

Installation de jekyll: 

gem install jekyll

Compilation du site pour test en local:

cd /chemin/vers/votre/depôt/local/reseau-loops.github.com
make
Le site est alors consultable dans _site/

Tester sur sa machine avec Docker

Vous trouverez dans le sous-répertoire `docker` un fichier `README.md` expliquant la construction et l'utilisation d'une image Docker pour tester votre version modifiée du site web. Au préalable, vous devez avoir installé Docker sur votre machine.

Liens