Publier sur math.unistra.fr avec GitLab Pages

À partir de projets hébergés sur https://gitlab.math.unistra.fr, GitLab Pages permet de :

• publier un site web statique : avec un générateur comme Jekyll, on peut créer des sites statiques modernes en responsive design (adaptés aux smartphones et tablettes). Un exemple avec ce site qui est construit avec Jekyll.
• mettre en ligne des pdf d'articles de livres, de cours, d'énoncé d'exercices, etc., construits à partir de sources Tex, par exemple.

Par rapport à la publication sur une page perso, Pages présente les deux avantages ci-dessous.

1) Publier sur une URL en math.unistra.fr

Pages permet de publier sur une URL qui contient un nom de projet ou d'équipe et ce, sans intervention de la part des administrateurs et sans avoir besoin de créer un serveur web dédié. Pour le projet GitLab projectname qui appartient à username ou groupname, l'adresse de publication sera :

https://[username|groupname].pages.math.unistra.fr/[projectname]

projectname est absent de l'URL s'il vaut [username|groupname].pages.math.unistra.fr

• Exemple 1 : Vincent et Matthieu publient avec GitLab Pages le mini site https://formation-python.pages.math.unistra.fr dont les sources sont hébergées sur ce dépôt.
• Exemple 2 : la page actuelle qui est publiée avec GitLab Pages depuis ce dépôt public.

2) Faire de l'édition collaborative

Pages permet de publier un contenu édité de manière collaborative grâce à GitLab en utilisant Git pour enregistrer et fusionner les différentes contributions.

• Exemple 3 : Pour ceux qui se souviennent de l'exposé GitLab et du tutoriel vidéo correspondant, il suffit d'ajouter une petite étape à la démonstration pour publier l'exemple LaTeX à l'adresse https://formation-info.pages.math.unistra.fr/expose-git-example/methodus-inveniendi-addII.pdf.

Chaque modification de la branche de publication du dépôt déclenche la mise à jour du site. Ainsi, dans l'exemple 1, lorsque Vincent ou Matthieu poussent leurs modifications sur la branche master du dépôt GitLab, le site https://formation-python.pages.math.unistra.fr est automatiquement mis à jour.

Documentation et support

Pour publier avec Pages, nous vous conseillons de suivre la documentation en ligne (remplacez les mentions à example.io par pages.math.unistra.fr).

Nous allons également proposer un atelier de prise en main de Git, GitLab et Pages. Si vous êtes intéressés, faites-le-nous savoir par mail à en précisant le niveau de support dont vous auriez besoin sur chacune des 3 parties et l'usage que vous pensez en faire. Pour ceux qui utilisent déjà GitLab, nous pouvons vous aider au cas par cas pour publier vos projets avec Pages.

Rappel : Toutes les publications dans le domaine math.unistra.fr sont soumises aux mêmes règles que les pages personnelles hébergées sur http://irma.math.unistra.fr. Elles doivent en particulier respecter la charte informatique de l'Unistra.

Version du 17 mars 2017