Compte Gitlab
Il faut tout d’abord disposer d’un compte Gitlab sur une instance proposant les Gitlab Pages.
Si vous n’en avez pas, je vous conseille de vous créer un compte sur Framagit, mais https://gitlab.com fonctionnera aussi.
Dans notre exemple, nous utiliserons un utilisateur nommé « test-last » sur Framagit.
Se créer un compte
- allez sur https://framagit.org ;
- cliquez sur « Sign in » ;
- cliquez sur l’onglet « Register » ;
- remplissez les champs ;
- cliquez sur le bouton « Register ».
Confirmer le compte
- vous recevrez alors un mail contenant un lien sur lequel il vous faudra cliquer (ce lien est copié/collé dans la vidéo) ;
- vous pourrez alors vous authentifier avec le pseudonyme et le mot de passe choisis précédemment.
Forker et configurer Last
NB : si vous n’utilisez pas Framagit, vous ne pourrez pas le forker, il vous faudra le cloner et l’envoyer sur votre dépôt Gitlab.
- rendez-vous sur https://framagit.org/luc/last ;
- cliquez sur « fork » ;
- choisissez votre utilisateur pour héberger le fork ;
- cliquez sur « Settings » pour modifier les paramètres de votre dépôt ;
- cliquez sur « Pipelines » ;
- cliquez sur « Enable shared runners » : cela vous permettra de créer vos Gitlab pages ;
- cliquez sur « Repository » pour explorer le code de Last ;
- cliquez sur « last.conf » pour visualiser ce fichier ;
- cliquez sur « Edit » pour le modifier ;
last.conf
est le seul fichier que vous aurez besoin de modifier pour ajouter des pouets à Last. Voici un guide pour les paramètres contenus dans ce fichier :
author
- Le nom de l’auteur… vous !
title
- Le titre que vous souhaitez donner à votre page.
language
- Le code de la langue de votre page : « fr », « en », « de », etc.
sort
- Faut-il trier les pouets de la liste avant de les importer ? Ce tri est effectué de façon alpha-numérique. Une valeur de « 0 » équivaut à « pas de tri » (les pouets seront importés dans l’ordre de la liste), une valeur de « 1 » activera le tri.
reverse
- Faut-il inverser les pouets ? (après le tri si celui-ci est activé)
public_url
- L’adresse de votre Gitlab Page. Sur Framagit, elle sera de la forme https://pseudonyme.frama.io/last.
theme
- Le nom du thème à utiliser. Copiez le dossier « default » du dossier « themes » sous un autre nom et créez un nouveau thème !
pagination
- Faut-il paginer les pouets ou tout afficher sur une seule page (comportement par défaut) ? Choisissez un nombre plus grand que 0, ce sera le nombre de pouets par page.
licence
- Indiquez la license de vos pouets. Si vous choisissez une des licenses libres proposées (cc-0, cc-by-nc-nd, cc-by-nc-sa, cc-by-nd, cc-by, cc-by-sa.png public-domain), un badge de la license sera affiché. Vous pouvez utiliser le droit d’auteur classique en ne choisissant rien ou en commentant ce paramètre avec un « # ».
urls
- Le plus important : la liste des adresses web des pouets à importer ! Saisissez-les comme dans l’exemple, séparés par une virgule
hidden_tags
- Liste des mots-croisillons (hashtags) à supprimer de vos pouets, à saisir de la même façon que les adresses web des pouets (il vous faudra enlever les « # » pour que la liste soit prise en compte).
- modifiez à l’envie le champ « Commit message » puis cliquez sur « Commit changes » pour enregistrer vos modifications ;
- vous pouvez voir l’avancement de la construction de votre page en allant dans l’onglet « Pipelines » ;
- une fois que c’est fini, vous pouvez admirer votre page en allant sur https://votre_pseudonyme.frama.io/last.
Changer l’adresse de votre page
- cliquez sur « Settings » ;
- descendez jusqu’à « Rename repository » ;
- modifiez le champ « Path » pour changer le répertoire auquel votre page sera accessible (le champ « Project name » n’est pas à modifier mais cela vous permettra de ne pas vous emmêler les pinceaux entre le nom du projet et son adresse) ;
- cliquez sur « Rename project » ;
- votre page est maintenant accessible à l’adresse https://votre_pseudonyme.frama.io/nouveau_nom.
Rendre votre page accessible à la racine de vos Gitlab Pages
- cliquez sur « Settings » ;
- descendez jusqu’à « Rename repository » ;
- modifiez le champ « Path » pour « votre_pseudonyme.frama.io » ;
- cliquez sur « Rename project » ;
- votre page est maintenant accessible à l’adresse https://votre_pseudonyme.frama.io/ !