Документация go-slides
Вы читаете документацию устаревшей версии; её содержимое может быть уже неточным. Перейти к последней версии.
slides превращает презентацию Marp в готовую презентацию на чистом Go. Он читает
Markdown, который читает Marp: директивы Marpit, --- между
слайдами, фоны ![bg], заметки докладчика, темы default, gaia и
uncover — и добавляет две вещи, которых в Marp нет:
- шаблоны Go внутри презентации, вычисляемые до разбора Markdown, так что презентация может сама порождать свои слайды;
- kinds (типы слайдов): слайд говорит, чем он является
(
title,section…), вместо того чтобы повторять, как он выглядит.
v0.18.0. Эти страницы описывают
go-slides/slides v0.18.0
и опубликованы по адресу
/docs/0.18/.Что он умеет сегодня
slides build (по умолчанию) | презентация в виде одной HTML-страницы: каждый слайд — <section> в SVG-рамке, масштабируемой под окно, CSS темы, просмотрщик с управлением с клавиатуры |
slides build --pdf, --images png, --image jpeg | презентация в виде PDF (одна страница на слайд, с оглавлением) или изображений PNG/JPEG, без браузера: рисует go-webengine, PDF пишет go-pdfkit — векторный начиная с v0.4.0, с выделяемым текстом: Векторный PDF |
| математика и код | $…$ и $$…$$ набирает go-tex/math, блоки кода подсвечивает go-rouge — в HTML, изображениях и PDF: Математика и код |
| эмодзи | :smile: и 😄 становятся изображениями Twemoji, встроенными, так что сеть не нужна и они рисуются в любом формате: Эмодзи (начиная с v0.4.0) |
slides build --pptx | презентация в виде файла PowerPoint с заметками докладчика и метаданными: в v0.4.0 — по картинке на слайд, как в marp-cli; редактируемая начиная с v0.5.0 — текстовые блоки, фигуры, картинки, встроенные шрифты (Редактируемые PPTX и ODP) |
slides build --odp | то же в виде презентации OpenDocument (.odp) |
| заголовки по ширине | # <!-- fit --> Title растягивает заголовок на всю ширину слайда в одну строку — на странице и в каждом экспорте |
slides expand | презентация в виде обычного Markdown для Marp: шаблоны вычислены, kinds заменены точечными директивами, которые они обозначают |
slides notes | заметки докладчика |
slides kinds, slides themes | то, что презентация может назвать по имени |
slides.yaml | общие kinds, темы, данные, политика HTML и язык для папки с презентациями |
| HCL | front matter ---hcl, slides.hcl, файлы kinds и данных в HCL2, с выражениями и функциями: HCL |
Отличие от marp-cli — в способе: он рисует изображения и PDF, управляя headless Chrome; здесь это делают библиотеки Go.
Страницы
- Первые шаги
- Галерея: двенадцать примеров презентаций, которые можно открыть в Playground
- Совместимость с Marp
- Шаблоны
- Kinds
- HCL
- Математика и код
- Эмодзи
- Командная строка
Created on by tannevaled
Modified on by tannevaled