Beyond Linux® From Scratch (Edição systemd ) - Versão 12.4

Capítulo 50. PostScript

fop-2.11

Introdução ao fop

O pacote FOP (Formatting Objects Processor) contém um formatador de impressão controlado por objetos de formatação XSL (XSL-FO). É uma aplicação Java que lê uma árvore de objetos de formatação e renderiza as páginas resultantes em uma saída especificada. Os formatos de saída atualmente suportados incluem PDF, PCL, PostScript, SVG, XML (representação de árvore de área), impressão, AWT, MIF e texto ASCII. O alvo de saída principal é PDF.

Esse pacote é conhecido por construir e funcionar corretamente usando uma plataforma LFS 12.4.

Informação do Pacote

  • Transferência (HTTP): https://archive.apache.org/dist/xmlgraphics/fop/source/fop-2.11-src.tar.gz

  • Transferência (FTP):

  • Soma de verificação MD5 da transferência: b202dcd7c6dcaf3ec5d14bb193d7bf01

  • Tamanho da transferência: 21 MB

  • Espaço em disco estimado exigido: 343 MB (incluindo arquivos baixados para o diretório do(a) usuário(a))

  • Tempo de construção estimado: 0,9 UPC

Transferências Adicionais

Transferências Adicionais Exigidas:

Pacotes recomendados

Dependências do fop

Exigidas

apache-ant-1.10.15

Recomendadas

libarchive-3.8.1 (exigido para o desempacotamento de padrões de hifenação OFFO)

Opcionais

um ambiente gráfico (para executar testes), Ferramentas de E/S de Imagens JAI e JEuclid

Instalação do fop

Certifique-se de que $JAVA_HOME esteja configurada corretamente antes de iniciar a construção. Para construir as classes de extensão JIMI SDK e (ou) XMLUnit, certifique-se de que os arquivos .jar correspondentes possam ser encontrados por intermédio da variável de ambiente CLASSPATH.

Instalando Padrões de Hifenização OFFO

Copie os padrões de hifenização XML para a árvore do fonte do fop executando os seguintes comandos: 

unzip ../offo-hyphenation.zip &&
cp offo-hyphenation/hyph/* fop/hyph &&
rm -rf offo-hyphenation

Instalando um binário temporário Maven

A partir do fop-2.5, o sistema de construção Maven é exigido. Nós usamos o binário fornecido pelo Apache, que instalamos em um local temporário: 

tar -xf ../apache-maven-3.9.4-bin.tar.gz -C /tmp

Instalando Componentes fop

O comando javadoc fornecido com o OpenJDK 10 e posterior tornou-se muito mais rigoroso que as versões anteriores em relação à conformidade dos comentários Javadoc no código-fonte para HTML. A documentação do FOP não atende a esses padrões, de forma que as verificações de conformidade tem de ser desabilitadas. Isso pode ser feito com o seguinte comando: 

sed -i '\@</javad@i\
<arg value="-Xdoclint:none"/>\
<arg value="--allow-script-in-comments"/>\
<arg value="--ignore-source-errors"/>' \
    fop/build.xml

Compile o fop executando os seguintes comandos: 

cd fop &&

LC_ALL=en_US.UTF-8                     \
PATH=$PATH:/tmp/apache-maven-3.9.4/bin \
ant package javadocs &&

mv build/javadocs .

Esse pacote vem com uma suíte de teste, mas a infraestrutura java instalada neste livro não permite executá-la.

Agora, instale o Fop como o(a) usuário(a) root: 

install -v -d -m755 -o root -g root          /opt/fop-2.11 &&
cp -vR build conf examples fop* javadocs lib /opt/fop-2.11 &&
chmod a+x /opt/fop-2.11/fop                                &&
ln -v -sfn fop-2.11 /opt/fop

Por fim, remova a cópia temporária do Apache Maven: 

rm -rf /tmp/apache-maven-3.9.4

Explicações do Comando

sed -i ... build.xml: Isso adiciona três chaves ao comando javadoc, evitando que alguns erros ocorram durante a construção da documentação.

export LC_ALL=en_US.UTF-8: o compilador falha se usar uma localidade ASCII.

ant target: Isso lê o arquivo build.xml e constrói o alvo: compile compila os fontes java; jar-main gera arquivos jar; jar-hyphenation gera os padrões de hifenização para o FOP; junit executa os testes junit; e javadocs constrói a documentação. O alvo all executa tudo do acima.

ln -v -sf fop-2.11 /opt/fop: Isso é opcional e cria um link simbólico de conveniência, de forma que $FOP_HOME não tenha que ser mudada cada vez que exista uma mudança na versão do pacote.

Configurando o fop

Arquivos de Configuração

~/.foprc

Informação de Configuração

Usar fop para processar alguns FOs grandes (incluindo o FO derivado dos fontes XML do BLFS) pode levar a erros de memória. A menos que você adicione um parâmetro ao comando java usado no conjunto de comandos sequenciais fop, você possivelmente receba mensagens semelhantes a esta mostrada abaixo:

Exception in thread "main" java.lang.OutOfMemoryError: Java heap space

Para evitar erros como esse, você precisa passar um parâmetro extra para o comando java usado no conjunto de comandos sequenciais fop. Isso pode ser feito criando-se um ~/.foprc (que é carregado pelo conjunto de comandos sequenciais fop) e adicionando-se o parâmetro à variável de ambiente FOP_OPTS.

O conjunto de comandos sequenciais fop procura por uma variável de ambiente FOP_HOME para localizar as bibliotecas de classes do fop. Você também pode criar essa variável usando o arquivo ~/.foprc. Crie um arquivo ~/.foprc usando os seguintes comandos: 

cat > ~/.foprc << "EOF"
FOP_OPTS="-Xmx<RAM_Instalada>m"
FOP_HOME="/opt/fop"
EOF

Substitua <RAM_Instalada> por um número que represente a quantidade de RAM instalada em teu computador (em megabytes). Um exemplo seria FOP_OPTS="-Xmx768m".

Para incluir o conjunto de comandos sequenciais fop em teu caminho, atualize o perfil abrangente a todo o sistema com o seguinte comando como o(a) usuário(a) root: 

cat > /etc/profile.d/fop.sh << "EOF"
# inicia /etc/profile.d/fop.sh

pathappend /opt/fop

# Termina /etc/profile.d/fop.sh
EOF
[Nota]

Nota

Executar fop pode ser um tanto detalhado. O nível de registro padrão pode ser mudado de INFO para FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, ALL ou OFF. Para fazer isso, edite o $JAVA_HOME/jre/lib/logging.properties e mude as entradas para .level e java.util.logging.ConsoleHandler.level para o valor desejado.

Conteúdo

Aplicativos Instalados: fop
Bibliotecas Instaladas: fop.jar e numerosas classes da biblioteca de suporte localizadas em /opt/fop/{build,lib}; Os componentes JAI incluem libmlib_jai.so, jai_codec.jar, jai_core.jar e mlibwrapper_jai.jar
Diretório Instalado: /opt/fop-2.11

Descrições Curtas

fop

é um conjunto de comandos sequenciais envolucradores para o comando java, os quais configuram o ambiente do fop e passam os parâmetros exigidos

fop.jar

contém todas as classes Java do fop