1. Accueil
  2. Docs
  3. Pour tout savoir sur Lodex !
  4. Le thème

Le thème

Dans Lodex, le thème définit la charte graphique des pages : couleurs, polices de caractères, icônes…

Chaque thème comporte au moins un fichier index.html contenant une balise dont l’identifiant est root. C’est dans cet élément HTML que s’instancie l’application.

Un thème par défaut est intégré à chaque instance créée, aucune action spécifique n’est nécessaire pour l’utiliser.

Aperçu de l’affichage obtenu avec le thème par défaut de Lodex

L’administrateur d’une instance Lodex peut donc choisir de conserver cet affichage graphique proposé par défaut ou décider d’adopter un thème personnalisé. Il a alors le choix d’utiliser un thème préexistant ou d’en créer un nouveau.

Utilisation d’un thème existant

Des exemples de thèmes prédéfinis sont disponibles sur Github, dans une bibliothèque dédiée : https://github.com/Inist-CNRS/lodex-themes

Exemples de thèmes présents dans la bibliothèque

  • Thème du département DAFIS de l’Inist

Aperçu de l’affichage obtenu avec le thème du DAFIS de l’Inist

  • Thème Data ISTEX

Aperçu de l’affichage obtenu avec le thème de Data ISTEX

Création d’un thème

Chaque thème comporte au moins un fichier index.html contenant une balise dont l’identifiant est root. C’est dans cet élément HTML que s’instancie l’application.

Le contenu minimum du fichier index.html est donc: <div id="root"></div>

Le fichier index.html doit contenir des balises </head> et </body>. (ces deux éléments sont contradictoires)

Une instance de Lodex est un site web statique, sauf pour l’élément div contenant l’application Lodex.
Vous pouvez donc utiliser :

  • du CSS
  • du JavaScript
  • des images
  • des sous-répertoires

Vous pouvez inclure d’autres pages html, liées à partir du fichier index.html,  qui seront statiques et vous permettront de réaliser un thème complet.

Attention à ne pas utiliser des liens incluant des noms de domaines (utilisez  /other_page.html, et non pas http://mydomain.com/other_page.html).

C’est à la conception du thème que certaines options sont ajoutées, comme le fait de différencier un mode administrateur d’un mode utilisateur, d’accéder à l’instance par un mot de passe etc…

  • administration: /admin
  • connexion: /login
  • liste des ressources: /graph
Dans le cas où des documents comme “Documentation”, “Mentions légales”, “Méthodologie” sont inclus dans le thème, il faut modifier le fichier de configuration de l’instance pour afficher un lien vers ces documents dans l’instance.

Voir : Les paramètres d’une instance

    Chargement d’un thème

    Si Lodex est installé sous ezMaster

    • Télécharger les fichiers nécessaires au thème et les décompresser

    Par exemple à l’adresse suivante pour les thèmes Inist : https://github.com/Inist-CNRS/lodex-themes

    • Se connecter aux répertoires de l’instance

    L’accès à l’arborescence des fichiers de Lodex se fait au moyen du WebDav de l’instance. (voir le paragraphe “Paramétrer une instance” dans Créer une instance lodex)

      • Cliquer l’icône de téléchargement de fichiers

      • Cliquer sur « Upload file with Webdav »
      • Copier l’URL Webdav mentionnée dans le point 2 de la procédure indiquée (par exemple ci-dessous : http://webdav.corpus.istex.fr/…)

      • Ouvrir l’explorateur de fichiers du PC, se positionner sur “Ce PC” (1) puis cliquer sur “Connecter un lecteur réseau” (2)

      • Coller l’URL webdav dans la zone “Dossier” puis cliquer sur “Terminer”

    La connexion à ce lecteur implique de saisir le login et le mot de passe de la machine Lodex utilisée

    • Ouvrir le lecteur réseau nouvellement créé dans “Ce PC”
    • Copier/coller le contenu du répertoire de thème décompressé à la racine du lecteur réseau ouvert

    A la question “Remplacer les fichiers existants dans la destination ?” , répondre oui

    • Pour que la nouvelle configuration soit prise en compte
      • arrêter l’instance dans ezMaster

      • puis la redémarrer

    Si Lodex est installé sans ezMaster

    Les fichiers et répertoires composant le thème doivent être ajoutés dans le répertoire src/app/custom de l’arborescence Lodex, avant de relancer  le programme.

    Cet article vous a-t-il été utile ? Oui Non

    Comment pouvons-nous aider ?