# Sandbox

> Com és la interfície del Sandbox: la barra d'activitats; els taulers Text, Llibres, Capítols, Recursos i Fonts, i la disposició de la pantalla als mòbils

- Versió HTML: https://postext.dev/ca/docs/sandbox
- Última actualització: 2026-11-10
- Temps de lectura: 34 min
- Altres idiomes: [en](https://postext.dev/en/docs/sandbox.md), [es](https://postext.dev/es/docs/sandbox.md), [de](https://postext.dev/de/docs/sandbox.md), [fr](https://postext.dev/fr/docs/sandbox.md), [it](https://postext.dev/it/docs/sandbox.md), [pt](https://postext.dev/pt/docs/sandbox.md), [zh](https://postext.dev/zh/docs/sandbox.md), [ja](https://postext.dev/ja/docs/sandbox.md), [ar](https://postext.dev/ar/docs/sandbox.md)

## En poques paraules

El Sandbox és una eina gratuïta d'aquest web per provar Postext sense instal·lar res. Escrius el text a una banda i veus les pàgines acabades a l'altra, i canvien mentre escrius. Aquesta pàgina explica les parts de la pantalla i els taulers on escrius el text, organitzes llibres i capítols, afegeixes imatges i tries els tipus de lletra. Altres pàgines expliquen els paràmetres de disseny, les previsualitzacions, com desar i importar, i com posar el Sandbox al teu web.

**Un entorn interactiu per al motor de maquetació de Postext.**

El Sandbox t'ofereix una interfície d'editor on escrius el text, gestiones els recursos i les fonts, ajustes el disseny i veus el resultat en temps real en cinc previsualitzacions sincronitzades: **canvas**, **PDF**, **Folio** (el llibre imprès en 3D), **HTML** i **EPUB 3**. Una sisena pestanya, **SCORM**, empaqueta els capítols i les seccions que triïs per a un sistema de gestió de l'aprenentatge. Està pensat per experimentar: pots canviar la tipografia o el nombre de columnes, provar diferents col·locacions de les figures i veure com respon el motor. Els taulers fan servir paraules de l'ofici editorial (llibres, figures, requadres, capçaleres) en lloc de termes del motor, de manera que qui ve del món del llibre s'hi orienta sense conèixer l'esquema de configuració. Tots els controls es poden fer servir amb el teclat i amb lectors de pantalla.

## Disposició de la interfície

El Sandbox té tres àrees principals: una **barra d'activitats** estreta per canviar de tauler, una **barra lateral** redimensionable amb el tauler actiu i, a la dreta, una **àrea de previsualització** amb les pestanyes de previsualització. Les capçaleres dels taulers, la barra de pestanyes de l'àrea de previsualització i la cel·la del logotip, a dalt de la barra d'activitats, tenen la mateixa alçada, de manera que la franja superior es veu com una sola línia que travessa la finestra.

![El Sandbox amb el tauler Text obert a l'esquerra, que mostra el Markdown d'un llibre, i el canvas a la dreta, amb una doble pàgina on un mapa ocupa les dues pàgines.](https://postext.dev/docs-shots/ca/sandbox-layout.webp)

*Les tres àrees: la barra d'activitats, el tauler Text a la barra lateral i el canvas a l'àrea de previsualització.*

### Barra d'activitats

Una franja estreta a la vora esquerra té un botó per tauler. Cada botó mostra una icona amb el nom a sota, d'una sola paraula, i una descripció més llarga en passar-hi el ratolí (aquesta mateixa descripció és la descripció accessible del botó). De dalt a baix:

- **Llibres** (icona `Files`): els teus llibres i els llibres d'exemple
- **Capítols** (icona `BookOpen`): el llibre obert i els seus capítols
- **Text** (icona `FileCode`): escriu i corregeix el text del capítol actual
- **Recursos** (icona `FolderOpen`): imatges, dibuixos SVG i taules que fa servir el llibre
- **Fonts** (icona `Type`): els tipus de lletra que fa servir el llibre i els teus propis fitxers de font
- **Disseny** (icona `Settings2`): paràmetres de pàgina, tipografia, encapçalaments, figures, requadres i exportació
- **Revisió** (icona `AlertTriangle`): problemes de composició trobats a la maquetació. La icona porta un distintiu amb el nombre d'avisos actuals, que s'actualitza en directe i arriba com a màxim a `99+`.

Si fas clic al botó del tauler actiu, la barra lateral es replega, i si fas clic a un altre botó, passes a aquell tauler. La barra és una sola parada de tabulació: les fletxes (↑ / ↓, que tornen a començar en arribar a l'extrem), **Inici** i **Fi** mouen el focus entre els botons, i Retorn o Espai obren el tauler que té el focus.

Al peu de la barra, **Botons i camps grans** fa que tots els botons i camps del Sandbox facin com a mínim 44 × 44 px (WCAG 2.5.5). El navegador recorda la tria; mentre no en facis cap, està activat amb una pantalla tàctil i desactivat amb un ratolí. L'aplicació amfitriona pot afegir elements propis a la barra: un **enllaç amb el logotip d'inici** opcional a la cel·la superior (mitjançant les props `homeUrl` o `homeLink`), i un **commutador de tema** i un **selector d'idioma** a la part inferior, sota aquest interruptor. Els llibres complets s'intercanvien com a fitxers `.postext` des del tauler Llibres, i les capçaleres dels taulers Text i Disseny exporten la seva pròpia part (consulta [Exportar i importar](https://postext.dev/ca/docs/sandbox-books-saving.md#exportar-i-importar)).

### Modes Contingut i Disseny

La barra que hi ha sobre la previsualització comença amb un commutador entre les dues maneres de treballar en un llibre:

- **Contingut**: s'edita el text, al tauler Text i damunt de les pàgines. Els marcs d'una pàgina composta es queden on els posa la plantilla.
- **Disseny**: s'editen les plantilles de pàgina i els estils. El tauler Text mostra el capítol només per llegir, amb una nota i un botó **Editar el text**, i la barra d'eines queda desactivada. Un clic en un marc d'una pàgina composta selecciona aquest marc per a l'editor de plantilles en lloc de col·locar-hi el cursor.

**Alt+Maj+M** (**⌥⇧M** en un Mac) canvia de mode des de qualsevol lloc del Sandbox. Si passes a Disseny amb el tauler Text obert, s'obre el tauler Disseny, i en tornar s'obre de nou el tauler Text. El navegador recorda el mode. Els agents el llegeixen i el canvien amb `sandbox_set_view` (`mode`).

![La mateixa doble pàgina en mode Disseny: el tauler Disseny a l'esquerra amb els grups de paràmetres, i la pàgina amb contorns discontinus sobre els marcs i un punt a cada rètol del mapa.](https://postext.dev/docs-shots/ca/sandbox-modes.webp)

*Mode Disseny: la barra lateral llista els paràmetres, i la pàgina dibuixa els marcs i l'àncora de cada rètol.*

### Desfer i refer

El Sandbox desa un sol historial per al text i el disseny del llibre obert. **Cmd/Ctrl+Z** desfà l'últim canvi, sigui del tipus que sigui: el que s'ha escrit al tauler Text, una edició feta damunt de les pàgines (una vinyeta de còmic redimensionada, un rètol desplaçat), un paràmetre canviat al tauler Disseny, un marc arrossegat o una plantilla de pàgina afegida en mode Disseny. **Maj+Cmd/Ctrl+Z** (o **Ctrl+Y**) el refà. Les tecles funcionen a qualsevol lloc del Sandbox excepte dins d'un quadre de text, que té el seu propi historial per al que s'hi escriu. Els botons **Desfer** i **Refer**, al costat del commutador Contingut / Disseny, i els dos primers botons de la barra del tauler Text fan servir el mateix historial, i el lector de pantalla anuncia què s'ha desfet.

- Un gest és un sol pas: un control lliscant arrossegat, un color triat arrossegant o un nombre escrit xifra a xifra compten una sola vegada, sempre que les pauses no passin d'un segon. Cada cop que es deixa anar un marc és un pas a part.
- Cada capítol conserva el seu propi historial de text. Desfer un canvi de text d'un altre capítol obre aquell capítol.
- L'historial es manté en passar de Contingut a Disseny i a l'inrevés: una edició del text es pot desfer en mode Disseny, i l'arrossegament d'un marc en mode Contingut.
- Obrir un altre llibre (des del tauler Llibres, un exemple, un fitxer `.postext` o un enllaç) comença un historial nou, igual que restablir el text o el llibre sencer. Restablir només el disseny és un pas més i es pot desfer.
- Els capítols afegits, suprimits, dividits, units o moguts, els recursos i les fonts no entren a l'historial. Dura el que dura la visita: en tornar a carregar la pàgina és buit.
- Les marques d'una imatge (les àncores, la zona segura i les zones de retolació) són l'excepció entre els recursos: desar-les al tauler Recursos, o arrossegar una àncora en una pàgina, és un pas de l'historial.

Els agents desfan i refan amb `sandbox_undo` (vegeu [WebMCP](https://postext.dev/ca/docs/webmcp.md)).

### Taulers laterals

La barra lateral es pot redimensionar. Arrossega el separador entre la barra lateral i l'àrea de previsualització, o dona-li el focus amb Tab i fes servir el teclat: ← / → canvien l'amplada un 2 % (un 10 % amb Maj), i **Inici** / **Fi** salten a l'amplada mínima i a la màxima. El separador anuncia el valor actual als lectors de pantalla, i l'àrea de previsualització sempre conserva com a mínim 200 px. La barra lateral es replega del tot quan no hi ha cap tauler actiu, i l'amplada es recorda d'una sessió a l'altra.

Les files de paràmetres posen l'etiqueta al costat del control, o a sobre quan la barra lateral és estreta. Per fer-ho es fan servir *container queries*, de manera que depenen de l'amplada de la barra lateral i no de la de la finestra.

#### Tauler de text

Un editor CodeMirror 6 per al Markdown del capítol. Els lectors de pantalla l'anuncien com a *Text del capítol*. Ofereix:

- **Ressaltat de sintaxi**: encapçalaments, èmfasi, enllaços, blocs de codi i cites es distingeixen a primer cop d'ull, amb ressaltat propi per al **frontmatter YAML**, les regions de **matemàtiques LaTeX**, els **xips en línia** (`:chip[…]`: els claudàtors i els atributs queden marcats i el text del xip, tenyit), les **versaletes** (`:smallcaps[…]`: els claudàtors queden marcats i el text es mostra en versaletes), les **marques d'orientació** del text vertical (`:tcy[…]`, `:upright[…]`, `:sideways[…]`: els claudàtors marcats i el text subratllat amb punts) i les **anotacions xineses** (`:dots[…]`, `:name[…]` i `:book[…]` amb la seva marca dibuixada sota el text; `:ruby[…]{rt="…"}` i `{紅樓|hóng|lóu}`; `:warichu[…]` amb la nota en cos menor). En escriure `:do`, `:na`, `:bo`, `:ru` o `:wa` s'ofereix la directiva
- **Compleció de xips**: en escriure `:c` al principi d'un mot s'ofereix `:chip[…]` (el cursor queda entre els claudàtors). Dins de `{style="…"}` s'ofereixen els ids dels estils de xip configurats.
- **Compleció de rètols**: dins d'un `:::figure{resource=…}`, el valor de `at="…"` en una línia `::label[…]` ofereix les àncores de la imatge, cadascuna amb l'estil de rètol que aplica, i primer les que encara no tenen cap rètol a la figura. Dins de `style="…"` s'ofereixen els estils de rètol, i `::la` al principi d'una línia escriu una línia de rètol.
- **Compleció de versaletes**: en escriure `:sm` al principi d'un mot (o just després de `*` o `_`) s'ofereix `:smallcaps[…]`, amb el cursor entre els claudàtors.
- **Tabuladors**: `:tab` i `:tab{…}` es ressalten i s'ofereixen a la compleció com les altres directives en línia. La tecla Tab de l'editor no escriu un caràcter de tabulació, així que al Sandbox un tabulador s'escriu amb `:tab`; un caràcter de tabulació enganxat amb el text es conserva, i funciona com a tabulador en un paràgraf amb un estil que fixa tabulacions.
- **Números de línia** i ressaltat de la línia activa
- **Ajust de línia** per als paràgrafs llargs
- **Línies de dreta a esquerra**: una línia que comença amb una lletra àrab o hebrea va de dreta a esquerra, i el cursor i les fletxes la segueixen. El marcatge que conté (atributs `{…}`, etiquetes `[^id]`, el nom d'una directiva, un `:ref[fig-1]` sencer, fórmules, codi, destinacions d'enllaç) es manté d'esquerra a dreta, de manera que es llegeix tal com es va escriure. Les línies d'obertura i de tancament, el frontmatter i les línies que comencen amb un mot llatí continuen d'esquerra a dreta, com abans.
- **Barra d'eines**: comença amb **Desfer / Refer**, i després hi ha negreta, cursiva, encapçalaments de nivell 1–3, enllaç, codi en línia, **xip** (embolcalla la selecció en `:chip[…]`), **versaletes** (l'embolcalla en `:smallcaps[…]`), **Estil de caràcter** (`:span[…]{style="id"}`, una icona de retolador: un menú amb els estils de caràcter del llibre; en triar-ne un, la selecció queda embolcallada en un `:span` o, si la selecció és dins d'un grup, en canvia l'estil, i **Treu l'estil de caràcter** torna el grup a paraules sense estil; en escriure dins del `style="…"` d'un `:span` s'ofereixen els ids dels estils), en un llibre en xinès, japonès o coreà **Lectura ruby** (`:ruby[…]`) i **Horitzontal en text vertical** (`:tcy[…]`), cita, llistes numerades i amb pics, i cinc botons per inserir:
  - `:::pagebreak`
  - `:::space`: una línia d'espai vertical (`:::space{lines=N}` per a més)
  - **Columnes**: un grup `:::columns{count=2}` de dues columnes, amb el cursor a la primera línia, al text o en un requadre (des de postext 1.25)
  - `:::numbering{format="decimal" startAt=1}`: s'insereix amb atributs d'exemple que pots ajustar
  - **Pàgina composta**: obre un selector amb les plantilles de pàgina del llibre, cadascuna dibuixada en miniatura amb els marcs buits. En triar-ne una s'escriu un bloc `::::page{template="…"}` amb un `:::frame{slot="…"}` buit per a cada marc. Un marc que només rep el text que continua d'un altre marc no en té cap; un marc que `takes` un encapçalament rep aquest encapçalament, amb el nom del marc seleccionat per escriure-hi a sobre, i el marc de flux rep una línia en blanc per al text corregut

Un bloc de codi (una línia ```` ``` ```` o `~~~` i les línies que delimita) és una sola regió a l'editor: té un fons de codi, i el marcatge de Postext que conté (fórmules, xips, tabuladors, marques d'índex) queda sense acolorir, perquè el motor tampoc no el llegeix. L'editor també comunica el cursor i la selecció a les previsualitzacions, cosa que permet la sincronització clic-a-cursor: en fer clic al text de la sortida, el cursor salta a la posició corresponent del Markdown, i les previsualitzacions poden ressaltar la selecció actual.

La capçalera del tauler és un **selector de capítols**: fletxes anterior/següent, la posició i el títol del capítol, i un menú amb tots els capítols del llibre i el seu interval de pàgines tan bon punt se'n coneix la paginació (consulta [Llibres i capítols](https://postext.dev/ca/docs/sandbox-books-saving.md#llibres-i-capítols)). Cada capítol té la seva pròpia instància de l'editor, de manera que l'historial de desfer i la posició del cursor es conserven per capítol. La capçalera ofereix, a més, sis accions:

- **Restablir** (demana confirmació): torna a carregar la **part del document** del llibre d'exemple obert. Tots els capítols i tot el conjunt de figures se substitueixen pels de l'exemple (en l'exemple integrat, el document de mostra de la llengua i els seus recursos d'exemple). El disseny no es toca, excepte les fonts pròpies de l'exemple. Consulta [Tauler de llibres](https://postext.dev/ca/docs/sandbox.md#tauler-de-llibres).
- **Exportar**: baixa el capítol actiu com a fitxer `.md`, amb el nom `<llibre>-<nn>-<capítol>.md` en un llibre de diversos capítols i, si no, amb el del llibre obert o `document.md`
- **Importar**: substitueix el capítol actiu pel contingut d'un fitxer `.md`
- **Importar un document de Word**: obre un manuscrit `.docx` i n'assigna els estils de Word a estils de Postext abans que canviï res, o recupera les correccions fetes en un fitxer exportat des del llibre (consulta [Documents de Word](https://postext.dev/ca/docs/sandbox-books-saving.md#documents-de-word))
- **Exportar a Word**: baixa el capítol o tot el llibre com un `.docx`, semàntic (només el contingut, en estils de Word senzills) o maquetat (el mateix text editable amb el disseny del llibre); les correccions que s'hi facin tornen amb **Importar un document de Word**
- **Exporta a InDesign (IDML)**: compon el llibre sencer com ho fa el PDF i el baixa com a `<llibre>.idml`, per acabar-lo a InDesign (vegeu [Exportar i importar](https://postext.dev/ca/docs/sandbox-books-saving.md#exportar-i-importar))

#### Cerca i reemplaça

El botó **Cerca i reemplaça** de la capçalera del tauler Text, que també és a les barres d'eines de Canvas i PDF, obre una barra damunt de l'editor. Cerca en el Markdown del capítol que es veu o del llibre sencer, marques incloses, de manera que el que troba i reemplaça és el que mostra l'editor.

- **Opcions**: **Distingeix majúscules i minúscules**, **Només paraules senceres**, **Ignora els accents** i **Expressió regular**. Amb **Ignora els accents**, *celula* troba *célula*, i una paraula àrab es troba amb els signes vocàlics o sense. La ñ, la ç, la й i la ё continuen sent lletres pròpies, i els kana conserven les marques de sonorització (が no és か). El text amb els accents escrits com a signes a part es troba com si estiguessin units a la lletra. En xinès, japonès i tailandès, que no separen les paraules amb espais, **Només paraules senceres** segueix la segmentació en paraules del navegador.
- **Capítol** o **Llibre** fixa l'abast. Les coincidències es llisten per capítol amb el número de línia. Un clic en una la selecciona a l'editor i n'obre el capítol, mentre el focus es queda a la barra.
- Les **expressions regulars** són les de JavaScript, llegides amb Unicode, amb `^` i `$` als finals de línia. Al reemplaçament, de `$1` a `$99` escriuen un grup, `$<nom>` un grup amb nom, `$&` la coincidència sencera i `$$` un signe de dòlar; `\n`, `\t` i `\\` escriuen un salt de línia, un tabulador i una barra inversa. Tota la resta s'escriu tal com s'ha teclejat: amb `^Note (\d+)` i `[^$1]`, *Note 3* esdevé `[^3]`. Sense l'opció, el reemplaçament és text literal.
- **Reemplaça-ho tot** en més d'un capítol demana confirmació abans. Els reemplaçaments són un sol pas de l'historial: el botó **Desfer** que apareix a la barra, Cmd/Ctrl+Z als seus camps just després o Cmd/Ctrl+Z a qualsevol lloc del Sandbox els desfà tots.
- La cerca comença un moment després que deixis d'escriure i s'executa a part de la pàgina, de manera que un llibre llarg no alenteix l'escriptura. Per sobre de 5.000 coincidències, o quan una cerca triga massa, s'atura i ho diu, i **Reemplaça-ho tot** queda desactivat fins que s'acota la cerca. Una expressió regular que fa marxa enrere sense fi, com ara `(a+)+$` sobre una línia llarga, s'atura i s'avisa.
- En mode **Disseny** el text és només de lectura: la barra cerca, els botons de reemplaçar estan desactivats i una nota ofereix **Editar el text**.
- En un telèfon, la barra se situa a dalt del tauler Text a pantalla completa.

Les tecles, a l'editor i a la barra:

- **Cmd/Ctrl+F**: cercar al capítol (una selecció dins d'una línia passa a ser el que es cerca); **Cmd/Ctrl+Maj+F**: cercar al llibre; **Cmd/Ctrl+Alt+F**: cercar i reemplaçar.
- **Retorn** i **Maj+Retorn** al camp de cerca: coincidència següent i anterior. Des de l'editor, **Cmd/Ctrl+G** o **F3**, amb Maj per a l'anterior.
- **Retorn** al camp de reemplaçament: reemplaça la coincidència actual i passa a la següent; **Cmd/Ctrl+Alt+Retorn**: reemplaçar-ho tot.
- **Cmd/Ctrl+Z** just després d'un reemplaçament: el desfà; **Maj+Cmd/Ctrl+Z**: el refà.
- **Esc**: tanca la barra i torna al text.

Mentre un mètode d'entrada està component (xinès, japonès, coreà), Retorn i Esc són seus. Els agents fan la mateixa cerca amb `sandbox_search_text` i `sandbox_replace_text`.

#### Tauler de llibres

El primer tauler de la barra d'activitat: la galeria dels teus llibres i dels llibres d'exemple, amb el menú **Nou**, l'estat de l'última operació i la franja d'un llibre d'exemple que té una versió nova. Al codi i a l'emmagatzematge, un llibre encara es diu *projecte* (*project*), i un llibre d'exemple, *preset*.

Si fas clic en un llibre (o en una de les etiquetes de llengua d'un llibre d'exemple), s'obre i, tan bon punt és a la pantalla, la barra lateral passa al [tauler de capítols](https://postext.dev/ca/docs/sandbox.md#tauler-de-capítols). Si fas clic al llibre que ja és obert, hi passa directament. Els menús de les files (canviar el nom, duplicar, baixar, amagar, suprimir) mai no canvien de tauler. El llibre obert continua marcat a la llista. El tauler té dos grups:

- **Els meus llibres**: llibres locals i editables desats al navegador (IndexedDB). L'obert apareix marcat; els seus capítols són al tauler de capítols.

  Mentre tens obert un llibre propi, el document de treball *és* aquest llibre. Cada canvi en el text, el disseny, les figures i les fonts s'hi desa automàticament (amb el mateix retard d'1 segon que fa servir `localStorage`), de manera que pots canviar de llibre i tornar-hi sense perdre res. Els llibres es creen des del menú **Nou** de la capçalera:
    - **Còpia del llibre obert** copia el llibre obert, les seves figures i les seves fonts en un llibre nou.
    - **Llibre en blanc** en comença un de buit.
    - **Obrir un fitxer .postext…** importa un fitxer.
    - **Amb el disseny de…** en comença un de buit amb un disseny de la galeria (vegeu [Dissenys](https://postext.dev/ca/docs/sandbox.md#dissenys)).

  També pots duplicar qualsevol fila. Mentre no tinguis llibres propis, el grup mostra un missatge de llista buida amb la mateixa drecera. Cada fila té un sol menú **⋯** amb nom accessible (*Més accions de «…»*) amb **Canviar el nom…**, **Afegir una llengua…** (vegeu [Un llibre en diverses llengües](https://postext.dev/ca/docs/sandbox-books-saving.md#exportar-i-importar)), **Duplicar**, **Baixar (.postext)** i **Suprimir…**. Suprimir demana confirmació just al costat del botó ⋯.

  Canviar el nom obre en línia els camps de nom i descripció. Retorn en qualsevol dels dos confirma tots dos, i Escape cancel·la. En un llibre en diverses llengües, una casella a sota, **Només per a l'edició en …**, dona el nom només a la llengua en pantalla.

  Un llibre porta, a més, una **portada**, que apareix on un llibre d'exemple mostra la seva miniatura. En fer una còpia d'un llibre d'exemple (o d'un altre llibre), la còpia n'hereta la portada. Mentre es reanomena una fila, la portada és el control que la canvia: fes-hi clic per triar un PNG, JPEG, WebP, GIF o SVG, o fes servir la X del costat per treure l'actual. La portada és del llibre, no de les figures, i passa amb el llibre quan s'exporta i s'importa.

  Un llibre sense portada l'obté de la seva **primera pàgina** (la primera pàgina del seu primer capítol): la primera vegada que aquesta pàgina es maqueta i es pinta a la pestanya Canvas, el Sandbox en fa una imatge petita (240 px d'amplada, en JPEG) quan el navegador està desocupat, amb les fonts i les imatges de la pàgina ja carregades. Es desa com a portada del llibre, de manera que una baixada la porta com a `thumbnail` del paquet. Un llibre d'exemple que no porta miniatura obté la seva de la mateixa manera; es desa al navegador (el magatzem `presetCovers` de la base de dades IndexedDB, una per exemple i llengua), apareix a la seva fila i l'hereten les seves còpies i les seves baixades. Una portada que ja existeix mai no se substitueix, tant si ve de l'exemple, d'un fitxer importat, de la teva elecció o d'una captura anterior. Si treus la portada, es torna a prendre de la primera pàgina en una visita posterior.

  Obrir un llibre mai no demana confirmació: el llibre que deixes es desa abans, sigui quin sigui. Mentre es carrega el següent, el visor mostra *S'està obrint el llibre…* en lloc del llibre que deixes. Si suprimeixes el llibre obert, es torna a l'exemple integrat.

- **Llibres d'exemple**: punts de partida, que apareixen sota els teus llibres. El paquet en si no canvia mai, però els teus canvis en un llibre d'exemple es conserven: el primer canvi desa una còpia (el seu *esborrany*) al navegador, una per exemple i llengua, i la fila mostra l'etiqueta *Editat*. En tornar a obrir aquest exemple en aquesta llengua torna la teva versió; un exemple que no has tocat s'obre tal com es va publicar. El menú ⋯ de cada fila ofereix:
    - **Fer una còpia pròpia** converteix l'exemple en un llibre teu amb còpies pròpies dels fitxers del paquet, de manera que, si després edites el paquet al disc, el llibre no canvia.
    - **Baixar (.postext)** desa l'exemple com a fitxer `.postext`.
    - **Amagar de la llista** retira l'exemple de la llista (l'integrat no es pot amagar).
    - **Restaurar l'original…** descarta els teus canvis en l'exemple (en totes les seves llengües) i, si és obert, carrega en el seu lloc la versió publicada. Demana confirmació i només apareix en els exemples editats.

  Un exemple en diverses llengües mostra una etiqueta per llengua, en l'ordre del seu manifest: 繁 i 简 per al xinès tradicional i el simplificat, el codi de la llengua (EN, ES) per a les altres; en passar-hi el ratolí, es mostra el nom de la llengua en la llengua de la interfície (*Carregar la versió en xinès tradicional*). Un exemple amb l'original en una llengua diferent de la de la interfície (una novel·la xinesa amb traducció anglesa) indica en quina s'obre (`openLocale`, consulta [Format de paquet de preset](https://postext.dev/ca/docs/sandbox-embedding.md#format-de-paquet-de-preset)), de manera que un clic a la fila mostra l'original.

  Els exemples amagats es recullen en un desplegable *Llibres d'exemple amagats*, al final del grup, cadascun amb **Mostrar a la llista**. L'elecció es recorda a `localStorage`.

Un fitxer `.postext` obert des del menú **Nou** es converteix en un llibre nou i obert. Si el fitxer és en diverses llengües, abans pregunta en quina obrir-lo, començant per aquella en què està escrit (el `locale` del seu manifest), i el llibre les conserva totes (vegeu [Exportar i importar](https://postext.dev/ca/docs/sandbox-books-saving.md#exportar-i-importar)). Exportar és una acció de cada fila: la del llibre obert exporta el que hi ha a la pantalla. Un fitxer `.postext` és un directori de paquet de preset comprimit en zip (consulta [Exportar i importar](https://postext.dev/ca/docs/sandbox-books-saving.md#exportar-i-importar)).

Els botons Restablir dels taulers Text i Disseny restauren l'exemple a partir del qual s'ha copiat un llibre. Un llibre en blanc o importat no té original, de manera que aquests botons s'amaguen mentre és obert.

#### Tauler de capítols

El segon tauler de la barra d'activitat mostra només el llibre obert. A dalt, el seu nom, quin tipus de llibre és (*Llibre propi*, o *Llibre d'exemple* amb la seva llengua i l'etiqueta *Editat* tan bon punt el canvies) i un menú ⋯ amb les accions que s'hi poden fer: **Canviar el nom…** en els teus llibres (també amb doble clic al nom), **Duplicar** o **Fer una còpia pròpia**, **Baixar (.postext)** i **Restaurar l'original…** en un llibre d'exemple editat.

A sota, els **capítols** ocupen la resta del tauler, amb desplaçament propi (consulta [Llibres i capítols](https://postext.dev/ca/docs/sandbox-books-saving.md#llibres-i-capítols)). Cada fila de capítol mostra l'interval de pàgines i el nombre de mots, i el capítol actiu apareix marcat. Un llibre en xinès, japonès o coreà compta caràcters: cada caràcter han, kana o hangul compta un, i també cada mot llatí entre ells. **Afegir un capítol** és a la capçalera del tauler, al costat del nombre de capítols; les files es reordenen arrossegant-ne la nansa (o amb les fletxes quan la nansa té el focus), i el menú ⋯ de cada capítol ofereix **Canviar el nom del capítol**, **Pujar / Baixar**, **Dividir pels títols de nivell 1**, **Fusionar amb el capítol anterior** i **Suprimir** (l'últim capítol no es pot suprimir mai).

##### Llibres d'exemple (presets)

Un **paquet de preset** és un punt de partida complet que es carrega com una unitat: el Markdown dels capítols, un `PostextConfig`, els recursos (amb les dades de mapa de bits o SVG i els models de taula) i els fitxers de fonts personalitzades a què fa referència la configuració. El tauler llista tots els presets a què pot accedir el Sandbox i marca l'obert:

- **Preset integrat**: la *Guia de Postext*, el llibre d'exemple per defecte que acompanya el paquet. Sempre és disponible, sempre és el primer de la llista i és **públic**. És en castellà, en català, en anglès, en àrab, en xinès simplificat, en japonès, en portuguès del Brasil, en francès, en alemany i en italià (els botons ES, CA, EN, ع, 简, 日, PT, FR, DE i IT de la seva fila; `#preset=postext-guide&lang=zh-Hans` enllaça amb l'edició xinesa; `lang=ar`, amb l'àrab; `lang=ja`, amb la japonesa, i `lang=pt-BR`, amb la brasilera). L'edició àrab és un llibre àrab: de dreta a esquerra, enquadernat per la dreta, amb xifres aràbigues orientals, Amiri, Noto Kufi Arabic i IBM Plex Sans Arabic, justificació amb caixida i figures dibuixades en mirall amb rètols en àrab. L'edició xinesa té un disseny propi (Noto Serif SC i Noto Sans SC, puntuació i tall de línies de la Xina continental) i figures amb rètols en xinès. L'edició japonesa també és un llibre vertical, compost amb les regles japoneses (JLReq): Noto Serif JP i Noto Sans JP, cos de 9,25 pt en dos pisos de 34 caràcters, títols de secció que ocupen tres línies (行取り), capçaleres i folis en xifres aràbigues als marges superior i inferior, i figures amb rètols en japonès. Cada interfície obre la guia en la seva llengua. Una guia xinesa, japonesa o àrab sense tocar que s'obre des d'una altra interfície (amb el seu botó o amb un enllaç `lang=`) continua en la seva llengua sigui quina sigui la llengua de la interfície; la que ha obert per si mateixa la interfície xinesa, japonesa o àrab passa a la llengua en què es torni a obrir el Sandbox, com les altres edicions.
- **Presets remots**: paquets servits per HTTP des dels URL base que es passen a la prop `presetSources` (consulta [Props](https://postext.dev/ca/docs/sandbox-embedding.md#props)). Cada origen és públic o **privat**. Els presets privats porten l'etiqueta *Privat* a la llista i estan pensats per a material que no ha de sortir d'una màquina. El lloc web públic només llista un origen privat en desenvolupament local, on l'aplicació Next.js serveix la carpeta indicada per `POSTEXT_PRIVATE_PRESETS_DIR` a través de `/api/private-presets`. En producció no es llista mai. L'origen públic del lloc web, `/presets`, serveix els llibres d'exemple del lloc: *Bioquímica*, *Cielo profundo*, *Don Quijote*, *Física universitaria (OpenStax)*, *Pintura española* i *Señales 2020* en castellà i anglès, *Somni del pavelló vermell* en tres edicions, *El paradís perdut* en anglès, amb les notes de Verity a peu de pàgina i les làmines de Doré, *Les mil i una nits* en àrab, *Kokoro* en japonès i el còmic *Pepper&Carrot* en deu llengües. Cadascun porta la seva llicència i els seus crèdits.
- **`default: true`**: un preset privat marcat com a preset per defecte es carrega automàticament la primera vegada que s'obre un Sandbox *intacte* (amb el document integrat sense tocar). Si n'hi ha diversos de marcats, té prioritat el que té un `locale` que coincideix amb la llengua de la interfície. Els presets públics no es carreguen mai automàticament.

Cada fila mostra el nom del preset, una descripció opcional, l'etiqueta de llengua i les etiquetes *Privat* / *Per defecte*. Un clic en una fila carrega el preset **complet**: text, figures, disseny i fonts. El Sandbox escriu primer els fitxers de font i les dades de les figures a IndexedDB, de manera que les previsualitzacions no veuen mai un document a mig aplicar. Un clic en una fila obre l'exemple en la llengua de la interfície, tret que només l'hagis editat en una altra llengua: llavors s'obre la teva versió més recent. Les etiquetes de llengua d'un exemple bilingüe l'obren en aquesta llengua (la teva versió en aquesta llengua, si la tens).

**Presets en viu.** Els presets remots se segueixen automàticament. Cada vegada que s'aplica un preset, el Sandbox registra l'*empremta* (*fingerprint*) del paquet juntament amb els hashes del Markdown, de la configuració i del conjunt de recursos que ha aplicat. Mentre la pàgina és visible, consulta l'empremta cada 3 segons, i immediatament quan la pestanya torna a ser visible o la finestra recupera el focus. Quan l'empremta canvia:

- Si el llibre és **intacte** (el Markdown, la configuració i els recursos continuen donant els mateixos hashes que quan es va aplicar el preset), el preset es torna a aplicar sencer i al tauler apareix un missatge breu.
- Si hi ha **canvis locals**, es conserven. Una franja a la part superior del tauler (*Hi ha una versió nova d'aquest llibre d'exemple. Els teus canvis es conserven.*) ofereix **Carregar la versió nova**, que demana confirmació abans de descartar els teus canvis en aquesta llengua de l'exemple, i mentrestant el botó Llibres de la barra d'activitat mostra un punt. L'esborrany recorda la versió de què va partir, de manera que la franja torna a aparèixer cada vegada que l'obres, fins que carregues la versió nova. Si els fitxers d'una figura de l'esborrany canvien a la versió nova, la figura conserva les dades que tenia: l'esborrany en rep una còpia pròpia abans que s'escriguin les del paquet. Els paquets només se segueixen mentre hi ha un llibre d'exemple obert. Un llibre copiat d'un d'ells conserva la seva pròpia còpia.

La mateixa comprovació es fa en carregar la pàgina, de manera que, si edites un paquet i després obres el Sandbox, el Sandbox agafa la versió nova sempre que el llibre estigui intacte. L'empremta prové de `<directori-del-preset>/fingerprint.json`. A la ruta de desenvolupament és un fitxer virtual que respon amb un hash del directori basat només en metadades (consulta l'apèndix [Format de paquet de preset](https://postext.dev/ca/docs/sandbox-embedding.md#format-de-paquet-de-preset)). Els orígens que no el serveixen no se segueixen.

El llibre d'exemple obert determina, a més, què restauren els botons **Restablir** dels altres taulers:

| Tauler | Restablir restaura |
| --- | --- |
| Text | El text de l'exemple i el seu conjunt de figures (la part del document) |
| Disseny | El disseny de l'exemple, fonts incloses |
| Llibres (Restaurar l'original…) | Tot: text, figures, disseny i fonts |

Un preset que estava obert en una sessió anterior però que ja no llista cap origen (normalment un preset privat en una compilació que no el serveix) continua apareixent, atenuat com a *No disponible en aquesta compilació*. El Sandbox conserva el contingut carregat en lloc de substituir-lo sense avisar per l'exemple integrat. L'id del preset obert es desa sota la clau `postext-sandbox-preset` (consulta [Persistència](https://postext.dev/ca/docs/sandbox-books-saving.md#persistència)). El format del paquet es descriu a l'apèndix [Format de paquet de preset](https://postext.dev/ca/docs/sandbox-embedding.md#format-de-paquet-de-preset).

#### Dissenys

Un disseny és l'aspecte d'un llibre i res del que diu: la pàgina i les columnes, la tipografia i els estils, els colors, les capçaleres i els peus, la configuració d'impressió. No guarda mai el text, els recursos ni els ajustos que pertanyen al llibre sencer (idioma, direcció, xifres, tipus de recurs, comprovacions). Els dissenys són al **tauler Disseny**: la fila **Dissenys** del seu resum els obre, i la seva capçalera exporta i importa fitxers de disseny.

- **Parts.** Un disseny es talla pels grups del tauler Disseny (pàgina i columnes, sistema d'escriptura, colors, tipografia, composició, títols…). En desar-lo, provar-lo, aplicar-lo o exportar-lo, tries quins grups porta.
- **Galeria.** Els teus dissenys desats, els quatre que porta el Sandbox (*Novel·la*, *Manual tècnic*, *Revista a dues columnes*, *Llibre a dues tintes*), les cinc convencions de composició (*Castellà (tradicional)*, *Anglès (EUA)*, *Anglès (Regne Unit)*, *Francès*, *Alemany*), que només porten la part Composició i deixen la tipografia com està, i el disseny de cada llibre d'exemple, cadascun amb un dibuix de la seva pàgina i les parts que conté.
- **Provar.** Les parts triades substitueixen les del llibre. Una barra ofereix **Conserva** i **Descarta**: Descarta torna només els ajustos que el disseny va substituir, i qualsevol altre canvi fet mentrestant es queda. Provar un altre disseny substitueix el primer. La prova pertany al llibre on va començar, i obrir un altre llibre la deixa. La barra enumera els estils que el text anomena (de paràgraf, de títol, de caixa, d'etiqueta, de caràcter, de marca i de taula) i que el disseny no defineix, perquè els vegis abans de conservar-lo. Provar, conservar, descartar i aplicar són passos de l'historial (⌘Z / Ctrl+Z).
- **Els estils amb nom** es combinen per id: un estil del disseny substitueix l'estil del llibre amb el mateix id, i els altres estils del llibre es queden. Les fonts es combinen per família, i els colors de la paleta que anomenen els ajustos del disseny hi vénen amb ell.
- **Un llibre en diversos idiomes** rep el disseny en els seus ajustos generals, mostri el que mostri el selector de la part superior del tauler; cada idioma conserva els seus propis ajustos.
- **Desar** el disseny d'aquest llibre, o de qualsevol altre llibre teu, amb les parts que triïs.
- **Com a estil de capítol.** Les parts triades esdevenen un [estil de capítol](https://postext.dev/ca/docs/configuration-styles.md#estils-de-capítol) del llibre, nou o un que ja tingui, amb només el que canvien respecte al llibre. Dona'l als capítols a **Capítols** o amb `chapterStyle:` a la capçalera, i als capítols d’una part amb `:::part{style="…"}`.
- **Exportar i importar.** Un fitxer de disseny és un `.postext` sense capítols (vegeu [Fitxers de disseny](https://postext.dev/ca/docs/configuration-bundles.md#fitxers-de-disseny)) que porta els fitxers de font i el perfil de color que anomenen les seves parts; les fonts que no són redistribuïbles no hi viatgen. Importar també llegeix el `.postext` d'un llibre sencer (el seu disseny) i els `postext-config.json` de versions anteriors. La línia d'ordres crea i llegeix els mateixos fitxers ([`postext design`](https://postext.dev/ca/docs/command-line.md#design)). Els dissenys desats es poden eliminar; els inclosos i els dels llibres d'exemple, no. Les plantilles que va desar postext 1.78 passen als teus dissenys desats la primera vegada que s'obre la galeria, i Importa llegeix els seus fitxers `.postext-template.json` com a dissenys.

#### Tauler de recursos

Gestiona els recursos del llibre: imatges de mapa de bits, figures SVG, taules i vídeos. El text s'hi refereix amb blocs `::resource{id="…"}` i referències en línia `:ref{id="…"}`. Per a la sintaxi de referència i el model de flotació, consulta [Format de document → Recursos](https://postext.dev/ca/docs/document-format-resources.md#recursos).

**Vista de llista.** La capçalera mostra el nombre de recursos. Els recursos s'agrupen pel nom del seu tipus de recurs, i cada grup és una llista amb el seu recompte. Els recursos amb un `typeId` que ja no coincideix amb cap tipus configurat van a parar a un grup *Sense tipus*, perquè hi puguis continuar accedint. Cada element mostra una miniatura de 36 px al costat del peu i de l'id: una previsualització real per als mapes de bits i els SVG, la portada amb una insígnia de reproducció per als vídeos i un glif per a les taules. Quan el llibre té més de sis recursos, un camp de **cerca** (*Cercar recursos…*) filtra la llista pel peu i per l'id, sense distingir accents. Quan el llibre encara no té recursos, un missatge explica com afegir-ne i col·locar-los al text amb `:ref{#id}`. Un desplegable **Nou** ofereix quatre maneres d'afegir-ne un:

- **Pujar imatge**: PNG, JPEG, WebP o GIF
- **Pujar SVG**
- **Taula nova**: comença com una graella de 2×2 amb una fila de capçalera
- **Afegir vídeo**: un vídeo de YouTube o de Vimeo, un fitxer de vídeo o l'adreça d'un vídeo (un MP4 o un flux HLS; vegeu *Vídeo* més avall). Un llibre amb tipus de recurs anteriors als vídeos rep el tipus *Vídeo* integrat quan n'afegeix el primer.

També pots arrossegar fitxers des del disc i deixar-los anar sobre el tauler, inclosos fitxers de vídeo (MP4, WebM, Ogg, QuickTime). Es pugen tots alhora, amb ids generats a partir dels noms dels fitxers. Els fitxers no admesos s'ometen, i una nota breu indica quants se n'han afegit i quants se n'han omès.

**Vista de detall.** En seleccionar un recurs s'obre el seu editor:

- **ID**: editable i validat com a slug. Els ids duplicats es marquen i no s'accepten mai, i un id buit rep un suggeriment a partir del peu. Reanomenar conserva el fitxer d'imatge o SVG emmagatzemat.
- **Tipus**: un dels tipus de recurs configurats
- **Peu**: admet Markdown en línia (negreta, cursiva, codi i `:ref`). `\\`, o una barra inversa al final d'una línia, comença una línia nova; un salt de línia simple compta com un espai
- **Nota**: una línia opcional de font, crèdit o observació, composta en un cos menor sota el recurs (amb el mateix format en línia i els mateixos salts de línia que el peu). Té l'estil que fixa el grup *Nota* dels paràmetres de *Peus de figura*.
- **Text alternatiu**: descripció d'accessibilitat per a la sortida HTML
- **Estil de taula**: en les taules, l'estil amb nom amb què es compon la taula (`table.styleId`). Pot ser *Estil de taula del document* (per defecte) o un dels *Estils de taula* declarats a la configuració. Un id que no declara cap estil apareix com a inexistent i es compon amb l'estil de taula del document.
- **Col·locació**:
  - **Posició**: `auto` (el primer espai lliure, el valor per defecte), `top`, `bottom` o `here`.
  - **Làmina a pàgina completa**: per a una imatge que no és a `here` (`placement.plate`). Ocupa sola una pàgina pròpia després de la cita, tan gran com cap a la caixa amb el peu, i el text continua abans i després d'ella. **Àrea de la làmina** la posa *A caixa*, *A tall* o *A sang*: sobre la pàgina, la imatge s'amplia fins a cobrir-la i es retalla al voltant del centre, el peu queda al peu de la caixa sobre una banda del color del paper i la pàgina no porta titolets ni foli; sense marques de tall, la sang és el tall. Una làmina amaga els altres camps de col·locació. Amb el preflight d'impremta actiu, el tauler de revisió llista com a *Resolució d’imatge baixa* un mapa de bits ampliat per sota de la resolució mínima. Els tipus de recurs ofereixen els dos camps a la col·locació per defecte.
  - **Extensió**: `column`, `page` o `side`. Queda desactivada quan la posició és `here`. Els valors per defecte coincideixen amb els del motor, `auto` + `column`.
  - **Columnes**: quantes columnes contigües ocupa un flotant de columna en una pàgina de diverses columnes (`placement.columns`), com una imatge sobre dues de les quatre d'un diari. Si n'ocupa tantes com en té la pàgina, ocupa tota la pàgina. Apareix quan el llibre o alguna de les seves seccions té més d'una columna i l'extensió és `column`, i no apareix en un recurs situat `here` ni en un de girat.
  - **Orientació**: vertical, o girat un quart de volta (capçalera a l'esquerra o a la dreta). Un recurs girat ocupa una pàgina pròpia, arran del llom, de manera que el selector d'extensió queda desactivat.
  - **Amplada**: una fracció d'amplada amb una alineació, per als flotants i les insercions en línia més estrets que la seva columna. **Amplada en** alterna entre una *Proporció* en % i una *Mesura* en mm, cm, in o pt (`placement.width: { value, unit }`), mesurada sobre l'espai on cau el recurs; si és tan ampla com l'espai o més, ocupa l'espai sencer. L'alineació també col·loca un mapa de bits o un SVG més estret que el seu espai quan té l'amplada completa (un mapa de bits més petit que la columna, o una figura que `layout.fitFiguresToPage` ha reduït), de manera que en les imatges continua activada; en una taula exigeix una amplada inferior al 100 %. Un recurs girat no té cap de les dues.
  - **Peu al costat de la figura**: un interruptor per a la columna lateral d'una disposició de columna i mitja. S'aplica als flotants de columna, de manera que s'amaga quan la posició és `here`.
  - **Reduir perquè hi càpiga**: per a una imatge flotant, *Mai*, *En una pàgina nova* o *En qualsevol espai* (`placement.shrink`), amb **Escala mínima** (`placement.minScale`) quan es redueix; i **Amplada del peu**, *Espai* o *Imatge* (`placement.captionMeasure`), per a qualsevol imatge que no estigui girada. Els tipus de recurs ofereixen els mateixos tres camps a la seva col·locació per defecte.
  - **Encapçalar la pàgina que el cita**: per a un flotant a dalt o automàtic, de columna o de pàgina i sense girar (`placement.citingPage`): pot ocupar el capdamunt de la pàgina o de la columna on cau la línia que el cita, i el text que hi ha damunt de la referència baixa i queda a sota. Els tipus de recurs ofereixen el mateix interruptor a la seva col·locació per defecte.
  - **Col·locada a mà (no recomanat)**: per a un flotant de columna o de pàgina que no estigui girat (`placement.pin`). El grup comença explicant per què no es recomanen els pins i quines regles fer servir en el seu lloc. **Pàgina** és *Automàtica*, *La pàgina que la cita* o d'una a tres pàgines després; **Columna** és *Qualsevol* o un número de columna; **Buit** és la capçalera o el peu. **Torna a automàtica** treu el pin. **Moure al llenç** prepara el flotant per arrossegar-lo a un espai de les pàgines, amb el ratolí o amb el dit; amb el ratolí, mantenir Alt (Opció en un Mac) mentre s'arrossega un flotant fa el mateix sense preparar-lo, i qualsevol altra pulsació sobre un flotant conserva el seu efecte habitual (els rètols, el text, la selecció de pàgina). Mentre s'arrossega un flotant s'il·luminen tots els espais que pot ocupar; els que queden per sobre de la cita o a més de tres pàgines es veuen en gris. Escapada cancel·la. Cada canvi és un pas de l'historial de desfer, i un pin que la maquetació no segueix apareix al tauler Revisió com a `floatPinMissed`.
  - **Ajust del text**: per a un recurs col·locat al text o un flotant d'una columna, *Cap* o el costat de la columna on es col·loca amb el text al costat (`placement.wrap`), i la **Separació de l'ajust** (`placement.wrapGap`) quan el text l'envolta; un recurs envoltat de text sense amplada pròpia mostra la fracció per defecte de la maquetació. Els tipus de recurs ofereixen tots dos camps a la seva col·locació per defecte. *Contorn*, per a una imatge, compon el text resseguint la forma de la imatge, pel costat que indica l'*Alineació* (`wrap: "contour"`): un mapa de bits mostra llavors **Forma segons la transparència** (`contour.alpha`), el seu **Llindar d'opacitat** (`contour.threshold`) i el **Marge del contorn** (`contour.margin`), i el Sandbox traça el canal alfa a partir del fitxer desat. Si no es coneix la forma d'una imatge, sota els camps s'indica.
- **Contingut**: carregadors que substitueixen el fitxer de mapa de bits o SVG
- **Mida i resolució**: en un mapa de bits, els píxels, la resolució que indica el fitxer (*no n’indica cap*, o 72 i 96 amb la marca *es llegeix com a no indicada*), la mida natural en mm a la resolució amb què es maqueta i els ppp amb què s'imprimeix allà on el col·loca la maquetació actual (els més baixos si es col·loca més d'un cop). Per sota del mínim del preflight es mostra amb l'estil d'avís, i per sota del crític amb l'estil crític, amb **Obrir a Revisió** en un llibre preparat per a impremta. **Resolució** fixa els ppp propis de la imatge (`bitmap.resolution`; vegeu [Format del document › Mida dels mapes de bits](https://postext.dev/ca/docs/document-format-resources.md#mida-dels-mapes-de-bits)), i **Fer servir els … ppp del fitxer** l'omple amb els del fitxer. Una imatge pujada conserva la resolució que indica el fitxer (`bitmap.fileResolution`).
- **Vídeo**: en un recurs de vídeo ([Format del document › Vídeos](https://postext.dev/ca/docs/document-format-videos.md#vídeos)):
  - **Origen**: *YouTube*, *Vimeo* o *Fitxer*.
  - **Adreça del vídeo** (YouTube, Vimeo): qualsevol enllaç del vídeo. Quan l'enllaç indica un vídeo nou, se'n baixen de la plataforma la portada, la mida del fotograma i el títol (el títol passa a ser el text alternatiu si aquest és buit); **Tornar a baixar el fotograma** ho repeteix. Si un enllaç no correspon a cap vídeo de la plataforma, s'indica sota el camp.
  - **Fitxer de vídeo** (Fitxer): el carregador d'un fitxer MP4, WebM, Ogg o QuickTime, amb el format, la mida i la durada. La primera portada es pren quan ha transcorregut una desena part del vídeo. **Fotograma de portada** reprodueix el fitxer: atura'l o arrossega'l fins al fotograma que vulguis imprimir i prem **Fer servir aquest fotograma com a portada**. **Adreça de producció**: on serà el vídeo publicat (`https://…`), que obren el codi QR i l'enllaç del PDF; sense ella, la versió impresa no porta codi QR ni enllaç.
  - **Adreça del vídeo** (Fitxer, sense cap fitxer pujat): el vídeo es reprodueix només des de la seva adreça, un MP4 o un WebM en un servidor o un flux HLS (`.m3u8`, que es marca a sobre del camp amb *Flux HLS*). En introduir l'adreça es llegeixen la mida i la durada del vídeo, i **Fotograma de portada** el reprodueix des d'allà, també si és HLS. Per triar-ne un fotograma, el servidor ha de permetre lectures des d'un altre origen (CORS); si no, el tauler mostra *El servidor del vídeo no permet llegir-ne els fotogrames (CORS): puja una portada*. El codi QR i l'enllaç del PDF obren aquesta adreça.
  - **Portada**: la imatge impresa amb la seva mida, i un carregador per substituir-la per una imatge pròpia.
  - **Inici (s)** / **Final (s)**: la part que es reprodueix; 0 deixa l'inici o el final com són.
  - **Reproductor**: els interruptors d'aquest vídeo (controls, botó de baixada, pantalla completa, menú de velocitat, imatge sobre imatge, reproducció automàtica, començar sense so, repetir, reproduir al mateix temps que altres vídeos), cadascun amb *Ajust del llibre*, *Sí* o *No*. Només hi apareixen els que admet el reproductor del vídeo.
- **Zona segura**: en mapes de bits i SVG, la part de la imatge que sempre es veu (`Resource.safeArea`; vegeu [Format del document › Zona segura](https://postext.dev/ca/docs/document-format-resources.md#zona-segura)). El camp mostra una miniatura amb la zona marcada i la mida en percentatge, o *Cap* quan la imatge no en té, amb els botons **Marcar la zona segura** / **Editar la zona segura** i **Treure la zona segura**. El diàleg mostra la imatge: arrossega fora del rectangle per dibuixar-ne un de nou, a dins per moure'l o des de les nanses per canviar-ne la mida; quan el rectangle té el focus, les fletxes el mouen i Maj amb les fletxes el redimensiona. Els camps *Esquerra*, *Dalt*, *Amplada* i *Alçada* el fixen en percentatge, i dues previsualitzacions mostren el retall més alt i el més baix que permet la zona.
- **Retall**: en mapes de bits, SVG i pòsters de vídeo, la part de la imatge que la figura mostra sempre (`Resource.crop`; vegeu [Format de document › Retall manual](https://postext.dev/ca/docs/document-format-resources.md#retall-manual)). **Retalla** obre la imatge amb un marc: arrossega'l des de dins per moure'l, des de les nanses per canviar-ne la mida, o fes servir les fletxes (amb Maj, passos més llargs); una previsualització mostra la figura amb la proporció del retall, i **Treu el retall** torna a mostrar la imatge sencera. La zona segura es llegeix dins del retall.
- **Àncores**: en mapes de bits i SVG, els punts de la imatge on es col·loquen els rètols d'un mapa o d'un esquema (`Resource.anchors`; vegeu [Pàgines compostes › Figures amb rètols](https://postext.dev/ca/docs/composed-pages-figures.md#figures-amb-rètols)). El botó **Àncores** del mateix camp obre el diàleg en el mode *Àncores*, i el camp compta les àncores i els rètols que encara n'esperen una.
  - **Col·locar amb clics.** A *Rètols sense àncora*, el diàleg llista els noms que fan servir les línies `::label[…]{at="…"}` del text i que la imatge no té com a àncora, i selecciona el primer: un clic a la imatge el col·loca allà i selecciona el següent, de manera que un mapa amb els rètols ja escrits rep les àncores a clic per àncora. Es pot triar un altre nom, o **Deixar de col·locar**, en qualsevol moment. Sense cap nom seleccionat, un clic afegeix `anchor1`, `anchor2`… i posa el cursor al nom.
  - **Cada àncora** té el **Nom** (l'id que donen els rètols), un **Estil de rètol** del disseny (`labelStyles`), l'**Alineació** (inici, centre o final, en la direcció del rètol), l'**Alineació vertical**, el **Gir** en graus i l'**Amplada**, la fracció de l'amplada de la imatge dins de la qual el rètol es parteix en línies (0 conserva l'amplada natural). Una àncora nova pren els camps de rètol de la que estava seleccionada abans, i així una sèrie de pobles comparteix estil. La llista mostra el text del rètol de cada àncora al capítol en pantalla (*Sense rètol al text* si no n'hi ha) i un camp de filtre quan la imatge en té més de vuit.
  - Un punt es mou arrossegant-lo; amb un punt seleccionat, les fletxes el desplacen (amb Maj, a passos més llargs) i Supr la suprimeix. Les àncores són fraccions de la imatge sencera, de manera que mantenen el lloc sigui quin sigui el retall que permeti la zona segura; si en queda alguna fora de la zona segura, es marca. **Desar** les escriu al recurs com un sol pas de l'historial de desfer.
  - **A la pàgina.** En mode Disseny, el Canvas mostra la caixa de cada rètol dibuixat (en vermell, amb *no hi cap en l'amplada fixada*, quan no hi cap ni a la mida més petita de l'estil) i el punt de l'àncora. En arrossegar el punt o el rètol es mou l'àncora: el rètol es compon de nou on es deixa anar, i Cmd/Ctrl+Z desfà el moviment. Un clic obre la imatge en aquest tauler; un doble clic n'obre les àncores al diàleg. Un rètol col·locat amb `at="x% y%"` es mou igual, i on es deixa anar es reescriu el valor d'`at` al text de l'edició que es veu: els percentatges són paraules pròpies d'aquella edició. En mode Contingut, un clic en un rètol en selecciona el text al tauler Text.
  - **Diverses alhora.** Cada fila de la llista té una casella, i un clic amb Majúscules o Ctrl sobre un punt de la imatge també el marca; **Marcar les visibles** marca totes les files que deixa el filtre. Les àncores marcades mostren un sol joc de camps (estil, alineació, alineació vertical, escriptura), i un canvi s'aplica a totes com un sol pas de l'historial. On difereixen, el camp diu *Diversos*.
  - **Mapes densos.** A partir de 24 àncores, un punt només mostra el nom si està seleccionat, si hi ha el ratolí a sobre o si està marcat, perquè les etiquetes no s'amunteguin; **Noms a la imatge** torna a mostrar-los tots. **Escriptura** compon en vertical els rètols d'una àncora (`writingMode`), i la seva **Amplada** passa a ser una part de l'alçada de la imatge.
  - **Solapament.** *Comprovar* és el valor per defecte. *Permetre* (`overlap: 'allow'`) indica que l'original imprimeix el rètol d'aquesta àncora tocant els veïns, com fa un mapa dens, i el tauler Revisió deixa de donar l'avís `labelOverlap` per a qualsevol parella de què formi part. Les àncores marcades ho prenen alhora. Un estil de rètol pot permetre-ho per a tots els seus rètols (**Disseny › Figures i taules › Estils de rètol**). Des de postext 1.42.
  - **Llom.** *Evitar* és el valor per defecte: en una figura que travessa el llom d'una doble pàgina, un rètol que entraria a la franja del llom es queda a la vora de la franja, del costat de la seva àncora. *Creuar* (`gutter: 'cross'`) el deixa on el posa el punt, com necessita un títol que ocupa les dues pàgines. Les àncores marcades ho prenen alhora. Des de postext 1.43.
  - **Zoom.** Els botons sobre la imatge, `+`, `-` i `0` al teclat, i Ctrl amb la roda o una pessigada l'amplien per passos fins al 800 %, al voltant del punt sota el cursor. Una imatge ampliada es desplaça amb la roda, amb el botó de la mà, o arrossegant amb la barra espaiadora premuda (o amb el botó central). Els punts conserven la mida i, des del 300 %, un mapa dens mostra tots els noms (des de postext 1.40). En una pantalla tàctil, dos dits mouen la imatge i separar-los o ajuntar-los l'amplia o la redueix al voltant del punt que queda entre ells (des de postext 1.42).
  - **Al visor HTML** el mode Disseny dibuixa les mateixes caixes i punts i les marques es mouen com al Canvas: arrossega un punt i l'àncora (o els percentatges d'un `at`) s'escriu com un pas de l'historial (des de postext 1.40). **Al Folio**, en el mode de selecció, les marques es dibuixen a les pàgines del llibre i s'hi arrosseguen com al Canvas: el punt segueix el punter sobre la textura de la pàgina, en deixar-lo anar s'escriu l'àncora, i prémer una marca no passa mai la pàgina (des de postext 1.42). En una pantalla tàctil, un dit agafa el rètol per la caixa, o a menys d'un dit de distància del punt, i l'arrossega des d'allà; un dit sobre el paper en blanc continua desplaçant la pàgina (des de postext 1.43).
- **Fonts del dibuix**: en les figures SVG, les famílies que fa servir el text del dibuix (família, pes, estil) i què ha passat amb cadascuna: *incrustada* amb la seva mida, *declarada a l'SVG* (el fitxer porta el seu propi `@font-face`), *sense fitxer de font* (la imatge passa a una altra font) o *supera el límit de mida*. Les variants surten de les fonts personalitzades del llibre i després de Google Fonts, i només s'incrusten quan la imatge es mostra o s'exporta, mai al fitxer desat. **Incrustar les fonts del llibre** ho desactiva per a aquesta figura (`svg.inlineFonts: false`), per a un SVG que porta les seves pròpies variants o que s'ha de quedar com és.
- **Codi font de l'SVG**: en les figures SVG, un editor de codi sota el carregador. Només admeten canvis els nodes de text: el contingut dels elements `<text>` / `<tspan>`, tenyit a l'editor. No es pot escriure enlloc més, i els caràcters `<`, `>` i `&` escrits dins d'un node de text s'escapen perquè el fitxer continuï ben format. Cada canvi es desa després d'una pausa breu com un fitxer emmagatzemat **nou**, i la figura es torna a renderitzar (recoloració a una sola tinta inclosa). L'editor avisa quan l'SVG no té nodes de text.
- **Previsualització**: una maqueta en viu de com es veurà el recurs, amb `#` en lloc del número (els números reals depenen d'on vagi a parar el recurs al document). El peu comença amb l'etiqueta que posa el document: l'etiqueta del peu del tipus i el número (`Figura #.`), només l'etiqueta en un tipus numerat amb una plantilla buida (`Doc.`) i res en un tipus sense etiqueta del peu
- **Suprimir**: demana confirmació i avisa de quantes referències `::resource` / `:ref` del text quedarien sense destinació

**Editor de taules.** Els recursos de taula obren un editor de graella interactiu:

- **Barra d'eines**:
  - Afegeix o treu files i columnes, i combina o divideix cel·les.
  - Activa una fila o una columna de capçalera.
  - Fixa l'alineació horitzontal i vertical de cada cel·la (a dalt, al centre o a baix). El contingut de la cel·la es mou com una unitat dins d'una fila més alta.
  - Fixa l'emplenament de cada cel·la: un selector de color, vinculable a la paleta, amb un botó per treure'l. L'emplenament es desa a `TableCell.background` i es mostra a la graella.
- **Amplades de columna**: un pes numèric per columna sota la graella (`2, 1, 1` dona a la primera columna la meitat de l'amplada; buit vol dir amplades iguals), que s'escriu a `table.model.columnWidths`. Afegir o treure una columna manté els pesos alineats, i un enllaç *Amplades iguals* els esborra.
- **Enganxar com a taula**: si enganxes TSV (o CSV simple amb cometes), s'emplena la graella
- **Desfer/refer**: Cmd/Ctrl+Z i Maj+Cmd/Ctrl+Z
- **Navegació amb teclat**: Tab / Maj-Tab (amb salt de fila) i les fletxes mouen entre cel·les
- **Edició des de la previsualització**: fes clic en una cel·la de taula, un peu, una nota o un fragment de text d'una figura SVG en qualsevol de les dues pestanyes de previsualització. El tauler Recursos s'obre en aquest recurs i enfoca el camp corresponent, amb el cursor al glif on has fet clic. Arrossegar selecciona un interval dins de la mateixa cel·la o camp, i el doble clic selecciona el mot. Mentre el camp té el focus, la selecció es reflecteix a la pàgina com un ressaltat (o un cursor fi quan no hi ha res seleccionat), tant a la pestanya Canvas com a la HTML. Un peu o una nota que un `:::figure` escriu amb les seves pròpies paraules (`::caption[…]`, `::note[…]`) se selecciona en canvi al Markdown, on està escrit.

Totes les edicions passen per funcions pures de model exportades pel nucli de postext (`addRow`, `addColumn`, `removeRow`, `removeColumn`, `mergeCells`, `unmergeCell`, `setCellContent`, `setAlignment` i `parseTSV`), de manera que el mateix model de taula es comporta igual dins i fora del Sandbox.

#### Tauler de fonts

Mostra els tipus de lletra que fa servir el llibre i gestiona els teus fitxers de font, al costat del catàleg integrat de Google Fonts:

- **Tipus de lletra d'aquest llibre** llista totes les famílies que fa servir el disseny. Cada nom de família apareix compost amb el mateix tipus de lletra, amb la funció que té (*Text de cos*, *Títols* o *Altres elements*) i l'origen: *Google Fonts*, *Fontsource* (una família que Google Fonts no té), *Fitxer propi*, o *No trobada* si cap font no la té. L'origen apareix tan bon punt el carregador el coneix. Els tipus de lletra en si es canvien a **Disseny → Tipografia** i **Títols i índex**.
- **Els fitxers amb què es mesura un llibre.** Una família de Google Fonts o de Fontsource es compon amb els fitxers estàtics de Fontsource a jsDelivr (`@fontsource/<família>@5`), un per pes, estil i subconjunt. Són els fitxers que carrega un pen del Receptari i els que incrusta el PDF, de manera que un llibre talla les línies per les mateixes paraules a les previsualitzacions, al PDF i en un pen. La línia d'ordres maqueta amb `bodyText.shapingLanguage: 'host'`, de manera que allà una línia es pot tallar per una altra paraula (vegeu [Diferències amb el Sandbox](https://postext.dev/ca/docs/command-line.md#diferències-amb-el-sandbox)). Les previsualitzacions declaren els pesos i estils que fan servir el disseny i les pàgines, i el navegador carrega cada fitxer quan el text el necessita. Des de postext 1.30, a més, abans de pintar un capítol per primera vegada, les previsualitzacions esperen que estiguin carregades totes les variants que fan servir les pàgines ja maquetades, per als caràcters d'aquestes pàgines (una família dividida en més de 16 fitxers per variant, com una de xinesa o japonesa, els carrega com abans). De postext 1.28.3 a 1.29.2, una variant que només feien servir les pàgines i que componia un text no llatí (la cursiva dels resums de l'índex general d'un llibre àrab) es pintava amb una font de reserva fins que n'arribava el fitxer. Un pes entre dos talls d'una família variable (un 450) no té fitxer estàtic: les previsualitzacions el componen amb el fitxer variable de Google en aquest pes i el PDF incrusta el tall més proper, així que tria un pes que la família tingui quan tots dos hagin de coincidir. Una família de la qual Fontsource no té fitxers es pren del full d'estils de Google. Tots els fitxers d'una família surten d'una sola versió del paquet, la mateixa des de la qual jsDelivr ha servit el full d'estils: `@5` indica la versió a què es resol cada adreça, i, si no fos així, després d'una publicació que torna a dividir una família, els fitxers podrien venir de dues divisions diferents.
- **Un fitxer lent, o que no arriba mai.** Els fitxers de les variants d'un llibre es demanen abans de la primera maquetació, i la maquetació els espera mentre continuïn arribant: un llibre de diversos centenars de fitxers (un de xinès o japonès) amb una connexió lenta es maqueta una sola vegada, amb tots els fitxers. Les peticions només s'abandonen quan cap fitxer de font no ha rebut res durant 15 segons; aleshores el capítol es maqueta amb les variants que han arribat, i les altres, amb la font de reserva que indiquen els avisos. Aquesta maquetació és provisional: els seus recomptes de pàgines no es desen amb el llibre ni s'escriuen en un paquet. El fitxer es torna a demanar tres vegades, amb mig minut entre elles, i a cada composició posterior; quan arriba, les previsualitzacions i tots els capítols maquetats sense el fitxer es tornen a maquetar, amb l'índex general i les referències a pàgines, i el PDF i l'EPUB queden marcats com a desactualitzats.
- **Un pes o una inclinació que la família no té.** Les previsualitzacions i el PDF componen cada família amb els seus fitxers. Si una família no té negreta (Bangers, Zen Antique i gairebé totes les de retolació porten un sol pes) o no té cursiva, la negreta i la cursiva es componen amb la variant més propera tal com és, sense el gruix ni la inclinació que hi afegiria el navegador, i no se'n llista cap `fontFallback`. Un pes que se substitueix per una altra variant real de la família (un 600 compost amb el 700) sí que es llista. Una família que Fontsource té i Google Fonts no, com Commit Mono, es carrega des de Fontsource.
- **Els teus fitxers de font** és on afegeixes, reanomenes i suprimeixes famílies personalitzades.
  - **Pujar fitxer**: fitxers de variant per pes (100–900) i estil (normal / cursiva). Els formats acceptats són WOFF2, WOFF, TTF i OTF, detectats per l'extensió del fitxer. Els fitxers es desen a l'IndexedDB del navegador.
  - Les famílies personalitzades apareixen a tots els selectors de font sota un grup **Personalitzades**, al costat dels resultats de Google Fonts. Una família personalitzada **té prioritat** sobre una Google Font amb el mateix nom.
  - En un document en xinès, tots els selectors de font mostren primer, sota *Xinès simplificat* o *Xinès tradicional*, les famílies de Google que contenen els seus caràcters (els subconjunts `chinese-simplified`, `chinese-traditional` i `chinese-hongkong` de Fontsource), i després les altres.
  - En un document en àrab (o una altra llengua escrita amb l'alfabet àrab), tots els selectors de font mostren primer, sota *Àrab*, les famílies de Google amb el subconjunt `arabic` de Fontsource, començant per les de llibre (Amiri, Noto Naskh Arabic, Scheherazade New, Markazi Text, Lateef, i després Noto Kufi Arabic, Reem Kufi, Aref Ruqaa, El Messiri). Les previsualitzacions carreguen el fitxer àrab de cada font abans de la primera composició, i el PDF l'incrusta al costat del llatí quan el text fa servir tots dos.
  - Els fitxers de font òrfens (pujades que ja no fa servir cap família) se suprimeixen d'IndexedDB automàticament.

### Mòbils i pantalles petites

Per sota de 768 px d'amplada, el Sandbox passa a una disposició específica:

- **Taulers.** La barra de taulers baixa al peu de la finestra: primer un botó **Vista** i després els mateixos botons en el mateix ordre, en dues files de quatre per sota de 352 px. Un tauler obert cobreix la previsualització en lloc de quedar-hi al costat; la previsualització continua a sota on era, fora de l'ordre de tabulació, així que en tancar el tauler apareix a la mateixa pàgina.
- **Barra superior.** Les pestanyes de previsualització, el selector d'abast (a les pestanyes EPUB i SCORM, el tipus de maquetació) i els controls de l'amfitrió (objectius grans, tema, idioma) comparteixen la barra que hi ha sobre la previsualització. Per sota de 640 px ocupa dues files: a dalt el logotip, l'abast i els controls; a baix les pestanyes, a tota l'amplada; a 320 px n'hi caben cinc.
- **Barres d'eines.** Les barres flotants de les previsualitzacions s'acoblen al peu de la previsualització i passen a una segona fila quan no hi caben. La barra d'edicions del Canvas és una fila a la part superior de la previsualització.
- **Folio.** La pestanya Folio no s'ofereix a la pantalla d'un mòbil (consulta [Pestanya Folio](https://postext.dev/ca/docs/sandbox-previews.md#pestanya-folio)).
- **PDF.** Els mòbils i les tauletes només tàctils no poden mostrar un PDF dins de la pàgina (Android no té visor integrat i iOS només dibuixa la primera pàgina), així que la pestanya PDF mostra en lloc seu una targeta amb **Obrir el PDF**, que obre el fitxer en una pestanya nova; **Baixar**, a la barra d'eines, el continua desant.
- **Tàctil.** Moure un rètol amb el dit al Canvas i al visor HTML (des de postext 1.43), el mode de selecció del Folio i el pessic i el desplaçament amb dos dits del diàleg d'àncores s'han provat amb l'emulació tàctil del navegador i esdeveniments tàctils reals, en una pantalla de la mida d'un mòbil i una altra de la mida d'una tauleta. No s'ha provat cap dispositiu físic: un navegador que llegeixi `touch-action` d'una altra manera pot desplaçar la pàgina allà on el Sandbox espera un arrossegament. Si un gest falla, indica el navegador i el dispositiu.

![Dues pantalles de mòbil: a l'esquerra, el canvas amb una pàgina del llibre i la barra de taulers a baix; a la dreta, el tauler Text, que tapa la previsualització.](https://postext.dev/docs-shots/ca/sandbox-phone.webp)

*En un mòbil: la previsualització amb la barra d'eines acoblada a baix, i el tauler Text obert al damunt.*

## Full de ruta

Les característiques següents estan planificades per a versions futures:

- **Edició col·laborativa**: editar un mateix llibre alhora des de diversos navegadors
