Libri di pagine composte

Costruisci una pagina di un libro di testo a partire da un modello, la riempi con il testo del Markdown, etichetti una mappa, traduci la pagina e sistemi ciò che non entra.

La pagina di un libro di testo scolastico è un insieme di riquadri: una fascia per il titolo, un testo, un riquadro per una definizione, uno per un’attività, una mappa. Postext la impagina a partire da un modello di pagina che contiene i riquadri (le sue cornici), e il Markdown dice soltanto quali parole vanno in quale cornice. Questa pagina percorre tutto il lavoro nel Sandbox, su un libro che esiste già, e vi aggiunge una pagina. Le pagine di riferimento spiegano che cosa fa ogni campo e ogni riga di Markdown; qui fai ogni cosa una volta, in ordine, e vedi che cosa cambia: Pagine composte per il Markdown, Configurazione › Pagine composte per il modello, Sandbox: le pagine composte per le schermate.

Ti servono un browser e nient’altro. Ogni passo si fa nel Sandbox, e ciò che modifichi resta nel tuo browser.

#1. Aprire il libro

Il libro è Our river, un’unità di un libro di testo per la terza elementare che il Ricettario pubblica come ricetta Nº 156. Il fiume, i paesi e le immagini sono inventati per l’occasione. Ha nove pagine, con una mappa dipinta che si stende su due pagine affiancate, ed esiste in spagnolo, catalano e inglese.

Aprilo nel Sandbox. La prima volta viene aggiunto a Libri come un tuo libro, quindi puoi modificarlo liberamente; con lang=es o lang=ca nel link ottieni le altre edizioni. Se torni più tardi allo stesso link, il Sandbox chiede se aprire la tua copia o sostituirla con quella pubblicata.

Due cose da sapere prima di toccare qualcosa:

• La barra sopra l’anteprima ha un selettore con Contenuto e Grafica. In modalità Contenuto modifichi le parole, nel pannello Testo o sulla pagina. In modalità Grafica modifichi i modelli di pagina e gli stili, e il testo è in sola lettura. Alt+Maiusc+M (⌥⇧M su un Mac) passa dall’una all’altra.
• Il pannello Testo mostra un capitolo di Markdown. Ogni pagina composta è un blocco che comincia con ::::page{template="…"} e finisce con quattro due punti. Fai clic su alcune parole di una pagina nell’anteprima e il cursore va a quelle parole nel Markdown.

#2. Fare un modello di pagina

La pagina nuova sarà una pagina di ripasso: una fascia per il titolo, un testo breve sotto e due riquadri, uno per ricordare ciò che si è imparato e uno per provare. Serve un modello con quattro cornici.

1. Passa a Grafica e apri il pannello Grafica a sinistra. Scegli Pagina e colonne, poi Modelli di pagina. L’elenco mostra ogni modello del libro con un disegno delle sue cornici.
2. Premi Nuovo. Si apre un modello chiamato Nuovo modello. Dagli l’ID review (il nome che userà il Markdown) e il Nome Review page (il nome che mostra questo pannello). L’ID accetta lettere minuscole, cifre e trattini.
3. Il modello comincia con una cornice, text, che Riceve il testo libero della pagina. Trasformala nella fascia del titolo: Nome (slot): title; Stile del riquadro: portada, la fascia blu che il libro usa già per i suoi titoli; disattiva Riceve il testo libero della pagina; Riceve il primo titolo: Livello 1, così questa cornice riceve il primo titolo # della pagina.
4. Premi Aggiungi cornice. La cornice nuova si apre sotto l’elenco delle cornici. Nome (slot): text, e attiva Riceve il testo libero della pagina: ciò che la pagina scrive fuori da una cornice va qui.
5. Aggiungi una cornice. Nome (slot): remember. Stile del riquadro: dato-campo, un riquadro verde con una linguetta. Altezza minima: 30 mm, perché il riquadro mantenga una buona misura anche quando il suo testo è breve.
6. Aggiungi un’ultima cornice. Nome (slot): try. Stile del riquadro: actividad-sol. Altezza minima: 30 mm.
7. In text, remember e try imposta Larghezza su Fino al bordo e Altezza su Il suo contenuto: così occupano tutta la larghezza della pagina e sono alte quanto il loro testo.
8. Sotto Gruppi premi Aggiungi gruppo. Chiamalo column, lascialo Impilate e imposta Spazio tra le cornici su 6 mm. Sotto Cornici del gruppo, nell’ordine della pagina seleziona le quattro cornici. Il gruppo le tiene nell’ordine dell’elenco delle cornici, quindi il titolo è il primo. Un gruppo dispone le sue cornici una sotto l’altra e sposta quelle in basso quando una cornice cresce: un testo più lungo nel primo riquadro spinge giù il secondo invece di finirgli sopra.

(si apre in una nuova scheda)

Il modello non contiene parole. Nulla di ciò che hai impostato dice qual è il titolo o che cosa contengono i riquadri: lo stile del riquadro dà alla cornice il suo aspetto, il gruppo il suo ordine. Allo stesso modello si arriva anche in altri modi. In modalità Grafica puoi disegnare con il mouse una cornice in un punto vuoto di una pagina composta e spostare o ridimensionare quelle che hai (vedi Sandbox: le pagine composte); Duplica copia un modello per modificarlo; Salva l’impaginazione come modello trasforma in un modello nuovo una pagina composta che ti piace.

#3. Riempire la pagina dal Markdown

1. Passa a Contenuto, apri il pannello Testo e premi Ctrl+Fine (Cmd+↓ su un Mac) per andare in fondo al capitolo.
2. Premi Pagina composta nella barra degli strumenti del pannello Testo. Un selettore elenca i modelli di pagina del libro, ciascuno disegnato con le sue cornici vuote. Scegli Review page.
3. Il Sandbox scrive la pagina per te, con una cornice vuota per ogni slot, e seleziona la parola title del titolo. Scrivi il titolo al suo posto.

::::page{template="review"}
# Check what you have learned
 
A river changes as it runs from the mountains to the sea. Read the boxes, then answer them in your own words.
 
:::frame{slot="remember" label="Remember"}
A spring gives a trickle, streams join into a river, and the river widens as it nears the sea.
:::
 
:::frame{slot="try" label="Try it"}
Draw a river from its spring to the sea. Write the names of the three courses on your drawing.
:::
::::

Il titolo va alla cornice che riceve il livello 1, il paragrafo che lo segue alla cornice che riceve il testo libero, e ogni :::frame alla cornice del suo slot. Il label sono le parole sulla linguetta di un riquadro. Sul canvas la pagina è la numero 10, dopo le nove dell’unità: una pagina composta comincia sempre una pagina nuova.

(si apre in una nuova scheda)

Nota ciò che il Markdown non dice: nessuna posizione, nessuna misura, nessun colore. Appartengono al modello, e lo stesso Markdown impaginato con un altro modello avrebbe un altro aspetto.

#4. Etichettare la mappa

Le pagine 6 e 7 contengono una mappa dipinta che si stende su tutta la doppia pagina. Le sue parole non fanno parte dell’immagine. Ogni nome è una riga del Markdown, dentro il :::figure della mappa:

:::figure{resource="mapa" slot="mapa"}
::label[Spring]{at="nacimiento"}
::label[Molinar]{at="molinar"}
::label[Lower course]{at="bajo"}
:::

at indica un’ancora: un punto dell’immagine, definito una sola volta nella risorsa dell’immagine e condiviso da tutte le lingue. Per aggiungere il ponte di pietra di Molinar:

1. Nel pannello Testo vai alla figura della mappa (cerca at="bajo") e aggiungi una riga sotto l’ultima etichetta: ::label[Stone bridge]{at="bridge"}.
2. Apri Verifiche. L’elenco ha una voce Etichetta su un'ancora inesistente per la pagina 6: l’immagine non ha nessuna ancora chiamata bridge. Premi il pulsante con la puntina sulla voce, Colloca l’ancora bridge sull’immagine.
3. Una finestra mostra la mappa con le ancore che ha. Il nome bridge è scelto sotto Etichette senza ancora (1). Fai clic sull’immagine nel punto in cui si trova il ponte.
4. Imposta lo Stile dell’etichetta della nuova ancora su pueblo, lo stile dei paesi, e premi Salva.

(si apre in una nuova scheda)

(si apre in una nuova scheda)

La parola Stone bridge è Markdown; il punto fa parte dell’immagine. Quando traduci la pagina, la stessa ancora riceve un’altra parola.

#5. Tradurre la pagina

Una traduzione è lo stesso modello con altre parole. Il Sandbox ha due modi per tenerla. Un libro può contenere più lingue insieme, come file .postext con un’edizione per ciascuna, e allora la barra sopra il canvas passa dall’una all’altra e il pannello Verifiche le legge tutte (vedi Edizioni di un libro). Il modo più semplice, che non richiede alcun file, è una copia del libro nell’altra lingua:

1. Apri Libri, premi ⋯ sul tuo libro e scegli Duplica, oppure premi Nuovo e scegli Copia del libro aperto. Apri la copia. Ha lo stesso nome dell’originale: cambialo con Rinomina… nello stesso menu.
2. Nel pannello Grafica apri Sistema di scrittura e, sotto Lingua e direzione, imposta la Lingua del documento. La sillabazione, le virgolette e le parole che il motore scrive da sé (come Continued al taglio di un riquadro) la seguono.
3. Nel pannello Testo traduci le parole e lascia il resto.

Le immagini, le ancore, i riquadri e i loro colori passano con la copia e non richiedono lavoro. Una copia della pagina di ripasso in spagnolo si presenta così:

::::page{template="review"}
# Repasa lo aprendido
 
Un río cambia mientras baja de las montañas al mar. Lee los recuadros y respóndelos con tus propias palabras.
 
:::frame{slot="remember" label="Recuerda"}
Un manantial da un hilo de agua, los arroyos se unen en un río y el río se ensancha al acercarse al mar.
:::
 
:::frame{slot="try" label="Inténtalo"}
Dibuja un río desde su manantial hasta el mar. Escribe en tu dibujo el nombre de los tres cursos.
:::
::::

(si apre in una nuova scheda)

#6. Sistemare ciò che non entra

Le parole hanno una lunghezza diversa da una lingua all’altra, e un riquadro che conteneva il testo inglese può non contenere quello spagnolo. Il pannello Verifiche trova quelle cornici. Per vederne una, incolla tre o quattro paragrafi in più di un testo qualsiasi nella cornice remember della pagina tradotta, in modo che contenga più di quanto la pagina può ospitare.

Ora la pagina mostra la cornice contornata di rosso, con una fascia sotto il piede che dice quanto manca (mancano 26 mm). In Verifiche, sotto Pagine composte, la voce Il testo non entra nella cornice dice che cosa ha provato l’impaginazione prima di arrendersi (più spazio dalle cornici attorno, poi un testo più piccolo) ed elenca le vie d’uscita come pulsanti:

• lascia scendere il testo al 82,5 % (fit.minScale) permette al testo di questa cornice di ridursi fino a quella misura. Va bene se le righe di troppo sono poche.
• fallo proseguire nella pagina seguente (overflow.continueIn) manda ciò che non entra in una pagina aggiunta dopo questa. Va bene per un testo più lungo.
• taglia circa 495 caratteri non cambia nulla. Seleziona il testo della cornice e ti dice quanto tagliare.

Un pulsante che modifica il modello (quindi ogni pagina impaginata con esso) chiede prima conferma, nominando l’impostazione. Premi Cambia. La pagina viene impaginata di nuovo, il riquadro finisce con la parola del taglio (Continúa) e il resto prosegue in cima a una pagina aggiunta. Cmd/Ctrl+Z annulla la modifica. Spostamenti, nella barra sopra il canvas, apre Che cosa si è spostato e perché: le cornici di cui l’impaginazione ha cambiato la misura o il posto per far entrare il contenuto, con il motivo a parole.

(si apre in una nuova scheda)

#7. Selezionare sulla pagina e nel testo

La pagina e il suo Markdown si seguono a vicenda.

• Dalla pagina al testo. Fai clic sulle parole di una cornice: il cursore va a quel paragrafo nel pannello Testo, e un percorso sotto l’anteprima dice dove ti trovi (Pagina 10 › column › try › paragrafo 1). In modalità Grafica lo stesso clic sceglie invece la cornice per l’editor dei modelli.
• Dal testo alla pagina. Metti il cursore in un paragrafo e sulla pagina vengono contornati la cornice che lo contiene e il paragrafo stesso, e lo stesso percorso dice dove si trovano.
• Da una verifica. Fai clic su una voce del pannello Verifiche e il Sandbox ti porta alla pagina, sceglie la cornice e mette il cursore sul suo testo. In un libro con più edizioni passa all’edizione che ha il problema.
• Sulla linguetta di un riquadro. Fai doppio clic: sopra di essa si apre un campo per il label. Invio conserva la modifica, Esc la abbandona.

(si apre in una nuova scheda)

#Dove andare dopo

• Spostare un libro nelle pagine composte: un libro che tiene il testo delle sue pagine negli stili può averlo spostato nel Markdown.
• Pagine composte: ogni attributo del recinto di pagina, della figura e delle righe di etichetta, come viene composta una pagina e ogni avviso con la sua correzione.
• Configurazione › Pagine composte: ogni campo di un modello, di una cornice e di un gruppo, l’ereditarietà e le doppie pagine.
• Sandbox: le pagine composte: le schermate per i modelli, gli stili delle cornici, le verifiche in ogni edizione e le correzioni.