Presentaciones

Abre Presentaciones en tu espacio de trabajo. Elige Nueva presentación e introduce un título, o pide una presentación a Strata Agent. Para un borrador con IA, describe el tema, el público y el propósito; elige la extensión, el tema visual y los documentos fuente. Revisa la estimación y el máximo de créditos antes de empezar.

Alterna entre Presentación y Documento para organizar las diapositivas o editar su contenido fuente y notas. Añade, duplica, reordena o excluye diapositivas y elige un tema. Selecciona Presentar para mostrar la presentación; la vista del presentador incluye notas, la siguiente diapositiva y un temporizador.

Empieza el documento con YAML entre líneas ---. Usa presentation: true para los valores predeterminados o un mapa presentation como el siguiente. aspect admite "16:9", "16:10" y "4:3".

---
presentation:
  aspect: "16:9"
---
# Informe del consejo

## Resultados
```slide layout="bullets"
- Aumento de ingresos
- Mejora de la retención de clientes
```

Explica las cifras al público.

El primer encabezado # es la portada; cada encabezado ## inicia una diapositiva. Un encabezado solo crea una diapositiva de título. Añade un bloque slide con layout="bullets" para mostrar viñetas, o un bloque html para un diseño personalizado. No combines ambos en una diapositiva. El texto fuera del diseño son notas del presentador, no contenido de la diapositiva.

Solo el primer encabezado # es la portada. Los encabezados ### permanecen en la diapositiva actual. Un encabezado ## que empiece por Appendix, sin distinguir mayúsculas, termina las diapositivas; el contenido posterior pertenece al apéndice.

Use strata-presentation para convertir la conversación en un público, un propósito y una secuencia de afirmaciones respaldadas. Lea el material fuente y el sistema de diseño de la empresa antes de aplicar estilos. Use un titular por diapositiva, pruebas en su contenido visual y narración en el texto normal de la sección. Guarde con edit_document y vuelva a leer el resultado; revise las vistas previas HTML disponibles e indique los límites de renderizado.

Ancle cada edición HTML a un id descriptivo y único en la presentación. Incluya ese id en oldString y newString, haciendo coincidir un solo fragmento actual con replaceAll=false. Es una convención de sustitución de texto, no una API de selectores por ID. Vuelva a leer si no hay coincidencia o es ambigua; no fuerce una reescritura completa. Sustituya documentId en el ejemplo por el valor real devuelto. Prefiera ediciones pequeñas con anclas: con replaceAll=false, se rechaza una coincidencia ausente o ambigua en la réplica Yjs en memoria de la tarea ECS que atiende la solicitud, según las reglas de coincidencia de la API, que pueden normalizar comillas, marcadores de notas al pie y espacios en blanco. No es una comparación exacta de bytes ni una operación compare-and-swap distribuida. Un cambio ya confirmado por otra tarea puede no haber llegado a esa réplica; un ancla obsoleta puede coincidir antes de que se integren los registros WAL concurrentes durante la persistencia. Las ediciones de caracteres afectan al fragmento coincidente; las ediciones entre nodos o de bloques pueden recurrir a una conversión de ida y vuelta a Markdown y una reescritura estructural. Ninguna vía MCP de escritura del contenido acepta una documentVersion esperada ni garantiza seguridad frente a un editor concurrente. Si la presentación parece estar editándose activamente, avise al usuario y coordine una pausa o prepare una copia separada. La relectura confirma un resultado observado, no la seguridad ante cambios concurrentes.

grammarVersion: 1

Un bloque YAML inicial con presentation: true activa los valores predeterminados. El mapa presentation solo acepta aspect (16:9, 16:10, 4:3), transition (fade, none, slide), form (slides, whole-deck) y notes (presenter, none). Los valores predeterminados son 16:9, fade, slides, presenter. El límite YAML es 16 KiB. El tema no se configura en el frontmatter.

En el formato slides, el primer H1 de nivel superior es la portada; cada H2 inicia una diapositiva. H3–H6 y los bloques normales son notas. Un H1 posterior y su contenido pasan a ser notas de la sección anterior hasta el siguiente H2 y se informa duplicate-cover. El preámbulo se adjunta a la portada, si existe. El primer H2 cuyo texto, sin espacios exteriores y sin distinguir mayúsculas, empieza por appendix termina el procesamiento de diapositivas, incluidos los títulos posteriores.

El primer bloque html de una sección es su contenido visual; se informa del HTML adicional y no se selecciona. Combinar bloques html y slide excluye la sección. Sin HTML, el primer bloque slide selecciona layout=title, statement, bullets, big-number, two-column o image; un diseño ausente o inválido informa unknown-layout y usa statement en la estructura. Los bloques slide posteriores son notas. Sin ninguno, la diapositiva contiene solo el titular. Layout pertenece únicamente a bloques slide, que descartan name pero conservan uses: una diapositiva con layout=image nombra su imagen mediante uses, y la que no declara ninguna informa image-slide-without-source. Name declara una fuente de datos; uses en un visual HTML enumera dependencias separadas por comas.

Vincule los números dibujados a bloques json/csv/tsv/yaml o tablas con nombre, preferiblemente en el apéndice. El HTML declara uses, lee fuentes etiquetadas mediante strata.data.get y se redibuja con strata:data. Decodifique según kind y format, incluidos los datos no disponibles; consulte interactive-html. Agregue las fuentes para no superar 128 KiB cada una y 256 KiB en total. Asigne IDs a elementos editables y un comentario de diapositiva dentro del bloque HTML; data-deck-headline recibe el encabezado cuando el shell está activo. Conserve texto de respaldo legible para vistas previas normales.

Crea, edita y presenta diapositivas en Strata. Empieza con una presentación vacía, pide a Strata Agent un borrador basado en tus documentos o importa Markdown.

---
presentation:
  aspect: '16:9'
  transition: fade
  form: slides
  notes: presenter
---
# Launch

```slide layout=title
A smaller first release

Priya Raman, March
```

## Focus

```slide layout=bullets
What ships first:

- One workspace
- One integration
- Nothing else
```

Say the internal negotiation out loud; this paragraph stays a presenter note.

## The room

```slide layout=image uses=launchPhoto
Launch day, Oslo
```

## Adoption

```html
<!-- slide: adoption -->
<main id="s03-adoption" style="padding:var(--deck-padding)">
  <h1 class="deck-title" data-deck-headline>Adoption</h1>
  <p id="s03-rationale">A smaller release gives us a clear learning signal.</p>
</main>
```

## Appendix

<!-- strata:name=launchPhoto -->

![The team on launch day](launch-day.png)

```css name=deckTheme extends=strata-light
:root { --deck-accent: #1d4ed8; }
```

Busque y lea el sistema de diseño de la empresa y copie su CSS en un único bloque css name=theme. Registre source y sourceVersion juntos con el ULID real del documento y su versión decimal cuando se conozcan; ambos son necesarios para la procedencia. Conserve locked=true si ya existe. La copia es contenido local: la resolución nunca consulta ni actualiza la fuente. Si no hay un tema de empresa disponible, empiece con strata-light.

Para archivos de Claude Design, variables de Figma, Tailwind o una guía de marca, asigne fondo, texto, acento, texto secundario, dos familias de fuentes, relleno y radio a los ocho tokens. Coloque las adaptaciones de la presentación en deckTheme. Incruste solo fuentes autorizadas como URL data:, con alternativas del sistema; conserve los glifos necesarios y compruebe que el CSS codificado no supere 256 KiB. Indique los colores aproximados y las sustituciones tipográficas.

Las cinco capas, de menor a mayor prioridad, son deck-base, deck-strata, deck-company, deck-deck y deck-slide; preview-base las precede. Use css name=deckTheme para cambios locales. Su extends prevalece sobre el extends de la empresa y después se usa strata-light. Los temas incluidos son strata-light, strata-dark, strata-editorial y strata-mono. Los nombres desconocidos generan un aviso y usan el tema de respaldo. Los estilos en línea siguen la cascada CSS normal.

Defina los ocho tokens de empresa mostrados abajo en una regla :root simple de nivel superior. No se leen tokens en html, body, selectores mixtos o reglas @media/@layer anidadas y se informa theme-token-outside-root. Use var(--deck-...) en las diapositivas. Mantenga el CSS dentro de 256 KiB, equilibrado, sin !important ni importaciones/URL externas; se permiten recursos data:. El contraste entre texto y fondo debe ser al menos 4.5:1; las expresiones de color no compatibles generan contraste desconocido. Los nombres de tema duplicados desactivan esa capa. Un bloqueo de empresa informa de cambios en tokens de la presentación, pero no impide que prevalezcan.

```css name=theme extends=strata-light
:root {
  --deck-bg: #ffffff;
  --deck-fg: #111318;
  --deck-accent: #1d4ed8;
  --deck-muted: #586174;
  --deck-font-heading: system-ui, sans-serif;
  --deck-font-body: system-ui, sans-serif;
  --deck-padding: 6cqw;
  --deck-radius: 12px;
}
```

Propietarios y editores leen el documento completo. Lectores, comentaristas y usuarios con permiso solo para sugerir reciben una edición con los títulos y visuales aceptados, sin las notas normales. Ponga la narración privada fuera de los bloques visuales. notes: none describe la visibilidad del panel, no la privacidad. Quitar o desactivar presentation convierte el documento en uno normal y los lectores pueden recibir todo su contenido.

La edición también conserva el CSS del tema, bloques JSON/CSV/TSV/YAML o tablas con nombre declarados por uses de los visuales aceptados, y los ajustes de presentation. Los recursos se conservan incluso desde el apéndice; en slides también se conserva su título. Los bloques se copian enteros: HTML oculto, comentarios, scripts y campos de datos sin usar pueden exponer contenido privado. Se omiten el texto normal del apéndice y otras claves del frontmatter.

Con form: whole-deck, el primer bloque HTML de nivel superior anterior al apéndice es toda la presentación; los títulos no crean diapositivas. El entorno compartido puede navegar mediante un strata.deck.registerAdapter escrito por el autor con count(), current() y goTo(index). Las notas dentro de ese HTML no pueden eliminarse: notesPrivacy es notStripped y publicar requiere aceptación explícita. Mantenga las notas confidenciales fuera del HTML.

Usa Exportar para obtener PDF o HTML independiente, o pide a tu asistente conectado que use export_presentation. Los enlaces de descarga duran quince minutos. PDF consume la cuota de capturas del propietario; HTML no se contabiliza. Se eliminan las notas del presentador. Se rechaza la exportación de HTML whole-deck porque no se pueden eliminar las notas privadas con fiabilidad. No se admite exportar a PPTX.

Conserve los archivos existentes y revise su formato. Para Markdown UTF-8, mida los bytes, llame a edit_document con action=presignUpload y contentLength más documentId o title/folderId, envíe los bytes exactos mediante PUT con todos los requiredHeaders devueltos y después finalizeUpload con uploadId. Lea el resultado tras finalizar. Adapte las presentaciones HTML a una copia Markdown whole-deck y compruebe dependencias y notas internas. La carga de archivos de oficina convierte PPTX/PDF/DOCX en documentos normales; no garantiza la fidelidad original de las diapositivas. No envíe esos binarios por el flujo de carga Markdown. Usar un documentId existente solicita reemplazar todo el contenido al ejecutar finalizeUpload; el PUT solo almacena los bytes temporalmente. Ni finalizeUpload ni action=write aceptan una versión esperada, por lo que el reemplazo puede sobrescribir cambios de colaboradores sin un error de conflicto de versión. Prefiera llamadas edit pequeñas y con anclas únicas y replaceAll=false; solo comprueban la réplica de la tarea que atiende la solicitud, y las ediciones de bloques pueden recurrir a una reescritura estructural. Ninguna vía MCP de escritura del contenido garantiza seguridad frente a un editor concurrente. Si la presentación parece estar editándose activamente, avise al usuario y coordine una pausa o prepare una copia separada. Si el reemplazo es inevitable, vuelva a leer inmediatamente antes de finalizar, compare documentVersion con la versión usada para preparar el archivo y cancele si cambió. Una versión sin cambios reduce la ventana de carrera, pero no la elimina.

Dividir una presentación HTML es una transformación realizada por el agente, no una herramienta de importación. Exija cinco comprobaciones: una sección por diapositiva; estilos locales sin hojas enlazadas; scripts cuyo acceso al DOM se limite a su sección, salvo la navegación identificada; recursos autocontenidos; y un título por sección. Si no puede establecer el aislamiento de un script, conserve whole-deck e identifique el script. Si se solicita una división viable, cree otro documento, convierta la primera sección en la portada H1, conserve IDs y secciones e indique que la fidelidad visual no está verificada.

Ejecuta la validación antes de presentar o exportar. validate_presentation comprueba diseño, contraste, vínculos de datos, estructura y temas, y guarda capturas. Cada llamada comprueba como máximo dos diapositivas en un tamaño de vista; continúa con next mientras status sea more, sin cambiar la selección. Se consume una captura por diapositiva y tamaño, sin repetir el cargo por la misma clave de renderizado en el ciclo de facturación. Revisa los resultados, corrige el contenido fuente y vuelve a comprobarlo.

{
  "action": "edit",
  "documentId": "<documentId>",
  "oldString": "<strong id=\"s02-target\">84%</strong>",
  "newString": "<strong id=\"s02-target\">87%</strong>",
  "replaceAll": false
}

Use list_company_themes y get_company_theme para copiar una revisión verificada del tema de la empresa. Una rutina de agente por presentación observa eventos updated del documento del tema y de la presentación, con target apuntando a la presentación y sin output. Propone sugerencias ancladas con baseVersion y sourceRef; nunca acepta, edita ni publica. Las generaciones más recientes de la fuente sustituyen las propuestas pendientes anteriores. Ante suggestionBaseMoved o suggestionSourceMoved, espere a la siguiente ejecución o vuelva a ejecutar, sin sobrescribir. Los datos copiados de otros documentos siguen siendo instantáneas. Un administrador debe crear la carpeta Themes cuando setupRequired sea true.