Content Repository
Le référentiel de contenus (Content Repository) est l’espace où Jahia stocke tous ses éléments de contenu, ou content items (pages, contenus, dossiers, fichiers, catégories). Pour une équipe, c’est ce qui permet de maintenir une seule source pour un contenu, quelle que soit la façon dont il est affiché ensuite, sur une page, dans une liste ou dans une application.
Définition et fonctionnement
Le référentiel est d’abord découpé en deux espaces de travail. L’espace default contient la version de travail, celle que les contributeurs modifient et prévisualisent. L’espace live contient la version publiée, à partir de laquelle les pages sont produites pour les visiteurs. À l’intérieur de chaque espace, les contenus sont rangés par site, chaque projet web disposant de son propre espace pour ses contenus et ses fichiers, ainsi que de ses modules activés.
Les développeurs parlent souvent de JCR (Java Content Repository). Jahia repose sur la norme JCR 2.0. Le glossaire Academy cite aussi Jackrabbit parmi les noms techniques du référentiel. Contrairement à une base de données classique, organisée en tableaux, le référentiel range les contenus en arbre de nœuds, chacun doté d’un identifiant unique, d’un chemin et de propriétés. Pour l’enregistrement physique des données, le référentiel s’appuie lui-même sur une base de données SQL. Pour lire ou écrire des contenus depuis une application, l’API recommandée est la GraphQL API.
Documentation Academy : vue d’ensemble technique de Jahia
Termes liés : Dossier de contenu · Espace de travail · Content item · GraphQL API · Enfant · Nom affiché
Ressources sur ce terme
- Comment j'ai utilisé l'ia pour développer un module jahia en javascript en un temps record
- Comment migrer sur Jahia Cloud en 5 étapes ?
- Développer une plateforme DXP avec la meilleure UX pour les utilisateurs métiers
- European Synchrotron Radiation Facility (ESRF)
- Formation
- Les 8 meilleures alternatives à Adobe AEM en 2026
Le référentiel de contenus et l’espace de travail : les différences
Le référentiel est le contenant global. Il se distingue de ses subdivisions et des outils de rangement visibles par les contributeurs.
| Notion | Ce qui la distingue |
|---|---|
| Espace de travail | L’espace de travail est une subdivision du référentiel : default pour la version de travail, live pour la version publiée. Le référentiel contient les deux. |
| Dossier de contenu | Le dossier est un emplacement choisi par les contributeurs pour ranger des contenus réutilisables. Il vit dans le référentiel, comme les pages. |
| Base de données | La base de données SQL assure l’enregistrement physique des contenus du référentiel. Le référentiel organise les contenus au-dessus d’elle : arbre, versions publiées ou non, sites, types. |
Le référentiel de contenus en pratique
Un groupe gère son site corporate, trois sites de marque et un intranet sur la même plateforme Jahia. Chaque site a son propre espace dans le référentiel, avec ses contenus et ses fichiers. Chacun active aussi ses propres modules ; l’intranet n’a pas besoin des mêmes fonctions que les sites de marque.
Pour une équipe d’architecture, la question n’est donc pas "combien de bases", mais comment découper les sites et ce qui doit être partagé entre eux.
Questions fréquentes
Faut-il connaître JCR pour travailler avec Jahia ?
Pas pour les contributeurs, qui manipulent des pages, des dossiers et des contenus dans jContent sans jamais voir le référentiel de contenus en tant que tel. Les développeurs gagnent à en comprendre les principes (arbre, nœuds, propriétés, espaces de travail). Pour lire et écrire des contenus depuis une application, ils utilisent l’API GraphQL, recommandée par Jahia, plutôt que les interfaces JCR de bas niveau.
Plusieurs sites peuvent-ils partager le même référentiel Jahia ?
Oui, c’est même son organisation de base. Le référentiel de contenus est découpé par espace de travail, puis par site. Chaque projet web y a son propre espace pour ses contenus, ses fichiers et ses modules activés. Certains éléments, comme les catégories, sont gérés pour toute la plateforme et donc partagés. Des contenus peuvent aussi être réutilisés d’un site à l’autre par référence, sous conditions de configuration.
Où sont stockés les fichiers et les images dans Jahia ?
Dans le référentiel, comme les autres contenus. Chaque site dispose de son propre espace de fichiers, géré dans la section Media de jContent. Un fichier est un élément de contenu, avec ses propriétés et son état de publication. Il peut être affiché sur plusieurs pages grâce à des références de fichier ou d’image, sans être importé plusieurs fois.