Un générateur de site statique qui casse des briques. VenC est tellement rapide qu'il enfreint le principe de causalité et produit de l'énergie surunitaire !
|
Un générateur de site statique qui casse des briques. VenC est tellement rapide qu'il enfreint le principe de causalité et produit de l'énergie surunitaire ! |
De façon similaire aux archives, il faut que dans votre fichier de configuration
l'option disable_categories soit configurée correctement.
Il y a plusieurs façons d'afficher les catégories de votre blog :
Nous verrons les deux cas.
Pour commencer, nous allons préparer le terrain pour que le thème soit modulable par les utilisateurs finaux.
Entre les balises header que vous avez ajoutées dans le chapitre
3.5.2.1, ajoutez maintenant le code suivant :
.:IfBlogMetadataIsTrue::disable_categories::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
::
<!-- Bloc HTML à conserver si la variable vaut `false` -->
:.
À l'aide du motif IfBlogMetadataIsTrue,
on teste si les pages des catégories doivent être créées par VenC. On peut aller plus loin, en demandant à VenC
de conserver ou non des blocs de codes de façon plus précise, de la façon suivante :
.:IfBlogMetadataIsTrue::disable_categories::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
::
.:IfBlogMetadataIsTrue::display_categories_as_list::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
:.
.:IfBlogMetadataIsTrue::display_categories_as_tree::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
:.
:.
On utilise à nouveau IfBlogMetadataIsTrue pour tester
les variables suivantes (à noter que ce ne sont pas des options réservées par VenC, vous pouvez donc définir les vôtres si vous
le souhaitez) :
display_categories_as_treedisplay_categories_as_listCe faisant, vous pourrez contrôler depuis votre fichier de configuration quels types d'affichage vous souhaitez pour vos catégories ! Malin !
On arrive maintenant au gros morceau : l'affichage de la liste des catégories !
C'est le cas le plus simple. Nous allons pour ce faire utiliser
GetFlattenedBlogCategories.
Par exemple :
<ul id="blogcategorieslist"> .:GetFlattenedBlogCategories:: <li class="blogcategoriesitem"> <a href="{path}" title="{value} ({count})">{value}</a> </li> :: :. </ul>
Ici, on définit une liste avec la balise HTML ul. On y insère le motif VenC
GetFlattenedBlogCategories.
qui va générer itérativement les items de la liste. Nous y écrivons donc en premier argument dudit motif
le couple de balise li, qui correspond à l'item courant de la liste.
Enfin, les variables du motif permettent de récupérer respectivement :
Il n'y a plus qu'à insérer tout ça dans le code que nous avons préparé dans la balise header :
.:IfBlogMetadataIsTrue::disable_categories::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
::
.:IfBlogMetadataIsTrue::display_categories_as_list::
<ul id="blogcategorieslist">
.:GetFlattenedBlogCategories::
<li class="blogcategoriesitem">
<a href="{path}" title="{value} ({count})">{value}</a>
</li>
::
:.
</ul>
:.
.:IfBlogMetadataIsTrue::display_categories_as_tree::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
:.
:.
Cet affichage est un peu plus complexe et ne se prête pas à toutes les mises en page, mais il a le mérite de rendre plus clair l'organisation de votre site.
L'idée de l'affichage en arbre de catégories, c'est de mettre en évidence le fait que plusieurs sous-catégories peuvent appartenir à une catégorie parente.
Par exemple, si votre blog parle de science et d'art, vous aurez donc deux catégories de base. Pour avoir plus de granularité sur l'organisation de vos publications, vous pouvez indiquer à VenC qu'une publication traite aussi de peinture ou de littérature. Deux sous-catégories de la catégorie "Art". Et bien sûr, il n'y a pas de limite dans l'imbrication de catégories, ce qui vous laisse beaucoup de latitude pour trier vos publications.
Pour savoir comment définir des catégories dans une publication, rendez-vous ici.
Pour afficher un arbre hiérarchique de catégories, on utilise le motif
VenC GetBlogCategoriesTree.
La documentation technique propose l'exemple suivant, qui convient tout à fait
à la majorité des cas de figure :
.:GetBlogCategoriesTree::
<ul>::
<li><a href="{path}" title="{count} publications">{value}</a>::
{childs}</li>::
</ul>
:.
Ce motif fonctionne différemment de
GetFlattenedBlogCategories. En effet, il faut indiquer à la fonction :
On remarque également que comme pour GetFlattenedBlogCategories,
on peut utiliser les variables path, count et value.
Enfin, un autre élément est requis pour créer une structure récursive de catégories : c'est la
variable childs, qui contient le nœud enfant. Si vous oubliez de placer cette variable dans les arguments 2 ou 3, le résultat
de l'appel du motif ne sera pas celui attendu.
Avec ça on est bon et on peut maintenant placer notre code dans celui que nous avons préparé dans la balise header de notre entête HTML :
.:IfBlogMetadataIsTrue::disable_categories::
<!-- Bloc HTML à conserver si la variable vaut `true` -->
::
.:IfBlogMetadataIsTrue::display_categories_as_list::
<ul id="blogcategorieslist">
.:GetFlattenedBlogCategories::
<li class="blogcategoriesitem">
<a href="{path}" title="{value} ({count})">{value}</a>
</li>
::
:.
</ul>
:.
.:IfBlogMetadataIsTrue::display_categories_as_tree::
.:GetBlogCategoriesTree::
<ul>::
<li><a href="{path}" title="{count} publications">{value}</a>::
{childs}</li>::
</ul>
:.
:.
:.
Et voilà, c'est tout bon pour les catégories ! Si cependant vous voulez aller plus loin, avec un contrôle plus fin de l'affichage et utiliser les fonctions avancées de taxonomie vous pouvez également jeter un œil à ces fonctions :