Après l'installation de mon serveur homelab, voici l'installation d'une autre brique logiciel, celle de l'application web open source
Stirling-PDF, un outil de manipulation de PDF robuste, hébergé localement sur le web et utilisant Docker. Il vous permet d'effectuer diverses opérations sur les fichiers PDF, notamment la division, la fusion, la conversion, la réorganisation, l'ajout d'images, la rotation, la compression, etc. Cette application web hébergée localement a évolué pour englober un ensemble complet de fonctionnalités, répondant à tous vos besoins en matière de PDF (La liste complète des fonctionnalités est disponible sur la page README du Github).
Stirling-PDF est développé en Java avec Spring Boot tandis qu'Apache PDFBox est le cœur de la fonctionnalité PDF de Stirling-PDF. Stirling-PDF est disponible en version desktop (exécutable Windows) ou en version serveur hébergé (installation complète ou image Docker). L'interface web est intuitive et moderne, organisée en sections claires :
- Une barre latérale listant toutes les fonctionnalités disponibles
- Une zone de glisser-déposer pour les fichiers
- Des options de configuration contextuelle selon l'opération choisie
- Un thème sombre/clair configurable
- Multi-langues avec 38 langages supportés
Installer Stirling-PDF avec Podman
Une solution simple pour faire installer Stirling-PDF sur son serveur est de déployer une image Docker disponible sur Docker Hub à l'adresse stirlingtools/stirling-pdf.
Sur une distribution Fedora Server, Podman, qui est normalement déjà installé, remplace avantageusement Docker tout en utilisant les mêmes images.
podman run --detach \
--restart always \
--name stirling-pdf \
-p 8080:8080 \
-v "/opt/stirling-pdf/trainingData:/usr/share/tessdata" \
-v "/opt/stirling-pdf/extraConfigs:/configs" \
-v "/opt/stirling-pdf/customFiles:/customFiles/" \
-v "/opt/stirling-pdf/logs:/logs/" \
-e "LANGS=en_GB,en_US,fr_FR" \
stirlingtools/stirling-pdf:latest
La variable LANGS permet de définir des bibliothèques de polices personnalisées à installer pour la conversion de documents.
Personnalisation de l'interface
Ajoutez ce qui suit, à votre commande Podman Run existante, pour personnaliser l'interface :
- Afficher l'interface dans la langue de votre choix :
-e SYSTEM_DEFAULTLOCALE=fr-FR
Par défaut, ce choix est défini à 'en-US'.
- Personnaliser le nom de l'application :
-e "UI_APP_NAME=Mathdatech's Stirling PDF"
- Personnaliser la description de l'application :
-e "UI_HOME_DESCRIPTION=Votre couteau suisse des PDF"
- Personnaliser le nom de la NavBar :
-e "UI_APPNAMENAVBAR=Mathdatech Corp"
Ajout de la reconnaissance de texte
Stirling-PDF utilise Tesseract OCR pour sa reconnaissance de texte, qui prend en charge un grand nombre de langues.
Il s’installe donc via le gestionnaire de paquets avec la commande :
$ sudo dnf install tesseract tesseract-langpack-fra tesseract-langpack-eng
Les packs de langues sont des fichiers .traineddata qui sont installés par défaut dans le répertoire /usr/share/tesseract/tessdata sur Fedora.
Vous pouvez trouver des packs de langues supplémentaires dans les dépôts GitHub de Tesseract.
Ajoutez ce qui suit, à votre commande Podman Run existante, pour utiliser les packs linguistiques précédemment installés :
-v "/usr/share/tesseract/tessdata:/usr/share/tessdata"
Puis démarrer votre conteneur Podman.
Pour en savoir plus
Voici les liens officiels :
Liens spécifiques pour tester des instances Stirling-PDF :