En pocas palabras
Una hoja de prácticas de física con dos vídeos cortos de un péndulo. En papel cada vídeo es una imagen fija con un código que se escanea; en pantalla y en el libro electrónico el vídeo se reproduce en la página.
Lo que vas a componer
La práctica 4.2 de Física en el laboratorio, un cuaderno A4 para Bachillerato, sobre el periodo de un péndulo. Una banda de color teja lleva el título y los campos para el nombre, el grupo y la fecha. Al pie de la primera página, dos vídeos del mismo péndulo, soltado desde 10° y desde 80°, quedan uno junto al otro. En papel, cada vídeo es su primer fotograma con una marca de reproducción y un código QR que abre el MP4. En la edición de pantalla que acompaña a las páginas, y en el EPUB que escribe el código, esos mismos recursos se reproducen en el reproductor de vídeo del lector. La segunda página reúne el procedimiento, una tabla para rellenar, los periodos exactos que calcula el código y cuatro cuestiones con su recuadro para la respuesta.
Esta receta responde a
- ¿Cómo reproducen la edición HTML y el EPUB los vídeos del libro, y cómo oculto el botón de descarga?
- ¿Cómo pongo un vídeo en un libro impreso para que el lector pueda abrirlo desde la página?
La respuesta corta
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.' }),
];
Ingredientes
- Funciones
- Portadas de vídeo: marca de reproducción y código QRVídeos como recursosExportación a EPUBEdición de lectura en HTMLUn diseño más sencillo para pantallaTablas a partir de datosEstilo de tablasRecuadrosRecuadros anidadosEspacio vertical explícitoAperturas diseñadasAtributos de títuloTextos, filetes y cajas en los diseños de páginaCabeceras y foliosCabeceras según el tipo de páginaTipos de recurso propiosPaleta de color semánticaFuentes incrustadas en el PDF
- También usa
- Citas que colocan las figurasFiguras justo aquíFigura y Tabla en tu idiomaBanda de capítulo a todo el anchoEstilos de párrafoExportación a PDFFiguras y tablas como recursosSuperíndices y subíndices
- Tipografía
- Source Serif 4, Red Hat Display, Red Hat Mono (SIL OFL 1.1)
- Recursos
pendulum-large-poster.jpgpendulum-large.mp4pendulum-small-poster.jpgpendulum-small.mp4- Vídeo 1: un péndulo de 1 m soltado desde 10°, 8 s a 25 fotogramas por segundo, generado a partir de una solución RK4 de la ecuación del péndulo (pasos de 1 ms) con Python y codificado con ffmpeg (Postext Cookbook, CC BY 4.0)
- Vídeo 2: el mismo péndulo soltado desde 80°, generado y codificado del mismo modo (Postext Cookbook, CC BY 4.0)
- El primer fotograma del vídeo 1, su portada impresa (Postext Cookbook, CC BY 4.0)
- El primer fotograma del vídeo 2, su portada impresa (Postext Cookbook, CC BY 4.0)
Elaboración
#1 · Dale a cada vídeo una dirección de producción y un archivo
El código es la respuesta corta de arriba. Un vídeo propio tiene dos direcciones. video.url es donde lo encontrará el libro publicado: el código QR la imprime y el PDF enlaza la portada con ella, así que aquí es la dirección del vídeo en jsDelivr, la que un móvil puede abrir hoy. video.fileId indica el archivo, que se guarda aparte como un mapa de bits, para las salidas que pueden llevarlo o reproducirlo desde otro sitio (ver Formato del documento › Vídeos). Las opciones de videoStyle.player valen para todos los vídeos: se repiten en bucle, empiezan sin sonido, se cargan enteros (27 y 61 KB) y no ofrecen descarga, imagen dentro de imagen ni envío a otra pantalla, de modo que el vídeo se queda en la hoja.
#2 · Compón la edición de pantalla con el mismo original
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: [] } };
La edición de pantalla está en la configuración, en htmlViewer.overrides, que el canvas y el PDF no leen. A 122 ppp cada medida en puntos sale una cuarta parte mayor que a 96, así que el texto de 9,4 pt se lee a 16 px en el panel, y los pies, los recuadros y las tablas crecen con él. La apertura conserva el título y deja la banda y los campos, que son cosa del papel.
#3 · Reproduce los vídeos en el panel
// 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 compone cada recurso de vídeo como un <video> de HTML5 con las opciones del reproductor como atributos: controls, muted, loop, playsinline, preload="auto", disablepictureinpicture, disableremoteplayback y controlslist="nodownload". Este último solo oculta el botón. Quien tenga la dirección puede guardar el archivo igualmente, así que es orden en la interfaz, no protección. resourceVideoUrl le da al motor una dirección reproducible para cada fileId, igual que resourceImageUrl hace con las portadas. Aquí es el recurso publicado; un sitio que guarde los archivos en otra parte devuelve su propia URL, o la URL de un blob con los bytes. Sin ella, el reproductor usa video.url, y sin ninguna de las dos el panel muestra la portada.
#4 · Mete los vídeos en un EPUB de maquetación fija
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' },
});
La hoja se organiza en torno a dos vídeos uno junto al otro y a recuadros vacíos para escribir, así que la maquetación fija la conserva: cada página como se imprime, con un reproductor donde estaba la portada. Un EPUB de maquetación fluida también reproduciría los vídeos, uno debajo del otro y al ancho del texto. resourceBytes responde video/mp4 para cada vídeo y un JPEG para cada portada, y el escritor los guarda en media/ y en images/. El EPUB solo conserva los atributos que admite su esquema (controls, autoplay, muted, loop, playsinline, preload), de modo que el botón de descarga y lo demás quedan en manos del sistema de lectura. El archivo pasa EPUBCheck sin errores ni avisos.
#5 · Compón θ y π en el lienzo, el PDF y el EPUB
Source Serif 4 guarda las letras griegas en un archivo de Fontsource propio, greek, junto al latin. kitFonts(FONTS) encuentra letras griegas en el texto y carga ese archivo para cada fuente de la familia, y fontsourceProvider lo incrusta en el PDF junto al latino en cada fuente que compone θ o π, así que esas dos letras no necesitan código. El EPUB solo incrusta las fuentes que le pasa el código, por eso el paso 4 añade los archivos griegos de la fuente del texto después de los latinos, cada uno limitado al bloque griego por su unicodeRange.
#6 · Calcula la tabla en el código
// 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 periodo exacto necesita la integral elíptica completa K, y la media aritmético-geométrica la da en unos pocos pasos: T = T~0~ / AGM(1, cos ½θ~0~). La tabla imprime tres decimales con coma decimal en español, y las filas de 10° y 80° coinciden con los vídeos: 2,010 s y 2,282 s, un 0,2 % y un 13,8 % más que T~0~ = 2,006 s. En 8 s salen casi cuatro oscilaciones completas en el primer vídeo y tres y media en el segundo.
La receta completa
// ═══ 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.
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Haz que un vídeo empiece solo
El player de cada vídeo se superpone a videoStyle.player. La reproducción automática siempre empieza sin sonido, como exigen los navegadores.
];
+clips[0].video.player = { autoplay: true }; // the 10° clip starts as the pane opens#Muestra la portada impresa en pantalla
Con html: 'poster', la edición HTML compone la portada con su marca de reproducción y su código QR, enlazada a la dirección de producción, en lugar del reproductor.
const videoStyle = {
+ html: 'poster',#Usa un vídeo de YouTube o de Vimeo
source: 'youtube' con la dirección del vídeo inserta el reproductor de YouTube desde youtube-nocookie.com (privacy está activado por defecto). Ese reproductor atiende menos opciones: controles, pantalla completa, reproducción automática, silencio y bucle; el de Vimeo añade el menú de velocidad y la imagen dentro de imagen, y ninguno ofrece descarga. Un EPUB no puede insertar el reproductor de una página web, así que allí el vídeo es su portada enlazada. Las opciones y su alcance están en Configuración › Estilo de vídeo.
Errores frecuentes
Error frecuente
renderToEpub solo incrusta las fuentes que le pasas
Las fuentes que ha cargado el navegador no son archivos que postext-epub pueda leer: pasa en options.fonts los bytes de cada fuente que usan las páginas (los mismos woff2 de Fontsource que cargó la página). Una fuente que falte se avisa como missingFont, y el sistema de lectura compone ese texto con una suya, que en una maquetación fija ya no cabe en las líneas con que se compuso la página. Incrusta solo fuentes cuya licencia lo permita. Exportación a EPUB →
Error frecuente
Los archivos de Fontsource cubren letras, no símbolos
El kit incrusta el archivo latin de Fontsource de cada fuente y, cuando el texto los usa, su archivo latin-ext para č, ł, † y su archivo greek para α, χ (en una familia que lo tenga: Lora y Gelasio no), en pantalla y en el PDF. Símbolos como →, ≈, ✓ y ★ no están en ninguno de esos archivos y faltan en el PDF: dibújalos, escríbelos como matemáticas o elige una fuente cuyos archivos los tengan. Fuentes incrustadas en el PDF →
Los MP4 son H.264. Chrome, Edge, Safari y Firefox los reproducen, y también el Chrome for Testing de la captura. Un Chromium compilado sin sus códecs propietarios, que es lo que hace por defecto el proyecto abierto, no los reproduce; codifica los vídeos en WebM (format: 'webm') si eso importa a tus lectores.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- Vídeo 1: un péndulo de 1 m soltado desde 10°, 8 s a 25 fotogramas por segundo, generado a partir de una solución RK4 de la ecuación del péndulo (pasos de 1 ms) con Python y codificado con ffmpeg · Postext Cookbook · CC BY 4.0
- Vídeo 2: el mismo péndulo soltado desde 80°, generado y codificado del mismo modo · Postext Cookbook · CC BY 4.0
- El primer fotograma del vídeo 1, su portada impresa · Postext Cookbook · CC BY 4.0
- El primer fotograma del vídeo 2, su portada impresa · Postext Cookbook · CC BY 4.0
- Fuentes
- Source Serif 4 (SIL OFL 1.1) · Red Hat Display (SIL OFL 1.1) · Red Hat Mono (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


