Fonctionnalités avancées
Réponse du endpoint document
en HTML
Par défaut, le endpoint document
fournit une réponse au format TEI
. Cependant, DoTS permet également d'obtenir des réponses dans d'autres formats, notamment en HTML, grâce à des mécanismes de transformation.
Pour utiliser, par exemple, les transformations XSLT de la communauté TEI, suivez ces étapes :
- Créez un dossier nommé
dots/webapp/static/transform
. - Téléchargez les feuilles de style dans ce dossier, par exemple en utilisant
git clone https://github.com/TEIC/Stylesheets.git
. - Ouvrez le module XQuery
/dots/repo/globals.xqm
. - Modifiez la valeur de la variable
$G:defaultXslEnginePath
pour qu'elle pointe vers la XSL dans le dossiertransform
(généralementStylesheet/html/html.xsl
).
Une fois ces étapes accomplies, le endpoint document
avec le paramètre mediaType=html
vous permettra d'afficher le document (ou le fragment) au format HTML.
XSLT spécifiques et surcharges
DoTS propose également un système avancé de gestion des XSLT, offrant les possibilités suivantes :
- Utiliser une feuille XSLT spécifique pour un document et / ou un projet.
- Utiliser une feuille XSLT qui importe et complète d'autres XSLTs (XSLT par défaut, par exemple).
XSLT pour un document
Dans le dossier dots/webapp/static/transform
, vous pouvez créer un sous-dossier portant le nom de la base de données du projet. Dans ce sous-dossier, vous pouvez ajouter des feuilles de style XSLT supplémentaires :
- Si une feuille de style est nommée
{$resourceId}.xsl
, elle sera utilisée prioritairement pour le documentresourceId
. - Si une feuille de style est nommée
dbName.xsl
, elle sera utilisée prioritairement pour tous les documents du projet de la dbdbName
.
Il est possible d'avoir une feuille de style pour le projet ainsi qu'une feuille de style spécifique pour un ou plusieurs documents du projet. De plus, ces feuilles de style peuvent importer d'autres XSL pour une personnalisation accrue.