Zum Inhalt springen

go-slides-Dokumentation

Marp-kompatible Foliensätze in reinem Go (CGO=0), mit Go-Vorlagen zur Interpolation und Folientypen (Kinds).

slides macht aus einem Marp-Foliensatz eine Präsentation, in reinem Go. Es liest das Markdown, das auch Marp liest – die Direktiven von Marpit, --- zwischen den Folien, ![bg]-Hintergründe, Sprechernotizen, die Themes default, gaia und uncover – und ergänzt zwei Dinge, die Marp nicht kennt:

  • Go-Vorlagen im Foliensatz, die ausgewertet werden, bevor das Markdown geparst wird, sodass ein Foliensatz seine eigenen Folien erzeugen kann;
  • Kinds (Folientypen): Eine Folie gibt an, was sie ist (title, section …), statt immer wieder zu wiederholen, wie sie aussieht.
v0.9.0. Diese Seiten beschreiben go-slides/slides v0.9.0 und sind unter /docs/0.9/ veröffentlicht.

Was es heute kann

slides build (der Standard)der Foliensatz als eine HTML-Seite: jede Folie ein <section> im SVG-Rahmen, der sich dem Fenster anpasst, dazu das CSS des Themes und ein Tastatur-Viewer
slides build --pdf, --images png, --image jpegder Foliensatz als PDF (eine Seite pro Folie, mit Gliederung) oder als PNG-/JPEG-Bilder, ohne Browser: go-webengine rendert, go-pdfkit schreibt das PDF – seit v0.4.0 als Vektoren, mit auswählbarem Text: Vektor-PDF
Mathematik und Code$…$ und $$…$$ setzt go-tex/math, Codeblöcke hebt go-rouge hervor, in HTML, Bildern und PDF: Mathematik und Code
Emoji:smile: und 😄 werden zu eingebetteten Twemoji-Bildern, brauchen also kein Netzwerk und erscheinen in jeder Ausgabe: Emoji (seit v0.4.0)
slides build --pptxder Foliensatz als PowerPoint-Datei mit Sprechernotizen und den Metadaten des Foliensatzes: in v0.4.0 ein Bild pro Folie wie bei marp-cli; seit v0.5.0 editierbar – Textfelder, Formen, Bilder, eingebettete Schriften (Editierbares PPTX und ODP)
slides build --odpdasselbe als OpenDocument-Präsentation (.odp)
einpassende Überschriften# <!-- fit --> Title füllt die Folienbreite in einer Zeile, auf der Seite und in jedem Export
slides expandder Foliensatz als reines Marp-Markdown: Vorlagen ausgewertet, Kinds durch die Spot-Direktiven ersetzt, für die sie stehen
slides notesdie Sprechernotizen
slides kinds, slides themeswas ein Foliensatz benennen kann
slides.yamlgemeinsame Kinds, Themes, Daten, HTML-Richtlinie und Sprache für einen Ordner voller Foliensätze
HCL---hcl-Front-Matter, slides.hcl, Kinds- und Datendateien in HCL2, mit Ausdrücken und Funktionen: HCL

Geplant

Noch nicht gebaut, und hier aufgeführt, damit niemand raten muss: Formeln als Vektoren im PDF (dort sind sie Bitmaps). Der Unterschied zu marp-cli liegt im Weg: Es rendert Bilder und PDF, indem es einen Headless-Chrome steuert; hier erledigen das Go-Bibliotheken.

Seiten

Erstellt am von tannevaled

Geändert am von tannevaled