Документація 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 замінено на spot-директиви, які вони означають |
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