Pour personnaliser ou modifier l'apparence ou l'organisation du site web, il faut modifier les squelettes du module "Site web".

Pour cela, il est conseillé d'avoir déjà quelques bases dans les langages HTML et CSS.

Les squelettes du site web

Les squelettes sont un ensemble de fichiers qui permettent de modéliser l'apparence du site web selon ses préférences et besoins.

La syntaxe utilisée dans les squelettes s'appelle Brindille. Voir la documentation de Brindille pour son fonctionnement.

Exemples de sites réalisés avec Paheko

• Faidherbe Alumni
• ASBM Mortagne
• Vélocité 63
• La rustine, Dijon
• Tauto école (les squelettes sont disponibles ici)
• La boîte à vélos

Fonctionnement des squelettes

Par défaut sont fournis plusieurs squelettes qui permettent d'avoir un site web basique mais fonctionnel : page d'accueil, menu avec les catégories de premier niveau, et pour afficher les pages, les catégories, les fichiers joints et images. Il y a également un squelette atom.xml permettant aux visiteurs d'accéder aux dernières pages publiées.

Les squelettes peuvent être modifiés via l'onglet Configuration de la section Site web du menu principal.

Une fois un squelette modifié, il apparaît dans la liste comme étant modifié, sinon il apparaît comme défaut. Si vous avez commis une erreur, il est possible de restaurer le squelette d'origine.

Adresses des pages du site

Les squelettes sont appelés en fonction des règles suivantes (dans l'ordre) :

Squelette appelé	Cas où le squelette est appelé
adresse	Si l'adresse adresse est appelée, et qu'un squelette du même nom existe
adresse/index.html	Si l'adresse adresse/ est appelée, et qu'un squelette index.html dans le répertoire du même nom existe
category.html	Toute autre adresse se terminant par un slash /, si une catégorie du même nom existe
article.html	Toute autre adresse, si une page du même nom existe
404.html	Si aucune règle précédente n'a fonctionné

Ainsi l'adresse https://monsite.paheko.cloud/Actualite/ appellera le squelette category.html, mais l'adresse https://monsite.paheko.cloud/Actualite (sans slash à la fin) appellera le squelette article.html si un article avec l'URI Actualite existe. Si un squelette Actualite (sans extension) existe, c'est lui qui sera appelé en priorité et ni category.html ni article.html ne seront appelés.

Autre exemple : https://monsite.paheko.cloud/atom.xml appellera le squelette atom.xml s'il existe.

Ceci vous permet de créer de nouvelles pages dynamiques sur le site, par exemple pour notre atelier vélo nous avons une page https://larustine.org/velos qui appelle le squelette velos (sans extension), qui va afficher la liste des vélos actuellement en stock dans notre hangar.

Le type de fichier étant déterminé selon l'extension (.html, .css, etc.) pour les fichiers traités par Brindille, un fichier sans extension sera considéré comme un fichier texte par le navigateur. Si on veut que le squelette velos (sans extension) s'affiche comme du HTML il faut forcer le type en mettant le code {{:http type="text/html"}} au début du squelette (première ligne).

Note : les squelettes dont le nom commence par un tiret bas (underscore, exemple : _documents.html) ne peuvent être affichés directement en appelant leur adresse URL, ils ne peuvent qu'être inclus par un un autre squelette.

Fichier content.css

Ce fichier est particulier, car il définit le style du contenu des pages et des catégories.

Ainsi il est également utilisé quand vous éditez un contenu dans l'administration. Donc si vous souhaitez modifier le style d'un élément du texte, il vaux mieux modifier ce fichier, sinon le rendu sera différent entre l'administration et le site public.

Cache

Depuis la version 1.3, Paheko dispose d'un cache statique du site web.

Cela veut dire que les pages du site web sont enregistrées sous la forme de fichiers HTML statiques, et le serveur web renvoie directement ce fichier sans faire appel à Paheko et son code PHP.

Les fichiers liés aux pages web sont également mis en cache de cette manière, en utilisant des liens symboliques.

Ce cache permet d'avoir un site web très rapide, même s'il reçoit des millions de visites.

Désactiver le cache

Le seul inconvénient c'est qu'une page mise en cache étant statique, si vous utilisez du contenu dynamique (par exemple afficher un texte différent selon la langue du visiteur) dans le squelette Brindille, alors cela ne fonctionnera plus.

Dans ce cas-là, vous pouvez assigner la variable nocache dans le squelette pour désactiver le cache pour cette page :

{{:assign nocache=true}}

Pour permettre des usages du type "affichage en temps presque réel des horaires d'ouverture", le cache d'une page HTML est effacé et remis à jour au bout d'une heure.

Exceptions

Il est à noter que le cache n'est pas appelé dans les cas suivants :

• si la requête vers la page est d'un autre type que GET ou HEAD, ainsi par exemple l'envoi d'un formulaire (POST) ne sera jamais mis en cache ;
• si la requête vers la page contient des paramètres dans l'adresse (par exemple velos.html?list=1 : cette page ne sera pas mise en cache) ;
• si le visiteur est connecté à l'administration de l'association. Ainsi si vous avez des parties du squelette qui varient en fonction de si la personne est connectée, le cache ne posera pas de problème.

Le cache est intégralement effacé à chaque modification du site web.

Le cache ne concerne que les pages et fichiers du site web public. Il ne concerne pas les modules, les extensions, ou l'administration.

Attention :

• avec un serveur sous Windows, le cache est désactivé car Windows ne sait pas gérer les liens symboliques ;
• seul Apache sait gérer le cache statique, le cache est désactivé avec les autres serveurs web (nginx, etc.).

(Cette page est une copie de la documentation inclue dans Paheko, et est valide pour la version 1.3.12.)