Rendering Asciidoctor - cambio font

Buon giorno a tutti,
qualche anno fa ci incontrammo con il gruppo Linux Trent
https://www.linuxtrent.it/ per parlare della Carta Nazionale dei
Servizi, tra le varie cose che volevamo realizzare c'era della
manualistica e Marco C. ci aveva consigliato di usare Asciidoctor,
programma affascinate che ho fatto mio per tutta la manualistica che
realizzo per lavoro. Ho fatto vedere a mio figlio (laureato
all'accademia delle belle arti) uno dei miei manuali realizzato con
Asciidoctor e il sucessivo rendering in pdf e epub. Mi ha detto che il
rendering viene molto bene ma la leggibilità anche se buona è
migliorabile cambiando il font con uno più adatto alla lettura su
display e, mi ha consigliato il Titillium Web
Titillium Web - Google Fonts

Per il rendering in pdf Asciidoctor usa i fonts: Noto e Awesome
Per il rendering in epub Asciidoctorusa i fonts: Noto, Awesome, Sans
Serif e Serif

Con il seguente codice inizio i miei sorgenti .adoc

attachment.htm (5.53 KB)

26 maggio 2021 08:39, "Andrea Congiu" <congiu.andr(a)gmail.com> wrote:

Come posso fare il rendering con Ascidoctor con il font Titillium Web?

Buona giornata e grazie
andrea

Qui nella sezione "Custom font" https://www.wimdeblauwe.com/blog/2019/2019-12-20-customization-of-asciidoctor-pdf-output/ l'autore spiega i semplici passi (mi sembrano tali - non li ho provati però).

Per saperne di più c'è un rimando al manuale: https://github.com/asciidoctor/asciidoctor-pdf/blob/v1.5.0.beta.5/docs/theming-guide.adoc#custom-fonts

Ciao,
Paolo.

Ciao, grazie,
per me è il problema dell'inglese, non capisco le spiegazioni.

Ciao
andrea

attachment.htm (3.73 KB)

26 maggio 2021 09:02, "Andrea Congiu" <congiu.andr(a)gmail.com> wrote:

Ciao, grazie,
per me è il problema dell'inglese, non capisco le spiegazioni.

Ciao
andrea

*Font personalizzati*

La Theming Guide entra in grande dettaglio su come usare i font personalizzati con l'esportazione in PDF. Per essere assolutamente sicuro che il tuo font funzioni in tutte le condizioni, devi preparare il font. Tuttavia, abbiamo appena preso un font da Google fonts e le cose hanno funzionato.

Per il nostro esempio, useremo Open Sans, un font sans serif dall'aspetto moderno. Per iniziare, scarica il font e copia queste 4 varianti in src/main/asciidoc/fonts rinominandole:

OpenSans-Regular.ttf → opensans-normal.ttf
OpenSans-Italic.ttf → opensans-italic.ttf
OpenSans-Bold.ttf → opensans-bold.ttf
OpenSans-BoldItalic.ttf → opensans-bold_italic.ttf
Configurare pdf-fontsdir in modo che il plugin Maven sappia dove trovare i font:

<configurazione>
    <doctype>book</doctype>
    <backend>pdf</backend>
    <attributi>
        <pdf-stylesdir>${progetto.basedir}/src/main/asciidoc/theme</pdf-stylesdir>
        <pdf-style>pegus-digital</pdf-style>
        <pdf-fontsdir>${progetto.basedir}/src/main/asciidoc/fonts</pdf-fontsdir>
    </attributi>
</configurazione>
Successivamente, configurare i font nel tema:

font:
  catalogo:
    Noto Serif:
      normale: GEM_FONTS_DIR/notoserif-regular-subset.ttf
      grassetto: GEM_FONTS_DIR/notoserif-bold-subset.ttf
      corsivo: GEM_FONTS_DIR/notoserif-italic-subset.ttf
      grassetto_italico: GEM_FONTS_DIR/notoserif-bold_italic-subset.ttf
    # M+ 1mn supporta l'ASCII e i numeri cerchiati usati per i conum.
    M+ 1mn:
      normale: GEM_FONTS_DIR/mplus1mn-regular-subset.ttf
      grassetto: GEM_FONTS_DIR/mplus1mn-bold-subset.ttf
      corsivo: GEM_FONTS_DIR/mplus1mn-italic-subset.ttf
      grassetto_italico: GEM_FONTS_DIR/mplus1mn-bold_italic-subset.ttf
    OpenSans:
      normale: opensans-normal.ttf
      corsivo: opensans-italico.ttf
      grassetto: opensans-bold.ttf
      bold_italic: opensans-bold_italic.ttf
Nota che dobbiamo dichiarare anche i font originali nel catalogo dei font!

Infine, usa il font dichiarato:

base:
  font_family: OpenSans
heading:
  font-family: OpenSans
h2:
  font-color: '#da3131'
letterale:
  font_color: '#da3131'
Questo risulta in un PDF con il font OpenSans utilizzato:

immagine 7
https://www.wimdeblauwe.com/images/2019/10/image-7.png

Qui stiamo usando OpenSans per il contenuto di base e le intestazioni, ma usando lo stesso meccanismo, si possono avere font diversi per le intestazioni e il contenuto.

Tradotto con www.DeepL.com/Translator (versione gratuita)

26 maggio 2021 09:02, "Andrea Congiu" <congiu.andr(a)gmail.com> wrote:

Ciao, grazie,
per me è il problema dell'inglese, non capisco le spiegazioni.

Ciao
andrea

Un copia-incolla un po' più serio (prima aveva tradotto anche le configurazioni :slight_smile:

*Font personalizzati*

La Theming Guide entra in grande dettaglio su come usare i font personalizzati con l'esportazione in PDF. Per essere assolutamente sicuro che il tuo font funzioni in tutte le condizioni, devi preparare il font. Tuttavia, abbiamo appena preso un font da Google fonts e le cose hanno funzionato.

Per il nostro esempio, useremo Open Sans, un font sans serif dall'aspetto moderno. Per iniziare, scarica il font e copia queste 4 varianti in src/main/asciidoc/fonts rinominandole:

OpenSans-Regular.ttf → opensans-normal.ttf
OpenSans-Italic.ttf → opensans-italic.ttf
OpenSans-Bold.ttf → opensans-bold.ttf
OpenSans-BoldItalic.ttf → opensans-bold_italic.ttf
Configurare pdf-fontsdir in modo che il plugin Maven sappia dove trovare i font:

<configuration>
    <doctype>book</doctype>
    <backend>pdf</backend>
    <attributes>
        <pdf-stylesdir>${project.basedir}/src/main/asciidoc/theme</pdf-stylesdir>
        <pdf-style>pegus-digital</pdf-style>
        <pdf-fontsdir>${project.basedir}/src/main/asciidoc/fonts</pdf-fontsdir>
    </attributes>
</configuration>

Successivamente, configurare i font nel tema:

font:
  catalog:
    Noto Serif:
      normal: GEM_FONTS_DIR/notoserif-regular-subset.ttf
      bold: GEM_FONTS_DIR/notoserif-bold-subset.ttf
      italic: GEM_FONTS_DIR/notoserif-italic-subset.ttf
      bold_italic: GEM_FONTS_DIR/notoserif-bold_italic-subset.ttf
    # M+ 1mn supports ASCII and the circled numbers used for conums
    M+ 1mn:
      normal: GEM_FONTS_DIR/mplus1mn-regular-subset.ttf
      bold: GEM_FONTS_DIR/mplus1mn-bold-subset.ttf
      italic: GEM_FONTS_DIR/mplus1mn-italic-subset.ttf
      bold_italic: GEM_FONTS_DIR/mplus1mn-bold_italic-subset.ttf
    OpenSans:
      normal: opensans-normal.ttf
      italic: opensans-italic.ttf
      bold: opensans-bold.ttf
      bold_italic: opensans-bold_italic.ttf

Nota che dobbiamo dichiarare anche i font originali nel catalogo dei font!

Infine, usa il font dichiarato:

base:
  font_family: OpenSans
heading:
  font-family: OpenSans
h2:
  font-color: '#da3131'
literal:
  font_color: '#da3131'

Questo il risultato in un PDF con il font OpenSans utilizzato:

immagine 7
https://www.wimdeblauwe.com/images/2019/10/image-7.png

Qui stiamo usando OpenSans per il contenuto di base e le intestazioni, ma usando lo stesso meccanismo, si possono avere font diversi per le intestazioni e il contenuto.

Credo che dovrò andare avanti come sto facendo,

tutte queste informazioni non riesco a capire come applicarle. Sono
nozioni troppo avanzate. Dovrei trovare una persona che mi aiuti a
realizzare un esempio pratico.

Grazie comunque.
andrea

attachment.htm (3.71 KB)

Ci si può provare, ad aiutarti, dai ...
diego

attachment.htm (5.09 KB)