- Lodel 1.0
- Docker CE
- Docker Compose
Seul le fichier docker-compose.yml est nécessaire, vous pouvez le mettre où vous le souhaitez.
Vous pouvez modifier le port exposé, ainsi que les identifiants de connexion au convertisseur dans ce fichier, en modifiant la section ports du proxy, ainsi que les variables d'environnement BASIC_AUTH_USER et BASIC_AUTH_PASS.
Pour plus d'informations, se référer à la documentation de configuration de Docker Compose.
Une fois les modifications faites, lancer le service avec la commande :
docker-compose upImportez les fichiers translations/translation-xx.xml fournis dans ce dépôt via le panneau d'administration générale de Lodel dont l'URL est de la forme lodeladmin/index.php?do=list&lo=translations (à ne pas confondre avec le panneau d'administration du site). Ainsi les traductions du plugin sont importées une seule fois pour tous les sites.
Dans le répertoire share/plugins/custom/ de votre installation, clonez le dépôt :
git clone https://github.com/chapitreneuf/pdfgen.gitAccédez à l'administration des plugins de votre installation lodel (https://votreinstallation/lodeladmin/index.php?do=list&lo=mainplugins) et activez le plugin pdfgen.
Enfin sur chaque site où vous souhaitez utiliser le générateur activez le plugin depuis l'administration des plugin du site. Une fois le plugin activé, accédez à sa configuration et saisissez l'URL du convertisseur, dans le format ci-dessous. L'URL doit correspondre à la configuration saisie précédement dans le fichier de configuration de Docker Compose :
http://login:password@domaine:port
Pour ajouter le logo du site en haut de la page des PDF, insérez une image pdf_logo.png dans le dossier tpl/ du site.
Pour afficher le logo de la plateforme sur les PDF, insérez une image /plugins/custom/pdfgen/public/plateforme.png.
Une fois activé, le plugin rend accessible les URLs suivantes :
- Récupération du PDF :
/?do=_pdfgen_get&document=[#ID]&lang=[#LANG] - Affichage de la version HTML intermédiaire :
/?do=_pdfgen_view&document=[#ID]&lang=[#LANG]
L'attribut [#LANG] détermine la langue des variables de traductions. Il est recommandé de toujours utiliser la langue principale du site.
Le PDF généré est mis en cache par le générateur et automatiquement recalculé lorsque les données du document sont modifiées. Il est toujours possible de forcer la régénération avec l'argument clearcache :
/?do=_pdfgen_get&document=[#ID]&lang=[#LANG]&clearcache=1
Il est aussi possible de supprimer le contenu du répertoire "CACHE" de la revue.
Quand le plugin est actif et configuré, on peut récupérer le lien vers le PDF automatique dans les templates avec la variable LodelScript [#PDFGEN_URL].
<!--[ Si un PDF fac-similé est lié à l'article, on pointe vers ce fichier ]-->
<IF COND="[#ALTERFICHIER]">
<a role="button" href="[#ID|makeurlwithid|query_string('file', '1')]">Télécharger le PDF</a>
<!--[ Sinon on vérifie que le générateur est actif et si oui on pointe vers le PDF automatique ]-->
<ELSEIF COND="[#PDFGEN_URL]" />
<a role="button" href="[#PDFGEN_URL]">Télécharger le PDF</a>
</IF>Depuis PDFgen 1.3, le plugin supporte la génération des PDF des numéros complets et la prévisualisation des PDF des documents non publiés. Il est nécessaire d'utiliser la Nova 2.4 ou supérieure pour que ces fonctionnalités soient utilisables.
Pour afficher le DOI des numéros sur les PDF, la dernière version de lodel-options-extra doit être utilisée (option "Types présentant des DOI").
Dans le cas où la génération de numéros longs entraînerait des problèmes (messages d'erreur, PDF vides), il est possible d'augmenter la valeur de la variable $waitTimeout dans pdfgen.php.
Il est possible de personnaliser les templates du PDF en redéclarant les macros de macros_pdfgen.html dans tpl/macros_custom.html.
Les macros PDFGEN_CUSTOM_JS et PDFGEN_CUSTOM_CSS à déclarer dans tpl/macros_custom.html permettent d'ajouter respectivement des scripts et des styles à la page.
Exemple pour remplacer la numérotation des paragraphes par un numéro de page :
/**
* Affichage du numéro de page
*/
<DEFMACRO NAME="PDFGEN_CUSTOM_CSS">
<style>
@page {
@bottom-center {
content: counter(page);
}
}
.article__text-contents > p.texte::before {
content: none;
}
</style>
</DEFMACRO>Depuis PDFgen 1.3, il est possible de modifier le fichier macros_pdfgen_custom.html pour introduire des modifications et définir des paramètres qui s'appliqueront à l'ensemble des sites de l'instance Lodel.
Dans le cas d'une mise à niveau, il est nécessaire de réinstaller les variables de traduction dans l'administration générale de Lodel (voir plus haut). En cas d'erreur lors de l'import les variables doivent être mises à jour manuellement via l'interface.
Ce projet a été développé par le collectif Chapitre neuf pour les Bibliothèques universitaires de l'Université Jean Moulin Lyon 3. Il a été financé par l'Université Jean Moulin Lyon 3.
Chapitre neuf a accepté de publier son code source sous licence libre GPL3 sans contrepartie, affirmant ainsi son engagement en faveur du logiciel libre.
- Développement backend, PHP et Lodel : Nahuel Angelinetti
- Design et intégration des templates : Thomas Brouard
2024, Chapitre neuf
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.