Problema: Si tratta di testate o di titoli che restano isolati (il termine tecnico è vedovi) alla fine della pagina.

Causa: Apache FOP non supporta ancora l'attributo keep-with-next (mantieni con successivo), tranne che nelle righe di tabella.

Soluzione: Forzare un salto pagina all'inizio dell'elemento (tipicamente una sezione, ma potrebbe essere anche una lista, una tabella, o un'altro elemento) a cui il titolo o la testata appartengono.

Come: Se l'elemento ha un attributo id (si può vedere nel sorgente DocBook), si può allora cercare per quell'id nel file FO. Ad esempio, supponendo di aver appena generato la Firebird 2 Quick Start Guide e si sia riscontrato che il titolo Creating a database using isql sia posizionato alla fine di una pagina. Nel sorgente DocBook XML si può vedere che quello è il titolo di una sezione il cui id è qsg2-databases-creating. Cercando il testo qsg2-databases-creating dall'inizio del file FO, la prima cosa che si trova è probabilmente qualcosa di questo genere:

<fox:outline internal-destination="qsg2-databases-creating">

L'elemento fox:outline corrisponde al link nel pannello di navigazione alla sinistra del PDF. Così questa non è ancora la sezione vera e propria, e bisogna cercare oltre. Successivamente si trova:

<fo:block text-align-last="justify" end-indent="24pt"
          last-line-end-indent="-24pt"><fo:inline
   keep-with-next.within-line="always"><fo:basic-link
   internal-destination="qsg2-databases-creating">Creating a database...

In questo caso, l'id è il valore d'un attributo in un fo:basic-link. Pertanto ora siamo nell'indice iniziale o tabella dei contenuti (Table of Contents). Ancora non è il posto giusto.

Il terzo ed il quarto tentativo sono spesso un paio di linee dopo il secondo, per creare il numero di linea alla citazione nell'indice. Ma il quinto tentativo è di solito quello che si stà cercando (a meno che non ci siano altri link in avanti alla sezione in questione):

<fo:block id="qsg2-databases-creating">

Eccolo qua! La maggior parte degli elementi gerarchicamente di medio e basso livello in DocBook (preface, section, appendix, para ecc.) determinano un fo:block nel file FO. Adesso si deve modificare il file FO in modo da costringere Apache FOP a iniziare questa sezione a pagina nuova. Si modifica la linea in questo modo:

<fo:block id="qsg2-databases-creating" break-before="page">

Salvare la modifica e ricostruire il PDF, ricordandosi di usare build fo2pdf, e non build pdf. Il titolo della sezione adesso apparirà alla successiva pagina nuova, e si può passare al problema successivo.

E se l'elemento di DocBook non ha un suo id? Allora si dovrà cercare il (o parte del) titolo o della testata. Questo sarà un po' più complicato, perchè il titolo potrebbe contenere un a capo nel file FO, nel qual caso non verrebbe trovato. Oppure il titolo potrebbe contenere dei suoi elementi figli (ad esempio quote o emphasis). Questo impedirebbe di trovare il titolo completo. D'altra parte più si stringe il testo da cercare, più alta sarà la probabilità di trovare cose non correlate. In questo caso si dovrà adoperarre il proprio metro di gudizio; Se ad esempio c'è del testo riconoscibile subito prima o subito dopo il titolo che si può cercare facilmente, si può provare a trovare il titolo nelle linee sopra o sotto di esso.

Ad ogni modo, una volta che l'avete trovato, risalite nel file FO finchè non si trova l'inizio della sezione, spesso identificabile con un numero di id autogenerato:

</fo:block>
<fo:block id="d0e2340">
  <fo:block>
    <fo:block>
      <fo:block keep-together="always" margin-left="0pc"
                font-family="sans-serif,Symbol,ZapfDingbats">
        <fo:block keep-with-next.within-column="always">
          <fo:block font-family="sans-serif" font-weight="bold"
                    keep-with-next.within-column="always"
                    space-before.minimum="0.8em" space-before.optimum...
                    space-before.maximum="1.2em" color="#404090" hyph...
                    text-align="start">
            <fo:block font-size="11pt" font-style="italic"
                      space-before.minimum="0.88em" space-before.opti...
                      space-before.maximum="1.32em">The DISTINCT keyword
              comes to the rescue!</fo:block>

Come si può vedere, ci possono essere un bel po' di righe tra l'inizio della sezione ed il titolo del testo. Notare, inoltre, come il titolo qui è diviso su due linee.

Una volta identificato il fo:block che corrisponde all'inizio della sezione, basta mettergli un attributo break-before="page" proprio come si è fatto prima.

Perchè risalire e cercare l'inizio della sezione e non mettere il break-before al fo:block che racchiude direttamente il titolo? Be', perchè stamperà sì il titolo nella pagina successiva, giustamente, ma i link nel frame di navigazione e nell'indice punteranno (oibò!) alla pagina precedente, perchè la (invisibile) sezione inizia - cioè il blocco che ha l'ID - prima del salto pagina forzato.

Problema: Spazi (di dimensione variabile) appaiono in certe posizioni nei nomi di file ecc.

Causa: Nel file FO, questi elementi contengono caratteri spazio di dimensione zero ( zero-width space o ZWSP, Unicode 200B esadecimale) per indicare dove la stringa può essere interrotta per andare a capo. Sfortunatamente, Apache FOP utilizza gli stessi caratteri anche ai fini della giustificazione.

Soluzione: Se gli spazi sono proprio troppo grandi, si possono eliminare (tranne quando la linea deve effettivamente andare a capo dove c'è quel ZWSP).

Come: Cercare l'intera URL o nome del file non può funzionare, proprio perchè la stringhe contiene i famosi spazi di lunghezza zero! Se la stringa contiene un elemento che è raro o unico nel file (es. hababarulala nel nome di file C:\Strips\Pintoplaneet\hababarulala.txt), si potrebbe usare quello. Altrimenti si cerca per del testo che gli stà vicino. (Ormai si è capito che a scorrere semplicemente il file FO ci si impiega troppo, a causa della gran quantità di cose in più introdotte dal XSL-FO, invadendo tutto il testo del documento)

Una volta trovata la stringa, controllare se si riesce effettivamente a vedere gli spazi ZWSP. Alcuni editor non li mostrano per niente (il che sarebbe anche giustificato, dato che hanno dimensione zero). Comunque, si dovrebbe essere in grado di trovarli scorrendo la stringa con il cursore. Se con la freccia a destra o a sinistra il cursore non si muove (ma torna a muoversi con il successivo movimento nella stessa direzione), quello è il punto dov'è lo ZWSP. Altri editor li mostrano con un simbolo, altri (ConText) come tre “strani”caratteri: ​. Questi caratteri rappresentano il codice a tre byte UTF-8 per lo spazio di dimensione zero.

Se si riesce ad indentificare lo spazio di dimensione zero, si può cancellare, ma bisogna tenere d'occhio pure il file PDF: non bisogna eliminare uno ZWSP se serve per andare a capo nel PDF.

Problema: In una tabella, una riga è interrotta da un salto pagina per cui non è tutta da una parte o dall'altra.

Causa: Nessuna in particolare - non c'è una regola che impedisca i salti pagina all'interno delle righe di una tabella.

Soluzione: Per tenere la riga insieme, inserire un salto pagina all'inizio della riga.

Come: Cerca la riga sulla base del testo all'inizio della riga o alla fine della riga precedente. L'elemento che si sta cercando è fo:table-row, ma non si deve usare come stringa di ricerca, perchè molti elementi di DocBook (non solo per le tabelle, cioè gli elementi <table>) sono implementati usando fo:table e pertanto contengono fo:table-rows.

Una volta trovato l'inizio della riga tagliata a metà, si aggiunge un attributo break-before esattamente come per i windowed headers:

<fo:table-row break-before="page">

In alternativa si può sempre impostare un attributo break-after alla riga precedente.

Problema: Spazi molto larghi per giustificare linee precedenti lunghe stringhe senza spazi. Queste stringhe lunghe sono spesso stampate con font a spazio fisso:

Causa: Apache FOP spesso non sillaba queste stringhe e le prende come un tutt'uno. Pertanto, se la stringa non entra nella riga la sposta interamente nella riga seguente. Questo lascia alla linea precedente “troppo poco” testo, rendendo necessaria una giustificazione con larghi spazi. Notare come nell'esempio qui sopra, gli spazi nella linea sopra siano causati dall'incapacita di suddividere la stringa della linea successiva, e non dal contenuto della linea precedente stessa.

Soluzione: Ci potrebbero essere buone ragioni per non suddividere la stringa. In quel caso ci si adatta ai larghi spazi facendo buon viso a cattivo gioco. Altrimenti si inserisce uno spazio (oppure il carattere '-' seguito da uno spazio) al punto dove si desidera separare la stringa.

Come: Prima bisogna trovare la stringa nel file FO cercando il (o parte del) suo contenuto. Se è una stringa a spazio fisso nel PDF, molto probabilmente la si dovrebbe trovare in un elemento fo:inline. Poi, si osserva nel PDF per valutare quanta parte della stringa ancora ininterrotta entrerebbe nello spazio rimasto della linea precedente. Di nuovo nel file FO, si inserisce uno spazio, possibilmente preceduto da un “-”, nella stringa al punto in cui sembra accettabile mandarla a capo. Rigenerare il PDF (build fo2pdf !) e verificare il risultato. Se si è interrotta la stringa troppo a destra, rimane ancora tutta nella linea successiva. Troppo a sinistra e lo spazio potrebbe rimane ancora troppo largo rispetto alle proprie intenzioni. Si continua a sistemare e a ricostruire finchè non si ottiene l'aspetto desiderato.

Durante questo procedimento, si potrebbe essere sorpresi dal fatto che, una volta interrotta la stringa in un punto, Apache FOP autonomamente decide di sillabare il resto della stringa. Questo lascia una parte della stringa nella linea precedente con lo spazio aggiunto (adesso nel posto sbagliato) perchè prosegue oltre quel punto. Non resta che cancellare lo spazio che si è aggiunto e interrompere la stringa nel punto deciso da Apache.