Presentazioni

Apri Presentazioni nell’area di lavoro. Scegli Nuova presentazione e inserisci un titolo, oppure chiedi una presentazione a Strata Agent. Per una bozza con IA, descrivi argomento, pubblico e obiettivo; scegli lunghezza, tema e documenti di origine. Controlla la stima e il limite di crediti prima di iniziare.

Passa tra Presentazione e Documento per organizzare le diapositive o modificarne sorgente e note. Aggiungi, duplica, riordina o escludi diapositive e scegli un tema. Seleziona Presenta; la vista relatore include note, diapositiva successiva e timer.

Inizia il documento con YAML tra righe ---. Usa presentation: true per i valori predefiniti, oppure una mappa presentation come nell’esempio. aspect può essere "16:9", "16:10" o "4:3".

---
presentation:
  aspect: "16:9"
---
# Relazione al consiglio

## Risultati
```slide layout="bullets"
- Ricavi in crescita
- Fidelizzazione dei clienti migliorata
```

Spiega i dati al pubblico.

La prima intestazione # è la copertina; ogni intestazione ## avvia una diapositiva. Un’intestazione da sola crea una diapositiva con un titolo. Aggiungi un blocco slide con layout="bullets" per mostrare elenchi puntati, oppure un blocco html per un elemento visivo personalizzato. Non combinarli nella stessa diapositiva. Il testo esterno all’elemento visivo costituisce le note del relatore, non il contenuto della diapositiva.

Solo il primo titolo # è la copertina. I titoli ### restano nella diapositiva corrente. Un titolo ## che inizia con Appendix, senza distinzione tra maiuscole e minuscole, termina le diapositive; il contenuto successivo appartiene all’appendice.

Usate strata-presentation per ricavare dalla conversazione pubblico, scopo e una sequenza di affermazioni documentate. Leggete le fonti e il sistema di design aziendale prima di definire gli stili. Usate un titolo per diapositiva, prove nel contenuto visivo e narrazione nel testo ordinario della sezione. Salvate con edit_document e rileggete il risultato; controllate le anteprime HTML disponibili e segnalate i limiti di rendering.

Ancorate ogni modifica HTML a un id descrittivo e univoco nell’intera presentazione. Includete tale id in oldString e newString, facendo corrispondere un solo frammento attuale con replaceAll=false. È una convenzione di sostituzione testuale, non un’API di selettori ID. Rileggete se la corrispondenza manca o è ambigua; non forzate una riscrittura completa. Sostituite documentId nell’esempio con il valore effettivamente restituito. Preferire piccole modifiche ancorate: con replaceAll=false, una corrispondenza assente o ambigua viene rifiutata nella replica Yjs in memoria del task ECS che gestisce la richiesta, secondo le regole di corrispondenza dell’API, che possono normalizzare virgolette, marcatori delle note a piè di pagina e spazi. Non è un confronto esatto dei byte né un compare-and-swap distribuito. Una modifica già registrata da un altro task potrebbe non aver raggiunto la replica; un’ancora obsoleta può corrispondere prima dell’integrazione dei record WAL concorrenti durante la persistenza. Le modifiche a livello di carattere interessano il frammento corrispondente; quelle tra nodi o ai blocchi possono ricorrere a una conversione di andata e ritorno in Markdown e a una riscrittura strutturale. Nessun percorso MCP di scrittura del contenuto accetta una documentVersion attesa né garantisce sicurezza in presenza di modifiche simultanee. Se la presentazione sembra in fase di modifica attiva, informare l’utente e concordare una pausa o preparare una copia separata. La rilettura conferma un risultato osservato, non la sicurezza rispetto alla concorrenza.

grammarVersion: 1

Un blocco YAML iniziale con presentation: true abilita i valori predefiniti. La mappa presentation accetta solo aspect (16:9, 16:10, 4:3), transition (fade, none, slide), form (slides, whole-deck) e notes (presenter, none). I valori predefiniti sono 16:9, fade, slides, presenter. Il limite YAML è 16 KiB. Il tema non è un’impostazione del frontmatter.

Nel formato slides, il primo H1 di primo livello è la copertina; ogni H2 avvia una diapositiva. H3–H6 e blocchi ordinari sono note. Un H1 successivo e il suo contenuto diventano note della sezione precedente fino al prossimo H2, con la segnalazione duplicate-cover. Il preambolo è associato alla copertina, se presente. Il primo H2 il cui testo, senza spazi esterni e ignorando maiuscole e minuscole, inizia con appendix termina l’elaborazione delle diapositive, inclusi i titoli successivi.

Il primo blocco html di una sezione è il suo contenuto visivo; l’HTML aggiuntivo viene segnalato e non selezionato. Combinare blocchi html e slide esclude la sezione. Senza HTML, il primo blocco slide seleziona layout=title, statement, bullets, big-number, two-column o image; un layout mancante/non valido segnala unknown-layout e usa statement nella struttura. I blocchi slide successivi sono note. In assenza di entrambi, la diapositiva contiene solo il titolo. Layout appartiene solo ai blocchi slide, che scartano name ma conservano uses: una diapositiva con layout=image nomina la sua immagine con uses e quella che non ne dichiara alcuna segnala image-slide-without-source. Name dichiara una fonte dati; uses elenca le dipendenze del contenuto HTML separate da virgole.

Colleghi i numeri disegnati a blocchi json/csv/tsv/yaml o tabelle con nome, preferibilmente nell’appendice. L’HTML dichiara uses, legge fonti etichettate tramite strata.data.get e si ridisegna su strata:data. Decodifichi in base a kind e format, gestendo anche i dati non disponibili; consulti interactive-html. Aggreghi le fonti entro 128 KiB ciascuna e 256 KiB totali. Assegni ID agli elementi modificabili e un commento della diapositiva nel blocco HTML; data-deck-headline riceve il titolo quando la shell è attiva. Mantenga testo di ripiego leggibile per le anteprime ordinarie.

Crea, modifica e presenta diapositive in Strata. Parti da una presentazione vuota, chiedi a Strata Agent una bozza dai documenti di origine oppure 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; }
```

Trovate e leggete il sistema di design aziendale, quindi copiate il CSS in un solo blocco css name=theme. Registrate insieme source e sourceVersion con l’ULID reale del documento e la versione decimale reale, quando noti; entrambi sono necessari per la provenienza. Conservate un eventuale locked=true. La copia è contenuto locale: la risoluzione non recupera né aggiorna mai la fonte. Se non è disponibile un tema aziendale, iniziate con strata-light.

Per file Claude Design, variabili Figma, Tailwind o linee guida del marchio, associ sfondo, testo, accento, testo secondario, due stack di caratteri, spaziatura interna e raggio agli otto token. Inserisca gli adattamenti specifici in deckTheme. Incorpori solo font autorizzati come URL data:, con alternative di sistema; preservi i glifi necessari e verifichi il limite di 256 KiB dopo la codifica del CSS. Segnali colori approssimativi e sostituzioni dei caratteri.

I cinque livelli, dalla priorità più bassa alla più alta, sono deck-base, deck-strata, deck-company, deck-deck e deck-slide; preview-base li precede. Usate css name=deckTheme per le modifiche locali. Il suo extends prevale su quello aziendale, poi si usa strata-light. I temi inclusi sono strata-light, strata-dark, strata-editorial e strata-mono. I nomi sconosciuti generano una segnalazione e usano il tema di riserva. Gli stili inline seguono comunque la normale cascata CSS.

Definite gli otto token aziendali mostrati sotto in una semplice regola :root di primo livello. I token in html, body, selettori misti o regole @media/@layer annidate non vengono letti e segnalano theme-token-outside-root. Usate var(--deck-...) nelle diapositive. Mantenete il CSS entro 256 KiB, con delimitatori bilanciati, senza !important o importazioni/URL esterni; sono consentite risorse data:. Il contrasto testo/sfondo deve essere almeno 4.5:1; le espressioni colore non supportate segnalano contrasto sconosciuto. Nomi di tema duplicati disattivano il relativo livello. Un blocco aziendale segnala le sostituzioni dei token nella presentazione, ma non impedisce loro di prevalere.

```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;
}
```

Proprietari ed editor leggono il documento completo. Lettori, commentatori e utenti con sola facoltà di suggerire ricevono un’edizione con titoli e contenuti visivi accettati, senza le note ordinarie. Inserite la narrazione privata fuori dai blocchi visivi. notes: none descrive la visibilità del pannello, non la riservatezza. Rimuovere o disattivare presentation rende nuovamente ordinario il documento, consentendo ai lettori di riceverne l’intero contenuto.

L’edizione conserva anche il CSS dei temi, i blocchi JSON/CSV/TSV/YAML o le tabelle con nome dichiarati da uses dei visuali accettati, e le impostazioni presentation. Le risorse vengono conservate anche dall’appendice; nel formato slides si conserva anche il suo titolo. Questi blocchi vengono copiati interamente: HTML nascosto, commenti, script e campi inutilizzati possono esporre contenuti privati. Il testo ordinario dell’appendice e le altre chiavi del frontmatter vengono omessi.

Con form: whole-deck, il primo blocco HTML di primo livello prima dell’appendice è l’intera presentazione; i titoli non creano diapositive. L’ambiente condiviso può navigarla tramite un strata.deck.registerAdapter scritto dall’autore con count(), current() e goTo(index). Le note interne a quell’HTML non possono essere rimosse: notesPrivacy è notStripped e la pubblicazione richiede un’accettazione esplicita. Tenete le note riservate fuori dall’HTML.

Usa Esporta per ottenere PDF o HTML autonomo, oppure chiedi all’assistente collegato di usare export_presentation. I link durano quindici minuti. Il PDF usa la quota di acquisizioni del proprietario; l’HTML non viene conteggiato. Le note del relatore vengono rimosse. L’esportazione HTML whole-deck viene rifiutata perché le note private non possono essere eliminate in modo affidabile. L’esportazione PPTX non è supportata.

Conservate i file esistenti ed esaminatene il formato. Per Markdown UTF-8, misurate i byte, chiamate edit_document con action=presignUpload e contentLength più documentId o title/folderId, inviate i byte esatti tramite PUT con tutti i requiredHeaders restituiti, poi finalizeUpload con uploadId. Rileggete dopo la finalizzazione. Adattate le presentazioni HTML in una copia Markdown whole-deck e controllate dipendenze della sandbox e note interne. Il caricamento di file Office converte PPTX/PDF/DOCX in documenti ordinari; non garantisce la fedeltà delle diapositive originali. Non inviate tali file binari tramite il flusso Markdown. Usare un documentId esistente richiede la sostituzione completa al momento di finalizeUpload; il PUT memorizza solo temporaneamente i byte. Né finalizeUpload né action=write accettano una versione attesa, quindi la sostituzione può sovrascrivere modifiche dei collaboratori senza un errore di conflitto di versione. Preferire chiamate edit piccole, con ancore univoche e replaceAll=false; verificano solo la replica del task che gestisce la richiesta e le modifiche ai blocchi possono ricorrere a una riscrittura strutturale. Nessun percorso MCP di scrittura del contenuto garantisce sicurezza in presenza di modifiche simultanee. Se la presentazione sembra in fase di modifica attiva, informare l’utente e concordare una pausa o preparare una copia separata. Se la sostituzione è inevitabile, rileggere subito prima della finalizzazione, confrontare documentVersion con la versione usata per preparare il file e interrompere se è cambiata. Una versione invariata restringe la finestra di concorrenza, ma non la chiude.

La suddivisione di una presentazione HTML è una trasformazione eseguita dall’agente, non uno strumento di importazione. Richiede cinque verifiche: una sezione per diapositiva; stili locali senza fogli collegati; script con accesso DOM limitato alla sezione, salvo la navigazione identificata; risorse autonome; e un titolo per sezione. Se non può accertare l’isolamento di uno script, mantenga whole-deck e indichi lo script. Per una suddivisione richiesta e ammissibile, crei un documento separato, trasformi la prima sezione nella copertina H1, preservi ID e sezioni e segnali la fedeltà visiva non verificata.

Esegui la convalida prima di presentare o esportare. validate_presentation controlla impaginazione, contrasto, collegamenti ai dati, struttura e temi, e salva acquisizioni. Ogni chiamata controlla al massimo due diapositive a una dimensione di visualizzazione; continua con next finché status è more, mantenendo la selezione invariata. Viene conteggiata un’acquisizione per diapositiva e dimensione, senza nuovi addebiti per la stessa chiave di rendering nel ciclo di fatturazione. Esamina i risultati, correggi la sorgente e ricontrolla.

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

L’aggiornamento automatico delle presentazioni non è disponibile. list_company_themes, get_company_theme e il contratto target/sourceRef/baseVersion delle routine di presentazione non sono implementati. Copiate i temi con find e read_document, registrate la provenienza verificata e indicate che temi e dati copiati sono istantanee. L’esistenza di questa sezione non abilita una routine. Aggiornate una copia solo tramite una modifica verificata e richiesta esplicitamente.