Si existe SKILL.local.md en esta carpeta, léelo primero; contiene tus rutas, datos y reglas internas.
Desplazamiento en profundidad
Un formato de página para un conjunto de figuras que el lector recorre, una a la vez. La primera versión convirtió un conjunto de dibujos explicativos en un desplazamiento hacia el espectador, modelado a partir de la página de inicio de WhatTheFad (whatthefad.netlify.app, fuente en github.com/rafaelcarlosabbariao/cultural-archaeology).
El skill contiene cuatro archivos:
| Archivo | Qué es |
|---|---|
template.html | La página: el marco de la estación, la corriente, el carril y el script que los controla |
build.py | Completa la plantilla a partir de una especificación, como comando o como módulo |
capture.mjs | Capturas headless en tiempo real y comprobaciones de navegación sobre el protocolo DevTools |
SKILL.md | Este archivo |
Cuándo encaja
- Encaja para cuatro a doce paneles independientes que se lean uno a la vez, cada uno ajustado a una pantalla: dibujos, tarjetas de una sola idea, las etapas de una secuencia.
- No encaja para texto largo, tablas o cualquier cosa que el lector compare una al lado de la otra o escanee de un lado a otro. Para eso, crea una página plana.
- Salida. La página es un solo archivo
.htmlautónomo, sin scripts externos ni WebGL. La plantilla incluye una paleta de colores crema cálida y tinta en los tokens de:root; puedes cambiar el estilo a tu gusto.
Cómo funciona
El campo de WhatTheFad, la fuente
Lee el index.html de WhatTheFad (CSS #landing-trendfield y la función renderTrendField).
- Proyección. El campo es un contenedor con
perspective: 900px, y cada chip se coloca contranslate3d(x, y, z). El navegador dibuja un chip a escala 900 / (900 − z): 0.24 en z = −2800, 1 en el plano de la pantalla y 1.3 en z = 220. - Un reloj impulsa el movimiento. Un bucle
requestAnimationFramemueve cada chip hacia el espectador a 150 px/s multiplicado por un factor por chip de 0.75 a 1.25. Al pasar z = 220, reaparece en un anillo elíptico en z = −2800. - Desvanecimientos y orden de pintado. Un chip se desvanece en el primer cuarto de su profundidad y se desvanece entre z = 60
y 220. El campo nunca usa
preserve-3d, por lo que elz-indexde cada chip se establece desde su profundidad para que el más cercano se pinte encima. - El centro tranquilo. Una
mask-imageradial oculta el centro, donde los chips lejanos se reúnen en el punto de fuga. - Capturar un chip. El navegador vuelve a comprobar
:hoversolo cuando el puntero se mueve, por lo que un chip que se desliza bajo un cursor quieto nunca se ilumina. WhatTheFad prueba el puntero contra el rectángulo proyectado de cada chip en cada fotograma, y un chip capturado reduce la velocidad del campo al 8%.
Lo que agrega este formato
- El desplazamiento es la cámara.
- Una pista alta (
main.depth) contiene una parada por estación, separadas por una altura de etapa, conscroll-snap-type: y proximity. - Una etapa fija debajo del encabezado anclado sostiene la escena.
- La posición de desplazamiento se convierte en un índice de estación, entero en cada parada. La cámara se aproxima suavemente a él
(velocidad 9 por segundo), y la estación
ise dibuja en z = (cámara − i) × 1400.
- Una pista alta (
- El paso de una estación.
- La estación que espera detrás está atenuada y un poco baja, por lo que se eleva a su lugar a medida que avanza.
- En reposo está en z = 0 y escala 1, en píxeles enteros, por lo que su texto es tan nítido como una página plana.
- Al pasar al espectador, se desvanece en z = 300, a 1.5×.
- Una estación más alta que la etapa se escala para que quepa.
- La corriente. El campo de WhatTheFad, incluida la máscara. La velocidad de las tarjetas es una base de 46 más 0.9 de
la velocidad de la cámara, por lo que desplazarse hacia adelante las hace pasar rápidamente y desplazarse hacia atrás las aleja. Una
estación nombra los grupos de tarjetas que ilumina (
lit), y esas tarjetas se iluminan mientras está al frente. - Entrada.
- Rueda, trackpad, toque, las teclas de flecha, el carril y el contenido del encabezado mueven el mismo desplazamiento nativo, por lo que cada entrada llega a las mismas paradas.
- El foco que entra en una estación que no está al frente se desplaza hacia ella.
- La corriente es decorativa, y solo la estación en reposo acepta eventos de puntero, por lo que no se necesita una prueba de impacto por fotograma.
- Respaldo. Sin JavaScript, o con
prefers-reduced-motion: reduce, la página muestra las estaciones apiladas en plano. La profundidad se activa mediante una clasedeepque agrega el script. En modo plano, los anclajes del contenido se mueven a las estaciones.
Cómo construir una
SK a continuación es donde hayas instalado este skill, por ejemplo ~/.claude/skills/depth-scroll.
- Primero el contenido. Coloca cada panel en una página plana como
<figure class="fig">que contenga un.plate(el dibujo) y unfigcaption. La página plana también es la copia de lectura. Una estación puede, en su lugar, llevarhtmlsin procesar. - Escribe una especificación (a continuación), como un archivo JSON o como un diccionario en el propio script de compilación del proyecto cuando los valores se calculan (por ejemplo, nombres de tarjetas leídos de un archivo de datos).
- Constrúyelo.
o, desde un script:python3 -I $SK/build.py spec.jsonsys.path.insert(0, str(Path.home() / '.claude/skills/depth-scroll')) import build build.write(spec, base=HERE) - Encabezado opcional. La plantilla deja espacio para un encabezado anclado (
--pin-h,header.pin,nav.pin-toc). Sin uno, la etapa comienza en la parte superior de la ventana. - Compruébalo con
capture.mjs(a continuación), luego confirma los cambios.
La especificación
Las rutas son relativas a base: la carpeta del archivo de especificación, o la carpeta pasada a write. Las rutas de las
imágenes se escriben en la página tal como se dan, así que entrégalas relativas a la página de salida.
| Campo | Qué contiene |
|---|---|
out | La página a escribir |
title | El <title>, nombrado por tipo (<Asunto> <sustantivo de tipo>) |
source | Página plana opcional. Sus bloques figure.fig se convierten en fig: n, y sus bloques de estilo (no los del encabezado) se copian para que los dibujos mantengan sus clases |
kicker | La pequeña etiqueta sobre una estación de sección; el subtítulo de una subsección es el nombre de su sección |
door | HTML de la primera estación: un título destacado, una nota, un enlace a la página plana |
stations[] | id; sec y/o sub (las líneas de contenido; sec solo es una sección, sub solo una subsección, ambos abre una sección en esta estación); title (por defecto es sub, luego sec); lead (HTML, una o dos oraciones); fig o html; cards ([{img, label}], una fila de imágenes pequeñas); lit (grupos de la corriente a iluminar) |
cards_label | La etiqueta al final de la fila de imágenes de una estación |
close | {title, kicker, html} para la última estación, normalmente las fuentes |
stream[] | {label, img, group} por tarjeta. De cuarenta a ochenta se lee como una corriente |
css | CSS adicional opcional, agregado al final |
Comprobación
K=$SK/capture.mjs
node $K file:///ruta/pagina.html at-2.png 2 # una estación en reposo
node $K file:///ruta/pagina.html transit.png 4.4 --wait=900 # entre dos estaciones, disparando
node $K file:///ruta/pagina.html last.png 9 # la última parada es accesible
node $K file:///ruta/pagina.html light.png 5 --light # el fondo diurno
node $K file:///ruta/pagina.html phone.png 3 375 700 # ancho de teléfono
node $K file:///ruta/pagina.html flat.png 0 --reduce # la página con movimiento reducido
node $K "file:///ruta/pagina.html#st-model" hash.png - # un enlace a una parada, al cargar
node $K file:///ruta/pagina.html nav.png 0 --nav # flechas, el último enlace de contenido, el carril
Cada ejecución imprime las paradas y, por paso, y, front (la estación que recibe eventos de puntero),
rail, cardsShown, cardsLit, deep y pageWidth. Una estación en reposo tiene front igual a
su índice; pageWidth debe leer el ancho de la ventana gráfica (sin desplazamiento lateral de página). Mira cada
imagen, en ambos fondos y al ancho de teléfono, antes de darlo por terminado. Para páginas cuyas imágenes están
fuera de la carpeta, copia la página al bloc de notas con rutas de imagen absolutas primero.
No compruebes con chrome --headless --screenshot. Bajo --virtual-time-budget, los fotogramas de animación
apenas avanzan, por lo que la cámara suavizada nunca llega, y una captura de pantalla de una ventana desplazada puede
salir en blanco. capture.mjs impulsa un Chrome headless en tiempo real, donde los fotogramas se ejecutan a su velocidad real.
Ajuste
Las constantes se encuentran al principio del script en template.html.
| Constante | Valor | Qué mueve |
|---|---|---|
PERSP | 900 | Debe coincidir con la perspective CSS en .stations y .field |
GAP | 1400 | Profundidad mundial entre dos estaciones |
AHEAD | 2.2 × GAP | Hasta qué distancia se dibuja una estación por delante |
PASS | 300 | Donde una estación que pasa se ha desvanecido (escala 1.5) |
LIFT | 36 | Píxeles que una estación en espera se sienta baja por GAP de distancia |
DEPTH, NEAR | 2800, 220 | La profundidad de generación de la corriente y la profundidad donde una tarjeta ha pasado volando |
BASE | 46 | La velocidad de la corriente en reposo, px/s |
| suavizado de cámara | 9 por segundo | Qué tan rápido la cámara alcanza el desplazamiento |
Lo que salió mal en la primera versión
Cada uno de estos se encontró al mirar, y cada uno está corregido en la plantilla.
- El margen de desplazamiento del encabezado. El encabezado anclado le da a cada
[id]unscroll-margin-top, por lo que los anclajes aterrizan debajo de él. Los saltos aterrizaban 126 píxeles antes de cada parada hasta que las paradas se establecieron a cero. - La pista era un encabezado más corta. La página terminaba antes de que la última parada pudiera llegar a la parte superior. La altura de la pista usa la altura de la ventana, no la de la etapa.
- Las tarjetas volaban detrás de la columna de contenido. Esa columna es fija y transparente, por lo que las tarjetas se mostraban a través de su texto. Cuando la columna es fija, la etapa comienza a su derecha.
- Las tarjetas lejanas se reunían en el punto de fuga. La máscara de WhatTheFad lo solucionó.
- La estación que pasaba permanecía como un gran desenfoque. La solución fue un
PASSmás corto y un desvanecimiento al cuadrado. - La estación en espera se mostraba debajo de las estaciones cortas. Se dibuja atenuada (al cuadrado).
- El contenido del modo plano apuntaba a paradas ocultas. Las paradas se mueven a las estaciones.
- Un desplazamiento que aterrizaba antes del evento de carga golpeaba una página corta. La pista se diseña tan pronto
como se analiza el documento, y nuevamente una vez que las fuentes y las imágenes se asientan, por lo que un desplazamiento restaurado y un
enlace
#st-<id>aterrizan. - En un teléfono, los dibujos anchos se desplazan lateralmente dentro de su placa, la fila de imágenes está oculta y la estación se estrecha para que el carril mantenga el borde derecho.
Pendiente
- Capturar una tarjeta. En WhatTheFad, un chip capturado abre una excavación. Aquí una tarjeta podría abrir su registro, lo que requiere que la página de destino tome una identificación en su URL y la prueba de impacto proyectada anterior.
- Un control de pausa. La corriente se mueve mientras la página esté abierta. El movimiento reducido la detiene, pero no hay un botón de pausa, que WCAG 2.2.2 solicita para el movimiento que dura más de cinco segundos junto con otro contenido.
- La sensación en un trackpad y teléfono reales, y la velocidad de fotogramas, no han sido evaluadas por una persona.