Les pages professionnelles de l’IMB

Cela permet de créer facilement des pages web grâce au générateur de site Hugo. Les pages sont écrites au format Markdown.

Tout se passe dans le dossier ~/public_html/pagepro_hugo

1) Configuration

le dossier config contient les elements de configuration de votre site. Le fichier config/_default/config.yaml ne peut pas être modifié. Il contient des configurations pour le bon fonctionnement de vos pages pro, vous n’avez pas besoin le modifier.

- Parametres

Le fichier config/_default/params.yaml contient deux éléments :

  • photo doit contenir l’URL de votre photo
  • idhal correspond à votre identifiant HAL (permet de générer automatiquement la liste des publications)

- Langue

Vous pouvez ajouter des langues pour vos pages en éditant le fichier config/_default/languages.yaml, par exemple :

fr:
  languageName: Français 
  contentDir: content/fr
en:
  languageName: English 
  contentDir: content/en
  • languageName correspond au nom de la langue qui sera affichée dans le selecteur de langue.
  • contentDir correspond à l’emplacement des pages dans la langue concernée

2) Contenu

Pour ajouter du contenu à votre site, allez dans le dossier content. Pour chaque langue de votre site web définie dans le fichier config/_default/languages.yaml, vous devez créer un dossier correspondant, par exemple content/fr.

- Page d’accueil

Le fichier _index.md correspond à la page d’accueil de votre site web. Les fichiers _index.md de chaque langue doivent posséder l’entête suivant :

---
title: Home
---
  • title correspond au nom de la page, qui sera afficher dans le menu.

- Ecriture des pages

Chaque page correspond à un fichier MarkDown du dossier content/<langue>. Le fichier doit avoir l’extension .md, par exemple enseignements.md. Tous les fichiers doivent posséder un entête de la forme suivante :

---
title: Teachings (e.g.)
menu: main
---
  • title correspond au nom de la page, qui sera afficher dans le menu.
  • menu doit avoir la valeur main si vous voulez que la page actuelle soit affichée dans le menu.

Pour simplifier la création de nouvelle page, vous pouvez utiliser la commande suivante depuis un diskless ou le serveur servisu/bureau :

pagepro new content/fr/ma-page.md

- Page de publication

Pour obtenir une page avec une génération automatique de vos publications sur HAL, vous devez créer un fichier content/fr/publications.md contenant l’entête suivant :

---
title: Publications 
layout: hal
menu: main
---

Vous devez également renseigner votre identifiant HAL (idhal) dans le fichier config/_default/params.yaml.

- Fichier statique

Si vous souhaitez ajouter des fichiers (images, pdf, etc), vous devez les placer dans le dossier static. Ces fichiers seront directement accessibles avec l’URL https://www.math.u-bordeaux.fr/~<votre_login>/<mon_fichier>. Par exemple, pour un fichier image.png, l’URL sera : https://www.math.u-bordeaux.fr/~<votre_login>/image.png

3) Tester et modifier son site

Pour avoir un aperçu de son site avant de le publier, depuis un diskless ou le serveur servisu/bureau, vous pouvez utiliser la commande pagepro server. Un aperçu du site est maintenant disponible à l’adresse http://localhost:1313/~<votre_login>/.

Vous pouvez éditer vos fichiers markdown et les modifications seront automatiquement prises en compte.

4) Publier son site

Pour publier votre site web, depuis un diskless ou le serveur servisu/bureau, vous pouvez utiliser la commande pagepro. Votre site est disponible à l’adresse https://www.math.u-bordeaux.fr/~prenom.nom.

ATTENTION : si vous possédiez déjà un site HUGO, cette commande va écraser les fichiers existants.