Pagine

Visualizzazione post con etichetta HTML. Mostra tutti i post
Visualizzazione post con etichetta HTML. Mostra tutti i post

2026-10-17

Libri, pubblicazioni e formule - 2


Benvenuti a questa seconda parte, che riassumono i problemi incontrati per creare un libro con molte formule matematiche. La prima parte, con le scelte di partenza, la trovate qui:

Pubblicazioni e formule

Quindi, riassumo i punti ottenuti:

  • abbandonato in questo caso LaTeX, non per problemi non risolvibili, ma perché le piattaforme di pubblicazione (e gli utenti) preferiscono il formato ePUB, per i lettori tipo Kindle e altri, mentre i pdf, anche se più belli a vedersi, sono statici, non potendosi adattare a una finestra qualunque;
  • il passaggio da LaTeX ad ePUB non è una trasformazione così semplice e può convenire, anche se con un certo lavoro, a chi ha già una certa mole di roba scritta in LaTeX;
  • ho scelto Quarto, un software basato sul markdown, che accetta le formule in LaTeX; l'uscita può avvenire in contemporanea in più formati dagli stessi file;
  • le formule vengono trasformate in ePUB (html) usando mathml e questo soddisfa le richieste di Apple Books; ma con altri reader più datati, bisogna sostituirle con immagini SVG;
  • a quanto sembra, solo passando da LaTeX si possono ottenere gli SVG, ma non voglio un'intera installazione LaTeX solo per quello, per cui andiamo su un contenitore docker, che contiene tutto il necessario.

Il contenitore

Partiamo col costruire un file chiamato dockerfile che crei una macchina minimale contenente le parti necessarie di LaTeX, per le nostre formule; evitiamo la TeXLive completa, inserendo quello che potrebbe servire. Parto da un Ubuntu:

FROM ubuntu:22.04 ENV DEBIAN_FRONTEND=noninteractive

Ora introduciamo le sezione di LateX che supponiamo utili (possiamo fidarci di quanto ci fornisce il package manager di Ubuntu):

RUN apt-get update && apt-get install -y \ texlive-latex-base \ texlive-latex-extra \ texlive-science \ texlive-extra-utils && rm -rf /var/libe/apt/lists/* WORKDIR /data

Una volta che tutto funzionerà, si potrà provare a togliere qualcosa, per ottenere l'installazione minima. Però mancano ancora due pezzi: il primo è dvisvgm che è il nucleo della trasformazione in SVG e poi gladtex, un pre-processore che fa il passaggio intermedio, evidenziando con il tag <eq> le formule da trasformare e poi le sostituisce con le immagini tornate. Entrambi sono disponibili dal package manager, per cui alla fine il nostro dockerfile è

FROM ubuntu:22.04 ENV DEBIAN_FRONTEND=noninteractive RUN apt-get update && apt-get install -y \ gladtex \ texlive-latex-base \ texlive-latex-extra \ texlive-science \ texlive-extra-utils \ dvisvgm \ && rm -rf /var/lib/apt/lists/* WORKDIR /data ENTRYPOINT ["gladtex"]

La configurazione

La costruzione del container è stata la parte più semplice. Ora però dobbiamo riprendere i file markdown e metterli assieme usando la configurazione del libro, che per Quarto significa costruire il file _quarto.yml (la sottolineatura iniziale è voluta):

project: type: book # tipo di progetto output-dir: _output # cartella di uscita dei vari formati book: title: "Problemi di Fisica" subtitle: "Un sottotilo furbo" cover-image: cover.png author: "Proprio Me Stesso" date: "2026-01-01" language: it # utile in certi casi

Questa parte indica che si tratta di un libro, con il suo titolo, autore, copertina, ecc... Bisogna notare che il file .yml prevede che ogni rientro sia esattamente di 2 spazi e che non vuole i tabulatori.

Segue poi la struttura del libro, suddiviso in capitoli e, volendo, anche parti (la faccio semplice):

# Struttura del libro - ogni file con il suo percorso chapters: - index.qmd # cartella principale, accanto a _quarto.yml - part: "Prima parte" chapters: - cartella/misure.qmd # all'interno di una cartella - cartella/altra_cartella/cinematica.qmd # cartella al secondo livello format:

dove la parola chiave chapter è al livello di language: it.

Ora c'è il bello di Quarto: dopo la parola chiave format: possiamo inserire informazioni relativi ai formati che vogliamo in uscita; l'uscita html è utile per avere un preview rapido praticamente identico all'ePUB (che, abbiamo detto, è in sostanza un html):

html: # metodo matematico da usare - conosciuto da tutti i browser html-math-method: mathml # figura PNG alla stessa risoluzione dell'ePUB fig-format: png fig-dpi: 300 # tema minimo sans-serif, simile a un e-reader, chiaro o scuro theme: light: flatly dark: darkly # Navigazione toc: true # vogliamo l'indice... toc-depth: 3 # ...fino al terzo livello... toc-tutle: "Indice" # ...con questo titolo number-sections: true number-depth: 3 # se necessario inseriamo un foglio di stile aggiuntivo se non piace qualcosa css: stili.css

Il formato html è utile per avere un aggiornamento a colpo d'occhio; in VS Code è possibile tenerlo aperto affiancato al file che sto modificando e si aggiorna ogni volta che viene salvato il file. Se volessimo mostrare il libro su un sito apposito, non dobbiamo preoccuparci dei comandi html: l'uscita è completa di tutto, anche del javascript per l'indice, i passaggi da una sezione all'altra e persino per la ricerca all'interno del sito. Stiamo usando il formato Mathml per le formule perché riconosciuto normalmente da tutti i browser moderni; il più comodo MathJax, che accetterebbe direttamente il LaTeX, avrebbe bisogno di una libreria aggiuntiva.

Potremmo anche volere in uscita un pdf, dove la chiave (al posto di html) è typst: come detto nella prima parte, typst può creare un pdf da solo, usando però un linguaggio diverso da LaTeX, ma pandoc si occupa di tutto. Un pdf può essere utile quando vogliamo rileggere il documento, inserendo annotazioni, sottolineature e altro (sul computer o su un tablet un pdf è più semplice da annotare); è possibile inserire in questo formato anche un eventuale file di preambolo. Ma andiamo a quello che ci serve: passiamo al formato ePUB per i lettori tipo Apple Books o che comunque supportano la matematica con Mathml nativo:

# ------- # ePUB per Apple Books - Mathml # ------- epub: output-file: "Problemi_di_Fisica.epub" # nome del file finale toc: true toc-depth: 3 number-sections: true html-math-method: mathml # questo è importante epub-cover-image: cover.jpg title-page: true fig-format: png dpi: 300 css: stili.css epub-version: 3

Ho inserito gli stessi comandi di prima, così html e ePUB dovrebbero essere molto simili e mi basta vedere il primo mentre scrivo. Questa uscita porta ad un ePUB che, su un Mac, è facilmente controllabile caricandolo su Apple Book oppure su Calibre. Come scritto nella configurazione, ci affidiamo alle formule trasformate da Quarto (in realtà è pandoc a farlo) in formato Mathml e l'e-reader, basandosi su un motore web (WebKit per Apple Books), ci mostra le formule con un buon risultato visivo.

Ora passiamo invece al formato che dobbiamo usare per poter essere letti anche su Kindle piuttosto vecchi, cioè usando immagini SVG delle formule; definiamo un formato apposito, che chiamo epub+kindle cominciando ad inserire i soliti dati comuni:

epub+kindle: output-file: "Problemi_di_Fisica_Kindle.epub" toc: true toc-depth: 3 number-sections: true title-page: true epub-cover-image: cover.jpg fig-format: png dpi: 300 css: math_style.css # usato soprattutto per il posizionamento delle formule epub-version: 3 # html-math-method: plain # pandoc-args: # - "[--gladtex]"

Ho aggiunto le ultime tre righe commentate perché sono quelle consigliate un po' dappertutto, che però non raggiungono il risultato: in pratica, dicono di non usare alcun metodo per le formule e passare l'argomento --gladtex a pandoc, quando viene chiamato da Quarto. In realtà, questo argomento non fa eseguire gladtex: si limita a racchiudere le formule in tag XML del tipo <eq env="math"> o <eq env="displaymath">, a seconda che si tratti di una formula all'interno di una riga di testo o sia una formula centrata sulla propria riga; tutto questo viene inserito nell'output html, lasciando la compilazione vera e propria ad un successivo passaggio.

In teoria, dovremmo ora fare una chiamata al compilatore LaTeX per ogni formula, che tramite dvisvgm ci ritorna la figura in SVG, da richiamare nel codice html. Chiaro che non possiamo farlo a mano per ogni formula! Ecco allora che useremo un filtro scritto in Lua che faccia tutto quello che serve da solo e per tutte le formule. Quindi aggiungiamo la chiamata al filtro nel file di configurazione di Quarto e inseriamo alcune cose utili per tutti i formati:

filters: - math-svg.lua # impostazioni generali fig-width: 6 fig-height: 4 fig-align: center editor: visual crossrefs-hover: true # importante, da non dimenticare

Ma non voglio far diventare troppo lungo questo post: il finale alla prossima puntata, in cui vedremo il filtro da applicare e come chiamare la macchina dentro il contenitore docker, facendogli compilare la formula e trasformandola in SVG.

Alla prossima!

2024-12-23

HTML: tag poco noti - sulle traduzioni

L'attributo TRANSLATE

Molti browser sono in grado di riconoscere in che lingua è stato scritto il testo di una pagina; allora, usando qualcuno dei servizi web (il più famoso è ovviamente quello di Google) possono fornire la pagina tradotta nella lingua preferita dall'utente, che avrà inserito questa informazione nelle preferenze del browser stesso.

Bisogna dire che ultimamente, tramite anche l'uso di un po' di AI, queste traduzioni stanno diventando leggibili, talvolta non ci accorgiamo nemmeno che la pagina originale è in una lingua completamente differente dalla nostra.

Però non sempre la traduzione completa è la cosa migliore è nei casi comuni i vari servizi fanno già una buona filtratura: la frase in inglese "pick the mouse and draw something on the screen" viene tradotta, giustamente come "prendi il mouse e disegna qualcosa sullo schermo"; d'altra parte, la frase "the cat caught the mouse" è tradotta come "il gatto ha preso il topo": il traduttore si è accorto che i due contesti sono differenti: nel primo caso ha riconosciuto che si trattava del dispositivo di puntamento di un computer, mentre nel secondo il riferimento indicava proprio l'animale. Allo stesso modo, il traduttore verso il francese sa invece che il mouse viene tradotto con souris, stesso nome dell'animale; quindi anche la lingua può essere importante.

Da notare che fino a poco tempo fa non era così scontato: qualcuno si ricorderà delle istruzioni di pulizia dei mouse, in cui si diceva "pulire la palla del topo"...

Tuttavia non sempre la procedura riesce a comprendere tutto alla perfezione, o addirittura qualche volta siamo noi che vorremmo che certe parole non fossero tradotte: per esempio, in una pagina pubblicitaria non voglio che il nome del prodotto, registrato esattamente in quel modo, venga mai tradotto. Sotto Natale (non so perché solo allora) compaiono pubblicità di profumi, in cui si usa il sostantivo francese parfum nel nome del prodotto anche in italiano. Qui diventa difficile anche per l'AI. Ed è qui che entra in gioco l'attributo translate.

È un attributo che può essere inserito in qualunque tag contenga del testo; se non presente, il valore di default è yes ed il testo contenuto al suo interno viene tradotto normalmente dal browser (o meglio, dal servizio invocato dal browser. Ma se invece viene inserito con valore no, il testo contenuto viene lasciato in originale, non tradotto:

<p translate='no'>Questo testo non viene tradotto</p>

Non è di uso frequente, ma qualche volta può essere utile, anche come indizio di professionalità di chi ha costruito il sito. È supportato da tutti i maggiori browser.

2024-12-09

HTML Tag poco noti...: DETAILS/SUMMARY

Questo è un altro tag (o meglio, una coppia di tag) piuttosto dimenticati, nonostante siano disponibili su tutti i browser da qualche anno.

Supponiamo di voler presentere presentare una pagina piuttosto ordinata, con eventualmente la possibilità di vedere dettagli e annotazioni non necessari ad una prima lettura. Penseremo certamente al famoso triangolino che, cliccato, ruota su se stesso ed apre uno spazio in cui compaiono i dettagli. Si tratta di un'interfaccia a cui ci hanno abituati il Finder del Mac e l'Explorer di Windows, per non parlare di Linux.

In questi casi, bisognava costruire "a mano" quello che serviva: il triangolino (una figura) seguita dal titolo; una funzione javascript si occupava di impostare a visibile la regione nascosta (di solito un <div>) e di sostituire il triangolino con la sua versione "aperta"; un secondo click faceva il contrario, nascondendo la regione e riportando il triangolo nella posizione chiusa. Trattandosi di un click sullo stesso oggetto, la funzione doveva prima stabilire se la condizione iniziale fosse aperta o chiusa. Nulla di trascendentale, però si trattava comunque di un certo numero di righe da scrivere.

Dal 2020 con i maggiori browser conosciuti non è più necessario tutto questo giro: basta inserire il tag <details>, che si occupa di aprire e chiudere il suo contenuto e aggiornare l'immagine del triangolino. Il tag  <summary> al suo interno presenta il titolo che dobbiamo cliccare per aprire e chiudere: il codice più semplice è il seguente:

<details>
<summary>Informazioni</summary>
Questa è l'informazione che viene mostrata.
</details>

Senza necessità di alcun javascript, questo codice porta al seguente effetto (cliccare sul triangolino):

Informazioni Questa è l'informazione che viene mostrata.

Il tag <summary> deve essere il primo a comparire all'interno del <detail>: se non c'è o non è il primo, il browser inserisce un suo default (di solito sarà qualcosa simile a Details).

Naturalmente, si possono poi stilare i componenti:

summary {
font-weight: bold;
color: red;
}

details {
border: 1px solid black;
border-radius: 4px;
padding: 4px;
color: gray;
}

details[open] summary {
color: blue;
}

ottenendo come risultato:

Informazioni Questa è l'informazione che viene mostrata.

Come si vede, è possibile mostrare stili differenti usando il termine [open] per indicare la situazione di aperto. È anche possibile far partire la pagina con i dettagli aperti, introducendo l'attributo open (se si vuole che parta chiuso, non lo si mette e basta: open = false non funziona!).

Ogni volta che un <summary> viene cliccato e quindi viene cambiato lo stato open/close, viene generato un evento toggle, che possiamo usare per aggiungere azioni.

Inoltre, possiamo creare una lista di tag <details> e se tutti hanno lo stesso attributo name="xyz", allora il broser si occupa anche di mostrare aperto solo uno della lista: cliccando su uno chiuso, questo viene aperto ed il precedente viene chiuso, tutto in automatico.

Ultima cosa: il tag <summary> viene preparato come un elemento di una lista (display:list-item), per cui è possibile usare le proprietà conseguenti per esempio per inserire icone diverse dal triangolino. Però non è possibile inserire l'animazione di apertura/chiusura, che col metodo vecchio veniva aggiunta tramite javascript. 

2024-11-24

HTML Tag poco noti...: DIALOG

Oggi esistono molti framework che permettono di costruire un sito o un'app usando linguaggi di alto livello, che quindi prescindono da una conoscenza puntuale di HTML. Tuttavia sapere quali sono le possibilità a propria disposizione è sempre utile ed usare sempre un framework che costruisce le cose significa anche da un lato fidarsi completamente e dall'altro non avere possibilità di introdurre cose nuove.

Con la solito filosofia di scrivere le cose qui allo scopo di ricordarle... riporto alcuni tag poco noti o usati in modo diverso dal solito, cominciando dal primo, di cui fino a poco tempo fa non conoscevo l'esistenza.

Dialog

Per far comparire un dialogo spesso si costruisce un <div> nascosto, cambiandone la visibilità quando necessario, oppure usando l'interfaccia di jQueryUI. È invece possibile fare tutto da HTML + CSS + JS; il codice della pagina si presenta molto semplice; quello che segue mostra un dialogo modale che presenta semplicemente un messaggio:

HTML

<dialog id="dialogo">
<p class="message">Sto avvisando l'utente</p>
<button id="closeButton">Ok, ho capito</button>
</dialog>

Javascript

const dialog = document.getElementById("dialogo");
const openButton = document.getElementById("openButton");
const closeButton = document.getElementById("closeButton");

//evento click di apertura del pulsante esterno al dialogo
openButton.addEventListener("click", () => {
dialog.showModal();
})

//evento click di chiusura del pulsante interno al dialogo
closeButton.addEventListener("click", () => {
dialog.close();
})

Avendo chiamato la .showModal(), il dialogo (alla fine, il browser) impedisce ogni azione sulla pagina sottostante, eliminando la necessità di porre al di sotto uno strato che intercetti il mouse. Se vogliamo che lo sfondo venga in qualche modo nascosto o ridotto in importanza (dato che non è attivo), possiamo usare lo pseudo-elemento ::backdrop; un esempio di foglio di stile minimale:

CSS

#dialogo {
border-radius: 5px;
}
#dialog::backdrop {
opacity: 0.8;
}

Se invece il metodo di apertura fosse stato .show(), allora il dialogo sarebbe stato non modale: la pagina sarebbe stata libera di interagire con l'utente (niente ::backdrop!), con tutti gli eventuali problemi (e soluzioni!) che arrivano in quel modo (tra questi, la necessità di poter individuare bene il dialogo e la possibilità di spostarlo col mouse).

Usare i risultati

Dialoghi con il solo pulsante di chiusura sono utili per comunicare un evento, con la sola necessità di sapere che l'utente l'abbia visto. Ma spesso è necessario avere una risposta dall'utente, per esempio quando ha appena richiesto la cancellazione di un elemento; è allora necessario un ritorno alla chiusura del dialogo.
Questo passaggio avviene tramite la variabile del Dialogo .returnValue: normalmente contiene il pulsante che ha lanciato il metodo .close() del dialogo (cioè il pulsante con cui si è chiuso il dialogo). All'evento di chiusura si otterrà il risultato del dialogo:

Javascript

//evento di chiusura del dialogo
dialog.addEventListener("close", () => {
doSomething(dialog.returnValue) //usiamo il risultato per qualcosa
})

Se abbiamo bisogno di più informazioni oltre al pulsante premuto (magari nel dialogo c'era un campo di testo e un menu) allora all'interno del dialogo dovrà essere previsto un form, che ci aiuterà a riportare indietro tutti i valori che ci servono.

Disponibilità

Il tag dialog e le sue funzionalità sono disponibili dal marzo 2022 e framework non aggiornati non lo usano. Tuttavia, è una funzionalità ormai assodata e accettata da tutti i browser moderni.

2019-08-02

Parametri negli URL

Può capitare di dover conoscere la query presente nell'indirizzo del browser: sono disponibili alcuni plugin di jQuery per questo compito (p.es. jsurl), ma ora è possibile ottenere il tutto tramite javascript puro, usando l'oggetto URLSearchParams e location.search.

var parametriURL = new URLSearchParams(location.search);
// location.search fornisce la stringa di query
// p.es. ?id=200&param=prova

Da questo oggetto posso ottenere un po' di informazioni:

// esiste il parametro id?
parametriURL.has("id") // true

// che valore assume il parametro 'param'?
parametriURL.get("param") // prova

Se invece vogliamo tutta la stringa di query:

parametriURL.toString() // id=200&param=prova