Réglages et personnalisation du site

Réglages YAML

Les réglages suivants peuvent être effectués dans l'entête YAML de chaque page :

Title = intitulé de la page (utilisé pour la navigation interne)
TitleContent = intitulé de la page affiché en tête de contenu (niveau h1)
TitleNavigation = intitulé de la page affiché dans le menu
TitleHeader = intitulé de la page affiché dans l'onglet ou la fenêtre de navigation
TitleSlug = intitulé de page utilisée pour sa sauvegarde
Description = description de la page
Author = auteur(s), séparés par une virgule
Email = email de l'auteur de la page
Layout = page layout
LayoutNew = page layout for creating a new page
Theme = thème utilisé pour la page (si différent du thème du site)
Language = langage de la page (utilisé pour la valeur de lang="")
Parser = “parser” (interpréteur) de la page
Status = statut de la page, supporte plusieurs valeurs (voir ci-dessous)
Redirect = redirection vers une autre page ou vers une URL
Image = image de la page
ImageAlt = description de l'image de la page
Modified = modification de la date de la page, format YYYY-MM-DD
Published = date de publication de la page, format YYYY-MM-DD
Tag = tag(s) pour la catégorisation de la page, séparés par une virgule
Build = options de page pour la génération d'un site statique, séparés par une virgule
Comment = options de page pour afficher des commentaires, séparés par une virgule

Les valeurs de “Status”

Les valeurs suivantes sont attribuables à la ligne “Status”, dans l'entête YALM :

public = page normale
private = page invisible, l'utilisateur doit entrer un mot de passe, nécessite l'extension “private”
unlisted = page invisible, mais accessible via le lien approprié
shared = page invisible, mais incluse en tant que section dans une autre page
draft = page invisible, l'utilisateur doit se connecter en mode édition pour y accéder, nécessite l'extension “draft”

Fichiers personnalisables

Les fichiers suivants peuvent être personnalisés :

content/1-home/page.md = contenu de la page d'accueil
content/shared/page-error-404.md = contenu de la page d'erreur
system/layouts/default.html = gabarit par défaut de toute nouvelle page
system/layouts/error.html = gabarit HTML de la page d'erreur
system/layouts/header.html = gabarit HTML par défaut du header
system/layouts/footer.html = gabarit HTML par défaut du footer
system/layouts/navigation.html = gabarit HTML par défaut du menu principal de navigation
system/layouts/pagination.html = gabarit HTML par défaut de la pagination

S’ils ont été créés, les fichiers suivant sont également personnalisables :

content/n-nomdepage/page.md = contenu d'une page du site (n est le rang dans le menu)
content/shared/header.md = contenu du header
content/shared/footer.md = contenu du footer

Intégration d'une galerie d'images

Pour réaliser cette galerie, le fichier .zip de l'extension “gallery” a été placé (sans le décompresser) dans le dossier system/extensions. Les images ont été placées dans le dossier media/images/slides. La galerie est ensuite intégrée avec un code court (shortcode). Ici le code cout utilisé est : [gallery slides.*jpg name zoom 200].

Personnalisations effectuées sur ce site

L'image du header a été paramétrée pour s'afficher à 100% avec une hauteur automatique. Pour cela, la rubrique /* header */ du fichier system/themes/stockholm.css a été complétée.

La mention Language: fr a été rajoutée dans l'entête YAML de toutes les pages du site, ainsi qu'une description.

Les fichiers permettant la traduction du site en français ont été revus pour corriger plusieurs fautes d'orthographe et un certain nombre de fautes typographiques (en particulier l'espace avant les 2 points). Il s'agit des fichiers workers/french.php et extensions/yellow-language.ini.

La stylisation de la classebtn (bouton) a été adaptée à l'apparence du site.

Ajout d'extensions

Les extensions suivantes ont été installées pour augmenter les fonctionnalités du site :

toc (Table Of Content) pour ajouter un sommaire en tête de certaines pages du site.
gallery pour ajouter une galerie de photos.
slider pour afficher un diaporama.

Activer le mode “Édition”