Publié le : 17 juin 2025

Tags :
  • Création-de-contenu

Dossier jBakeMavenData

Ce dossier ne doit pas être modifié. Il sert en interne du projet. Toutes modification sera perdue !

Lors de la phase de build du projet tous les fichierq du dossier jBakeSite sont copiés dans ce dossier, puis les variables ${xxx} qui sont présente dans le fichier ecoWeb-build.properties sont remplacée par la valeur précisée dans le fichier. Se dossier sert aussi pour la compression et l'agregation des fichiers CSS et JS.

Dossier jBakeSite

C'est le dossier principal du projet. C'est dans se dossier (et sous dossier) que vous aller effectuer toutes les actions de création de contenus (et plus).

Le sous-dossier assets

Se dossier contient les images, certains fichiers CSS et les fichier JS du projet. Tout ce qui n'est pas du "texte" à afficher à l'utilisateur.

Le sous dossier css

Contient le fichier zzy-style-ext.css : ce fichier contient du CSS spécific à votre site. Cela permet d'aporter des modification au modèle (template) de votre site dans modifier les fichiers d'origine.

Le sous dossier images

Contient les images du site. Hormis le dossier common les dossiers peuvent être créé librement. Il est recommandé de suivre une structure simillaire à la structure du dossier content.

Le sous dossier common

Contient des images utilisées par le template (les logos de votre site). Il faudra rempalcer les images par defaut par les votre (en conservant exactement le même nom).

Le sous-dossier content

Contient le texte de vos pages.
La structure en sous-dossier est libre. WebLeger recommande l'utilisation de fichier rédigé en MarkDown (.md).

Le sous-dossier templates

Ce dossier contient le modèle de votre site.
Chaque modèle est dans un sous dossier. Ces modèles ont la charge de transformer vos contenus "texte" (en MarkDown) en fichier HTML.
Il est recomandandé de ne pas modifier les fichiers d'un template sauf si vous en êtes le créateur.

Si jamais vous souhaitez personaliser les modèles (pour les developpeurs) copier un dossier de modèle existant, renomez-le puis effectuer vos modifications.
Pour utiliser votre nouveau modèle modifier la variables webleger.site.template du fichier ecoWeb-build.properties.

le sous dossier components

Contient des composants ré-utilisable dans les différents templates.

le fichier jbake.properties

Ce fichier contient la configuration de JBake. Il faut éviter de modifier les lignes contenant des variables ${xxxx}. Pour modifier lesl ignes contennat des varaibles il vaut mieux modifier le fichier ecoWeb-build.properties.

Dossier target

Ce dossier ne doit pas être modifié. Il sert en interne du projet. Toutes modification sera perdue !

Dossier website

Contient votre site HTML généré par JBake en utilisant les fichier du dossier templates et les contenue du dossier content.
C'est se dossier qui devra être déplacé sur une serveur Web (ou sur gitHub Pages) pour afficher le site à vos utilisateurs.

Fichier ecoWeb-build.properties

Ce fichier permet de configurer certains paramètre sans avoir a modifier des fichier senssibles du projet.

Fichier pom.xml

Ce fichier contient la configuration nécéssaire pour éxécuter les actions de construction du projet.
Il contient aussi quelques paramètres utiles à modifier.