Réglages et personnalisation du site
- 1. Réglages YAML
- 2. Les valeurs de “Status”
- 3. Fichiers personnalisables
- 4. Intégration d'une galerie d'images
- 5. Personnalisations effectuées sur ce site
- 5.1. Ajout d'extensions
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.