|
|
# Principe d'organisation
|
|
|
|
|
|
À une seule exception près (celle de la fonction de marquage des termes de recherche), aucun code HTML n'est créé directement à partir de code javascript. Le code HTML est créé à partir de fichiers de structure et de gabarit. Ce principe permet d'adapter le code HTML produit sans toucher au Javascript et en limitant donc les problèmes au moment des changements de versions.
|
|
|
|
|
|
Pour comprendre le fonctionnement, il faut aller jeter un œil sur le répertoire [src/html](https://framagit.org/Scrutari/scrutarijs/tree/master/src/html). Celui comprend un répertoire _default et un répertoire par adaptation à des bibliothèques existantes (par exemple, bootstrap3, bootstrap2). On peut voir ça comme des « thèmes » pour reprendre la terminologie d'autres logiciels.
|
... | ... | @@ -5,4 +7,10 @@ Pour comprendre le fonctionnement, il faut aller jeter un œil sur le répertoir |
|
|
Chaque répertoire comprend un sous-répertoire structure/ et un sous-répertoire templates/. La différence est la suivante :
|
|
|
|
|
|
- structure/ comprend des éléments HTML statiques qui sont chargés une fois pour toute à l'initialisation, la seule instruction possible est celle de l'inclusion où le nom d'un fichier de structure est indiqué entre doubles accolades pour indiquer qu'il doit être inséré à cette endroit, l'exemple est le fichier main.html dont la présence est obligatoire qui va contenir les instructions d'insertion des autres éléments de structure
|
|
|
- templates/ comprend les gabarits au format de JSRender qui vont servir à produire les parties dynamiques dont le contenu est issu des informations fournies par le moteur (par exemple, la liste des bases ou le résultat d'une recherche). |
|
|
\ No newline at end of file |
|
|
- templates/ comprend les gabarits au format de JSRender qui vont servir à produire les parties dynamiques dont le contenu est issu des informations fournies par le moteur (par exemple, la liste des bases ou le résultat d'une recherche).
|
|
|
|
|
|
Au moment de la compilation, tous les fichiers de structure/ et de templates/ sont compilés dans les fichiers .js qui trouvent dans html/. Les fichiers de _default/ sont placés automatiquement dans chaque .js s'il n'existe pas de fichiers équivalent. De fait, le HTML contenu dans _default/ ne dépend pas d'une bibliothèque particulière et est susceptible d'être utilisé partout (toutes les classes sont préfixées par scrutari-)
|
|
|
|
|
|
# Reformuler un élement de structure et de gabarit
|
|
|
|
|
|
La manière la plus simple de modifier un élément de structure sans toucher au Javascript ni avoir besoin de recompiler est de proposer les reformulations directement dans la page web dans laquelle est hébergée le client. Cela se fait en insérant des balises <script> avec |
|
|
\ No newline at end of file |