Сумісність з Marp

Презентація, написана для Marp, є презентацією go-slides. Наведені нижче правила — це правила Marpit і Marp Core; там, де go-slides відрізняється, ця сторінка про це каже.

Слайди

Горизонтальна лінія — --- в окремому рядку, як розділяє Marpit, — починає новий слайд, так само як і заголовок того рівня, який називає директива headingDivider. Front matter, між першими двома ---, містить глобальні директиви та дані презентації.

Директиви

Локальні директиви — ті, що в Marpit: paginate, header, footer, class, backgroundColor, backgroundImage, backgroundPosition, backgroundRepeat, backgroundSize, color. Директиви розбираються як вільний YAML, як це робить Marp Core; --strict-yaml розбирає їх так, як звичайний Marpit.

Зображення

![bg](image.jpg) робить зображення фоном слайда, з ключовими словами Marp: bg contain, bg cover, bg 50%, bg left/bg right для розділеного фону, кілька зображень bg поруч і фільтри зображень (blur, sepia, grayscale…). Розміри вбудованих зображень (w:200px, h:) читаються так, як їх читає Marp.

Навколо слайда

• Верхній і нижній колонтитули: директиви header: і footer:, у Markdown.
• Нумерація: paginate: true.
• Нотатки доповідача: HTML-коментар, що не є директивою, — це нотатка. slides notes їх виводить.
• Поетапні списки: список, написаний з * (або 1)), з’являється елемент за елементом, як у Marp.
• <style scoped>: CSS лише для одного слайда.
• Сирий HTML: типово білий список Marp Core; --html дозволяє весь.
• Емодзі: :shortcodes: та емодзі Unicode стають зображеннями Twemoji, як у Marp Core, але вбудованими замість завантаження з CDN: див. Емодзі.

Теми

default, gaia та uncover вбудовані й вибираються через theme:. Власна тема — це файл CSS з коментарем Marp /* @theme name */, який передається через --theme-set або перелічується в themes: у slides.yaml.

Чим go-slides відрізняється

• Шаблони. {{ }} у тілі — це дія шаблону Go (див. Шаблони). Презентація, що показує {{ як текст поза блоком коду, потребує --no-template або тексту, екранованого так, як екранують шаблони Go. Блоки коду й фрагменти коду не чіпаються.
• Kinds. kind: та _kind: — директиви, яких у Marp немає (див. Kinds). slides expand замінює їх директивами, які вони означають, тож розгорнута презентація — звичайний Marp.
• Виводи. HTML, PNG, JPEG, PDF, PPTX та ODP — через бібліотеки Go, а не headless-браузер (відомі обмеження див. у Командний рядок). У v0.4.0, як і в marp-cli, PPTX містить картинки; починаючи з v0.5.0 його слайди — це редаговані текстові блоки та фігури, а --pptx-raster зберігає картинки.
• Заголовки за шириною. # <!-- fit --> Title підтримується: заголовок заповнює ширину слайда в один рядок, на сторінці й у кожному експорті.
• Математика й код. $…$ та $$…$$ дотримуються правил роздільників Marp Core і верстаються go-tex/math; блоки коду підсвічує go-rouge з іменами класів highlight.js (див. Математика й код).