Contenu
/opt/fop/{build,lib}
; Les composants
JAI contiennent libmlib_jai.so, jai_codec.jar, jai_core.jar et
mlibwrapper_jai.jar
Le paquet FOP (Formatting Objects Processor) contient un formateur d'impression guidé par les objets de formatage XSL (XSL-FO). C'est une application Java qui lit une arborescence d'objets de formatage et qui produit les pages qui en résultent vers une sortie spécifique. Les formats de sortie actuellement supportés comprennent le PDF, PCL, PostScript, SVG, XML (représentation en arborescence de zone), print, AWT, MIF et le texte ASCII. La cible de sortie principale est le PDF.
This package is known to build and work properly using an LFS 12.0 platform.
Téléchargement (HTTP) : https://archive.apache.org/dist/xmlgraphics/fop/source/fop-2.9-src.tar.gz
Somme de contrôle MD5 : f7537ca7f2e16971fa99c8bb0dad62c7
Taille du téléchargement : 20 Mo
Estimation de l'espace disque requis : 333 Mo (dont les fichiers téléchargés dans le répertoire personnel de l'utilisateur qui construit)
Estimation du temps de construction : 0,9 SBU
Téléchargements supplémentaires requis :
Système de construction Maven :
https://archive.apache.org/dist/maven/maven-3/3.9.4/binaries/apache-maven-3.9.4-bin.tar.gz
0698a533397eda60cbebcc0fb68ae842
9,0 Mo (en plus, environ 90 Mo sont téléchargés das
le répertoire personnel de l'utilisateur qui construit)
Paquets recommandés
Les patrons de césure OFFO (Objets pour formater des
objets) :
https://downloads.sourceforge.net/offo/2.2/offo-hyphenation.zip
bf9c09bf05108ef9661b8f08d91c2336
862 Ko
un environnement graphique (pour lancer les tests), JAI Image I/O Tools et JEuclid
Assurez-vous que $JAVA_HOME
est
correctement paramétré avant de commencer la construction. Pour
construire les classes d'extension JIMI
SDK et XMLUnit,
assurez-vous que les fichiers .jar
correspondants peuvent être trouvés par la variable d'environnement
CLASSPATH
.
Copiez les patrons de césure XML dans l'arborescence des sources de fop en exécutant les commandes suivantes :
unzip ../offo-hyphenation.zip && cp offo-hyphenation/hyph/* fop/hyph && rm -rf offo-hyphenation
À partir de fop-2.5, le système de construction Maven est requis. Nous utilisons le binaire fournit par apache, que nous installons à un emplacement temporaire :
tar -xf ../apache-maven-3.9.4-bin.tar.gz -C /tmp
La commande javadoc venant avec OpenJDK 10 et suivants est devenue plus stricte qu'avant à propos de la conformité des commentaires javadoc dans le code source vers l'HTML. La documentation de FOP ne respecte pas ces standards, aussi les tests de conformité ont été désactivés. Cela peut être fait avec la commande suivante :
sed -i '\@</javad@i\ <arg value="-Xdoclint:none"/>\ <arg value="--allow-script-in-comments"/>\ <arg value="--ignore-source-errors"/>' \ fop/build.xml
Compilez fop en exécutant les commandes suivantes :
cd fop && LC_ALL=en_US.UTF-8 \ PATH=$PATH:/tmp/apache-maven-3.9.4/bin \ ant all javadocs && mv build/javadocs .
Ce paquet possède une suite de tests, mais l'infrastructure java installée dans ce livre ne permet pas de la lancer.
Maintenant, installez Fop en
tant qu'utilisateur root
:
install -v -d -m755 -o root -g root /opt/fop-2.9 && cp -vR build conf examples fop* javadocs lib /opt/fop-2.9 && chmod a+x /opt/fop-2.9/fop && ln -v -sfn fop-2.9 /opt/fop
Il reste à nettoyer ce que nous avons fait :
rm -rf /tmp/apache-maven-3.9.4
sed -i ... build.xml : cela ajoute trois paramètres à la commande javadoc, empêchant certaines erreurs de se produire en construisant la documentation.
export LC_ALL=en_US.UTF-8 : le compilateur échoue si vous utilisez une locale ASCII.
ant target
: Ceci lit le fichier
build.xml
et construit la
cible : compile
compile les
sources java, jar-main
génère les
archives jar, jar-hyphenation
génère
les patrons de césure pour FOP, junit
lance les tests junit et
javadocs
construit la documentation. La
cible all
lance toutes les cibles
précédentes.
ln -v -sf fop-2.9
/opt/fop : Ceci est facultatif et crée un lien
symbolique pratique pour que $FOP_HOME
n'ait pas besoin d'être changé à chaque changement de version du
paquet.
Utiliser fop pour traiter de gros FO (dont les FO dérivés des sources XML de LFS) peut conduire à des erreurs de mémoire. À moins d'ajouter un paramètre à la commande java utilisée dans le script fop vous pouvez obtenir des messages similaires à ceci :
Exception in thread "main"
java.lang.OutOfMemoryError: Java heap space
Pour éviter de telles erreurs, vous devez passer un argument
supplémentaire à la commande java utilisée dans le script
fop. Ceci peut se
faire en créant un fichier ~/.foprc
(qui est sourcé par le script fop) et en ajoutant le
paramètre à la variable d'environnement FOP_OPTS
.
Le script fop
cherche une variable d'environnement FOP_HOME
pour localiser les bibliothèques de
classe fop. Vous pouvez créer
cette variable en utilisant le fichier ~/.foprc
aussi. Créez un fichier ~/.foprc
avec les commandes suivantes :
cat > ~/.foprc << "EOF"
FOP_OPTS="-Xmx<RAM_Installed>
m"
FOP_HOME="/opt/fop"
EOF
Remplacez <RAM_Installed>
avec un
nombre représentant la quantité de RAM installée dans votre
ordinateur (en mégaoctets). Par exemple, FOP_OPTS="-Xmx768m"
.
Pour inclure le script fop dans votre path, mettez à
jour le profil système avec la commande suivante en tant
qu'utilisateur root
:
cat > /etc/profile.d/fop.sh << "EOF"
# Begin /etc/profile.d/fop.sh
pathappend /opt/fop
# End /etc/profile.d/fop.sh
EOF
L'exécution de fop peut être assez verbeuse.
Par défaut le niveau de journalisation est INFO et peut être
changé en FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE,
ALL ou OFF. Pour ce faire, éditez $JAVA_HOME/jre/lib/logging.properties
et
changez les entrées pour .leval
et
java.util.logging.ConsoleHandler.level
à la
valeur désirée.
/opt/fop/{build,lib}
; Les composants
JAI contiennent libmlib_jai.so, jai_codec.jar, jai_core.jar et
mlibwrapper_jai.jar