Documentazione di go-slides
Stai leggendo la documentazione di una versione obsoleta; il suo contenuto potrebbe non essere più esatto. Vai all'ultima versione.
slides trasforma una presentazione Marp in una presentazione vera e propria, in puro Go. Legge il
Markdown che legge Marp — le direttive di Marpit, --- tra
le slide, gli sfondi ![bg], le note del relatore, i temi default, gaia e
uncover — e aggiunge due cose che Marp non ha:
- template Go dentro la presentazione, valutati prima che il Markdown venga analizzato, così una presentazione può generare le proprie slide;
- slide kinds (il tipo di una slide): una slide dichiara cos’è
(
title,section…) invece di ripetere che aspetto ha.
v0.17.1. Queste pagine descrivono
go-slides/slides v0.17.1
e sono pubblicate in
/docs/0.17/.Cosa fa oggi
slides build (il comando predefinito) | la presentazione come un’unica pagina HTML: ogni slide è una <section> inquadrata in un SVG che si adatta alla finestra, il CSS del tema, un visualizzatore da tastiera |
slides build --pdf, --images png, --image jpeg | la presentazione come PDF (una pagina per slide, con un indice) o come immagini PNG/JPEG, senza browser: go-webengine esegue il rendering, go-pdfkit scrive il PDF — in vettoriale dalla v0.4.0, con testo selezionabile: PDF vettoriale |
| matematica e codice | $…$ e $$…$$ composti da go-tex/math, blocchi di codice evidenziati da go-rouge, in HTML, immagini e PDF: Matematica e codice |
| emoji | :smile: e 😄 diventano immagini Twemoji incorporate, quindi non richiedono rete e vengono disegnate in ogni output: Emoji (dalla v0.4.0) |
slides build --pptx | la presentazione come file PowerPoint con le note del relatore e i metadati della presentazione: un’immagine per slide nella v0.4.0, come in marp-cli; modificabile dalla v0.5.0 — caselle di testo, forme, immagini, font incorporati (PPTX e ODP modificabili) |
slides build --odp | lo stesso come presentazione OpenDocument (.odp) |
| titoli adattati | # <!-- fit --> Title riempie la larghezza della slide su una sola riga, nella pagina e in ogni esportazione |
slides expand | la presentazione come semplice Markdown Marp: template valutati, kinds sostituiti dalle direttive spot che rappresentano |
slides notes | le note del relatore |
slides kinds, slides themes | ciò che una presentazione può nominare |
slides.yaml | kinds, temi, dati, criterio HTML e lingua condivisi per una cartella di presentazioni |
| HCL | front matter ---hcl, slides.hcl, kinds e file di dati in HCL2, con espressioni e funzioni: HCL |
La differenza con marp-cli è il percorso: esso produce immagini e PDF pilotando un Chrome headless; qui lo fanno librerie Go.
Pagine
- Per iniziare
- Galleria: dodici presentazioni di esempio, da aprire nel Playground
- Compatibilità con Marp
- Template
- Kinds
- HCL
- Matematica e codice
- Emoji
- Riga di comando
Created on by tannevaled
Modified on by tannevaled