⚙️ Personnalisation de la publication OPUS

La configuration d’une publication OPUS repose sur un fichier unique : config.yml, situé à la racine du projet.

Ce fichier permet d’ajuster l’apparence, le comportement et l’organisation des données, sans modifier les fichiers CSS ou le code source.

🖋 Informations générales

Vous pouvez modifier les éléments affichés sur la page d’accueil (titre, sous-titre, auteur, éditeur, collection, etc.) :

title: Le titre de la publication
subtitle: (VI<sup>e</sup>/VII<sup>e</sup>-XII<sup>e</sup> siècles)
author: Nom de l'auteur
editor: École française d'Athènes
collection: Études épigraphiques
colorcollection: rgb(15, 76, 129)
numcollection: 8
logo: logo.svg

⚠️ le logo doit être déposé dans le répertoire [ :racine du projet]/images/logos

🌍 Déploiement sur un site distant

Lorsque la publication est déployée sur un site externe, les paramètres suivants permettent de définir son URL et son chemin d’accès :

baseurl: ''\
url: "" # the base hostname & protocol for your site, e.g. http://example.com\

🔗 Lien entre notices et texte

Deux stratégies sont possibles pour organiser le retour depuis une notice vers le texte correspondant :

🧱 Par chapitres

Si le paramètre corpus_chapitre = true alors les notices groupées (via le champ groupe dans Tropy)sont liées à un chaptire et le retour de la notice vers le texte se fera vers le chapitre en question

corpus_chapitre: true 

Chaque groupe de notices est alors associé à un chapitre.

⚠️ Le fichier Markdown du chapitre doit contenir une section section: dans ses métadonnées qui indique le groupe lié au chapitre (ici 1-ceramique)

    ---
    layout: chapitre
    type: chapitre
    title:  "Céramique figurée"
    section: "1-ceramique"
    order: 1
    toc: true
    ---

📑 Par page unique

    corpus_chapitre: false 
    corpus_pages: "2-chapitre-mydata" # entrer ici le chapitre que les fiches doivent référencer pour revenir au texte

Toutes les notices renvoient à une même page regroupant plusieurs notices, avec des ancres internes (Voir la documentation : Lien du texte avec plusieurs notices).

🗂 Organisation des métadonnées dans les fiches

Vous pouvez regrouper les attributs d’une fiche en sections personnalisées :

card_group1_label : "Description matérielle"
card_group1_items : [materiau, sphere, theme, figure,modele]

card_group2_label : "Contexte archéologique"
card_group2_items : [contexte, region, ville, site, atelier]

card_group3_label : "Image"
card_group3_items : [credits_photographiques,lien_vers_la_source]

card_group4_label : ""
card_group4_items : []

Cela permet d’organiser visuellement les métadonnées dans la fiche comme ci-dessous :

🚫 Masquer certaines métadonnées

Exclure des attributs de l’affichage dans la fiche

#liste des attributs d'une fiche ne devant pas être affichés 
exclude_page: [title, lieux_de_decouverte, couverture]

Ces champs restent présents dans les fichiers .json et peuvent toujours être utilisés dans la recherche.

Exclure des attributs du tableau

#liste des attributs d'une fiche traités hors table 
exclude_table: [doi, paralleles, copyright]

Ces métadonnées ne seront pas affichées dans la table principale de la fiche.

🏷 Titre et sous-titre dans les fiches

Fiche complète

full_card_title: title
full_card_subtitle: typologie

Vignettes (aperçu)

card_title: title
card_subtitle: dates

🧭 Message personnalisé pour accéder aux objets

Vous pouvez modifier le libellé du lien qui mène aux notices depuis un texte :

show_object_message: "Afficher les objets"

⚠️ Paramètres réservés

Les autres paramètres présents dans config.yml sont utilisés en interne par le moteur de génération. Il est fortement recommandé de ne pas les modifier.