Saltar al contingut principal
Recepta número 132

Receptari · Capítol 10 · Sortida i integració

Full de pràctiques amb vídeos per a la pantalla i l'EPUB

Dos recursos de vídeo amb el seu propi MP4: l'imprès hi posa el primer fotograma amb un codi QR; renderToHtml i postext-epub reprodueixen els fitxers.

En aquesta pàgina
Sortida
Canvas · HTML · PDF · EPUB
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Source Serif 4 9,4/13,2
  • Red Hat Display
  • Red Hat Mono
  • 2 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 172 ms
  • 239 línies de codi

En poques paraules

Un full de pràctiques de física amb dos vídeos curts d'un pèndol. En paper cada vídeo és una imatge fixa amb un codi per escanejar; en pantalla i al llibre electrònic el vídeo es reprodueix a la pàgina.

Què compondràs

La pràctica 4.2 de Física al laboratori, un quadern A4 per a batxillerat, sobre el període d'un pèndol. Una banda de color teula porta el títol i els camps per al nom, el grup i la data. Al peu de la primera pàgina, dos vídeos del mateix pèndol, deixat anar des de 10° i des de 80°, queden l'un al costat de l'altre. En paper, cada vídeo és el seu primer fotograma amb una marca de reproducció i un codi QR que obre el MP4. A l'edició de pantalla que acompanya les pàgines, i a l'EPUB que escriu el codi, aquests mateixos recursos es reprodueixen al reproductor de vídeo del lector. La segona pàgina recull el procediment, una taula per omplir, els períodes exactes que calcula el codi i quatre qüestions amb el seu requadre per a la resposta.

Aquesta recepta respon a

  • Com reprodueixen l'edició HTML i l'EPUB els vídeos del llibre, i com amago el botó de baixada?
  • Com poso un vídeo en un llibre imprès perquè el lector el pugui obrir des de la pàgina?

La resposta curta

script.js · línies 32–61al codi complet
const clip = (id, file, poster, caption, altText) => ({
  id, typeId: 'video', kind: 'video', createdAt: 0, updatedAt: 0, caption: t(caption),
  note: t({ en: '8.00 s, 25 frames per second · Postext Cookbook, CC BY 4.0',
    es: '8,00 s, 25 fotogramas por segundo · Postext Cookbook, CC BY 4.0' }),
  altText: t(altText), placement: { position: 'bottom', span: 'column' },
  video: { source: 'file', fileId: file, format: 'mp4', width: 640, height: 360, duration: 8,
    url: asset(file), // the production address: printed as the QR code, linked from the PDF
    poster: { fileId: poster, format: 'jpeg', width: 640, height: 360 }, // the first frame
  },
});
const videoStyle = {
  playMark: { shape: 'rounded', position: 'top-left', size: mm(7), inset: mm(3),
    background: col('ink'), color: col('paper') },
  qr: { position: 'bottom-right', size: mm(19), inset: mm(2.5), // 111 characters: 45 modules
    color: col('ink'), background: col('paper'), radius: mm(1) },
  // The HTML5 player of a file honours every option. download: false writes
  // controlslist="nodownload": it hides the button, and the file stays at its address.
  player: { download: false, loop: true, muted: true, preload: 'auto',
    pictureInPicture: false, remotePlayback: false },
};
const clips = [
  clip('small', 'pendulum-small.mp4', 'pendulum-small-poster.jpg',
    { en: 'Released from rest at 10°.', es: 'Soltado desde el reposo a 10°.' },
    { en: 'A rust bob on a dark string hangs a few degrees off the vertical, under a short bar.',
      es: 'Una lenteja roja cuelga de un hilo oscuro a pocos grados de la vertical.' }),
  clip('large', 'pendulum-large.mp4', 'pendulum-large-poster.jpg',
    { en: 'Released from rest at 80°.', es: 'Soltado desde el reposo a 80°.' },
    { en: 'The same pendulum pulled out almost level with its pivot, a pale arc below it.',
      es: 'El mismo péndulo, casi a la altura de su eje, sobre un arco pálido.' }),
];

Ingredients

Tipografia
Source Serif 4, Red Hat Display, Red Hat Mono (SIL OFL 1.1)
Recursos
  • pendulum-large-poster.jpg
  • pendulum-large.mp4
  • pendulum-small-poster.jpg
  • pendulum-small.mp4
  • Video 1: a pendulum 1 m long released from 10°, 8 s at 25 frames per second, rendered from an RK4 solution of the pendulum equation (1 ms steps) with Python and encoded with ffmpeg (Postext Cookbook, CC BY 4.0)
  • Video 2: the same pendulum released from 80°, rendered and encoded the same way (Postext Cookbook, CC BY 4.0)
  • The first frame of Video 1, its printed poster (Postext Cookbook, CC BY 4.0)
  • The first frame of Video 2, its printed poster (Postext Cookbook, CC BY 4.0)

Elaboració

#1 · Dona a cada vídeo una adreça de producció i un fitxer

El codi és la resposta curta de dalt. Un vídeo propi té dues adreces. video.url és on el trobarà el llibre publicat: el codi QR la imprimeix i el PDF hi enllaça la portada, així que aquí és l'adreça del vídeo a jsDelivr, la que un mòbil pot obrir avui. video.fileId identifica el fitxer, que es desa a part com un mapa de bits, per a les sortides que el poden portar o reproduir des d'un altre lloc (vegeu Format del document › Vídeos). Les opcions de videoStyle.player valen per a tots els vídeos: es repeteixen en bucle, comencen sense so, es carreguen sencers (27 i 61 KB) i no ofereixen baixada, imatge dins d'imatge ni enviament a una altra pantalla, de manera que el vídeo es queda al full.

#2 · Compon l'edició de pantalla amb el mateix original

script.js · línies 172–180al codi complet
const [PANE_W, PANE_H] = [400, 640]; // px
const screen = {
  page: { width: px(PANE_W), height: px(PANE_H), dpi: 122, // so the 9.4 pt text is 16 px
    margins: { top: px(28), bottom: px(28), left: px(22), right: px(22), mirror: false } },
  layout: { layoutType: 'single' }, bodyText: { textAlign: 'left' }, // ragged in a narrow pane
  headings: { levels: [{ level: 1, span: 'column', breakBefore: { enabled: false },
    fontSize: px(28), lineHeight: px(32), fontWeight: 800, marginBottom: px(16),
    advancedDesign: { enabled: false } }] }, // the title alone: the band and fields are print's
  header: { elements: [] }, footer: { elements: [] } };

L'edició de pantalla viu a la configuració, a htmlViewer.overrides, que el canvas i el PDF no llegeixen. A 122 ppp cada mida en punts surt una quarta part més gran que a 96, així que el text de 9,4 pt es llegeix a 16 px al plafó, i els peus, els requadres i les taules creixen amb ell. L'obertura conserva el títol i deixa la banda i els camps, que són cosa del paper.

#3 · Reprodueix els vídeos al plafó

script.js · línies 333–340al codi complet
// A shadow root keeps the page's styles out, so the pane shows the lines as they were measured.
const pane = desk.querySelector('#screen').attachShadow({ mode: 'open' });
pane.innerHTML = renderToHtml(buildDocument({ markdown, resources },
  applyHtmlViewerOverrides(config())), { mode: 'single', padding: 0, background: '#ffffff',
  resourceImageUrl: imageUrl, // the posters, until a clip plays
  resourceVideoUrl: (fileId) => asset(fileId) }); // the file each <video> plays: the asset here
const top = (el) => el.getBoundingClientRect().top; // open the pane on the first player
pane.host.scrollTop = top(pane.querySelector('video')) - top(pane.host) - 48;

renderToHtml compon cada recurs de vídeo com un <video> d'HTML5 amb les opcions del reproductor com a atributs: controls, muted, loop, playsinline, preload="auto", disablepictureinpicture, disableremoteplayback i controlslist="nodownload". Aquest últim només amaga el botó. Qui tingui l'adreça pot desar el fitxer igualment, així que és ordre a la interfície, no protecció. resourceVideoUrl dona al motor una adreça reproduïble per a cada fileId, igual que resourceImageUrl fa amb les portades. Aquí és el recurs publicat; un lloc que desi els fitxers en una altra banda torna la seva pròpia URL, o la URL d'un blob amb els bytes. Sense ella, el reproductor fa servir video.url, i sense cap de les dues el plafó mostra la portada.

#4 · Posa els vídeos en un EPUB de maquetació fixa

script.js · línies 290–310al codi complet
const bytesOf = async (url) => new Uint8Array(await (await fetch(url)).arrayBuffer());
const media = new Map(await Promise.all(clips.map(async ({ video }) =>
  [video.fileId, { bytes: await bytesOf(asset(video.fileId)), mediaType: 'video/mp4' }])));
// Every face as bytes (gotcha: epub-embeds-given-fonts): the files loadFonts loaded, latin
// for each face and greek for the text face, limited to the Greek block and listed after
// latin, so a reading system tries it first for θ and π.
const faces = Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) =>
  ({ family, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' })));
const fonts = await Promise.all([...faces.map((face) => [face, 'latin']),
  ...faces.filter(({ family }) => family === TEXT)
    .map((face) => [{ ...face, unicodeRange: 'U+0370-03FF' }, 'greek'])]
  .map(async ([face, subset]) => ({ ...face, format: 'woff2', bytes: await bytesOf(
    `https://cdn.jsdelivr.net/npm/@fontsource/${fontsourceId(face.family)}@5/files/`
    + `${fontsourceId(face.family)}-${subset}-${face.weight}-${face.style}.woff2`) })));
const epub = await renderToEpub([doc], { layout: 'fixed', fonts,
  metadata: { title: doc.metadata.title, creators: ['Postext Cookbook'], language: LANG,
    rights: 'CC BY 4.0', modified: new Date('2026-10-05T00:00:00Z') }, // the same bytes each run
  // The clips as video/mp4 and the posters as pictures; the book packs both under media/.
  resourceBytes: (fileId) => media.get(fileId)
    ?? { bytes: imageBytes(fileId), mediaType: 'image/jpeg' },
});

El full s'organitza al voltant de dos vídeos l'un al costat de l'altre i de requadres buits per escriure, així que la maquetació fixa el conserva: cada pàgina com s'imprimeix, amb un reproductor on hi havia la portada. Un EPUB fluid també reproduiria els vídeos, l'un sota l'altre i a l'amplada del text. resourceBytes respon video/mp4 per a cada vídeo i un JPEG per a cada portada, i l'escriptor els desa a media/ i a images/. L'EPUB només conserva els atributs que admet el seu esquema (controls, autoplay, muted, loop, playsinline, preload), de manera que el botó de baixada i la resta queden en mans del sistema de lectura. El fitxer passa EPUBCheck sense errors ni avisos.

#5 · Compon θ i π al llenç, al PDF i a l'EPUB

Source Serif 4 guarda les lletres gregues en un fitxer de Fontsource propi, greek, al costat del latin. kitFonts(FONTS) troba lletres gregues al text i carrega aquest fitxer per a cada font de la família, i fontsourceProvider l'incrusta al PDF al costat del llatí en cada font que compon θ o π, així que aquestes dues lletres no necessiten codi. L'EPUB només incrusta les fonts que li passa el codi, per això el pas 4 hi afegeix els fitxers grecs de la font del text després dels llatins, cadascun limitat al bloc grec pel seu unicodeRange.

#6 · Calcula la taula al codi

script.js · línies 65–86al codi complet
// The arithmetic-geometric mean gives the elliptic integral K of the exact period in a few steps.
const T0 = 2 * Math.PI * Math.sqrt(1 / 9.81); // s: L = 1 m, g = 9.81 m/s²
const agm = (a, b) => (Math.abs(a - b) < 1e-15 ? a : agm((a + b) / 2, Math.sqrt(a * b)));
const period = (degrees) => T0 / agm(1, Math.cos((degrees * Math.PI) / 360));
const num = (x, digits) => x.toFixed(digits).replace('.', t({ en: '.', es: ',' }));
const cell = (content, align = 'right') => ({ content, align, verticalAlign: 'middle' });
const table = (id, caption, head, rows, columnWidths) => ({ id, typeId: 'table', kind: 'table',
  createdAt: 0, updatedAt: 0, caption: t(caption), placement: { position: 'here' },
  table: { model: { headerRowCount: 1, columnWidths, rows: [head.map((h, i) =>
    ({ ...cell(h, i ? 'right' : 'left'), isHeader: true })), ...rows] } } });
const periods = table('periods', { en: 'Exact periods of a pendulum 1.00 m long.',
  es: 'Periodos exactos de un péndulo de 1,00 m.' },
['Amplitude|Amplitud', 'T (s)', 'T/T~0~', 'Longer by|Aumento'].map((h) =>
  t({ en: h.split('|')[0], es: h.split('|').at(-1) })),
[5, 10, 20, 30, 45, 60, 80, 90].map((d) => [cell(`${d}°`, 'left'), cell(num(period(d), 3)),
  cell(num(period(d) / T0, 3)), cell(`${num((period(d) / T0 - 1) * 100, 2)} %`)]),
[1.2, 1, 1, 1.1]);
const blank = cell(' \n '); // two empty lines: room to write
const data = table('data', { en: 'Your measurements.', es: 'Tus medidas.' },
  t({ en: ['Clip', 'Swings in 8 s', 'T (s)'], es: ['Vídeo', 'Oscilaciones en 8 s', 'T (s)'] }),
  [10, 80].map((d, i) => [cell(`${t({ en: 'Video', es: 'Vídeo' })} ${i + 1} · ${d}°`, 'left'),
    blank, blank]), [1.2, 1.5, 0.8]);

El període exacte necessita la integral el·líptica completa K, i la mitjana aritmeticogeomètrica la dona en uns quants passos: T = T~0~ / AGM(1, cos ½θ~0~). La taula imprimeix tres decimals amb coma decimal en castellà, i les files de 10° i 80° coincideixen amb els vídeos: 2,010 s i 2,282 s, un 0,2 % i un 13,8 % més que T~0~ = 2,006 s. En 8 s surten gairebé quatre oscil·lacions completes al primer vídeo i tres i mitja al segon.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 132 · A lab sheet whose clips play on screen and in the EPUB ════
// https://postext.dev/en/cookbook/pendulum-lab-video-players
// Code: MIT · Text: original (CC BY 4.0) · Clips: rendered in code (CC BY 4.0)
// Fonts: Source Serif 4, Red Hat Display, Red Hat Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, buildDocumentWithFonts, prepareFonts, renderPageToCanvas, renderToHtml,
  applyHtmlViewerOverrides, registerResourceImage, defaultResourceTypes, resourceVideoLink,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { renderToEpub, readEpub } from 'https://esm.sh/postext-epub';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'pendulum-lab-video-players';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // the clips' own colours: a cream ground, the rust bob, warm black ink
  ink: '#22201b', // text, the play mark, the QR modules, table heads
  rust: '#a8432b', // the accent: the band, labels, list numbers (the bob's red, darker)
  cream: '#f6f1e4', rule: '#cbc2ae', // box fills, a shade deeper than the clips; hairlines
  muted: '#68625a', paper: '#ffffff' }; // muted: running heads, notes, prompts
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.rust }) // defaults: rust
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, MONO] = ['Source Serif 4', 'Red Hat Display', 'Red Hat Mono'];
const [TOP, INNER, OUTER, BAND, LEAD] = [22, 20, 17, 84, 13.2]; // mm, A4; LEAD in pt
const px = (value) => ({ value, unit: 'px' }); // the screen edition's sizes
const at = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x, y }, size });
const label = (size, color = 'rust') => ({ fontFamily: MONO, fontSize: pt(size), fontWeight: 600,
  letterSpacing: pt(size * 0.16), textTransform: 'uppercase', color: col(color) });

// #region answer: two clips of the book's own: a poster and a QR code, or a player
const clip = (id, file, poster, caption, altText) => ({
  id, typeId: 'video', kind: 'video', createdAt: 0, updatedAt: 0, caption: t(caption),
  note: t({ en: '8.00 s, 25 frames per second · Postext Cookbook, CC BY 4.0',
    es: '8,00 s, 25 fotogramas por segundo · Postext Cookbook, CC BY 4.0' }),
  altText: t(altText), placement: { position: 'bottom', span: 'column' },
  video: { source: 'file', fileId: file, format: 'mp4', width: 640, height: 360, duration: 8,
    url: asset(file), // the production address: printed as the QR code, linked from the PDF
    poster: { fileId: poster, format: 'jpeg', width: 640, height: 360 }, // the first frame
  },
});
const videoStyle = {
  playMark: { shape: 'rounded', position: 'top-left', size: mm(7), inset: mm(3),
    background: col('ink'), color: col('paper') },
  qr: { position: 'bottom-right', size: mm(19), inset: mm(2.5), // 111 characters: 45 modules
    color: col('ink'), background: col('paper'), radius: mm(1) },
  // The HTML5 player of a file honours every option. download: false writes
  // controlslist="nodownload": it hides the button, and the file stays at its address.

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Fes que un vídeo comenci tot sol

El player de cada vídeo se superposa a videoStyle.player. La reproducció automàtica sempre comença sense so, com exigeixen els navegadors.

 ];
+clips[0].video.player = { autoplay: true }; // the 10° clip starts as the pane opens

#Mostra la portada impresa en pantalla

Amb html: 'poster', l'edició HTML compon la portada amb la seva marca de reproducció i el seu codi QR, enllaçada a l'adreça de producció, en lloc del reproductor.

 const videoStyle = {
+  html: 'poster',

#Fes servir un vídeo de YouTube o de Vimeo

source: 'youtube' amb l'adreça del vídeo insereix el reproductor de YouTube des de youtube-nocookie.com (privacy està activat per defecte). Aquest reproductor atén menys opcions: controls, pantalla completa, reproducció automàtica, silenci i bucle; el de Vimeo hi afegeix el menú de velocitat i la imatge dins d'imatge, i cap dels dos no ofereix baixada. Un EPUB no pot inserir el reproductor d'una pàgina web, així que allà el vídeo és la seva portada enllaçada. Les opcions i el seu abast són a Configuració › Estil de vídeo.

Errors freqüents

Error freqüent

renderToEpub només incrusta les fonts que li passes

Les fonts que ha carregat el navegador no són fitxers que postext-epub pugui llegir: passa a options.fonts els bytes de cada font que fan servir les pàgines (els mateixos woff2 de Fontsource que va carregar la pàgina). Una font que falti s'avisa com a missingFont, i el sistema de lectura compon aquest text amb una de seva, que en una maquetació fixa ja no cap a les línies amb què es va compondre la pàgina. Incrusta només fonts la llicència de les quals ho permeti. Exportació a EPUB →

Error freqüent

Els fitxers de Fontsource cobreixen lletres, no símbols

El kit incrusta el fitxer latin de Fontsource de cada font i, quan el text els fa servir, el seu fitxer latin-ext per a č, ł, † i el seu fitxer greek per a α, χ (en una família que en tingui: Lora i Gelasio no), a la pantalla i al PDF. Símbols com →, ≈, ✓ i ★ no són a cap d'aquests fitxers i falten al PDF: dibuixa'ls, escriu-los com a matemàtiques o tria una font els fitxers de la qual els tinguin. Fonts incrustades al PDF →

Els MP4 són H.264. Chrome, Edge, Safari i Firefox els reprodueixen, i també el Chrome for Testing de la captura. Un Chromium compilat sense els seus còdecs propietaris, que és el que fa per defecte el projecte obert, no els reprodueix; codifica els vídeos en WebM (format: 'webm') si això importa als teus lectors.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • Video 1: a pendulum 1 m long released from 10°, 8 s at 25 frames per second, rendered from an RK4 solution of the pendulum equation (1 ms steps) with Python and encoded with ffmpeg · Postext Cookbook · CC BY 4.0
  • Video 2: the same pendulum released from 80°, rendered and encoded the same way · Postext Cookbook · CC BY 4.0
  • The first frame of Video 1, its printed poster · Postext Cookbook · CC BY 4.0
  • The first frame of Video 2, its printed poster · Postext Cookbook · CC BY 4.0
Fonts
Source Serif 4 (SIL OFL 1.1) · Red Hat Display (SIL OFL 1.1) · Red Hat Mono (SIL OFL 1.1)
SandboxPDF