go-slides
slides v0.13.0
slides コマンドとそのライブラリ。Marp の Markdown を Go で解析・レンダリングし、その上に Go テンプレートとスライドの種類を加えます。v0.13.0 としてリリース済み：go install github.com/go-slides/slides/cmd/slides@latest。
slides は Marp と同じ Markdown を読み込みます。ディレクティブ、スライド間の ---、![bg] による背景、スピーカーノート、組み込みテーマ。そのうえで Marp にはない 2 つの機能を加えます。デッキの中で使える Go テンプレートと、見た目を繰り返し書く代わりにスライドの役割を宣言できるスライドの種類です。
--- marp: true paginate: true footer: {{ .talk }} data: talk: Pure Go slides topics: [Why, How, Next] --- <!-- _kind: title --> # {{ .talk }} {{ range .topics }} --- # {{ . }} {{ end }}
構文は Marpit と Marp Core のものであり、独自の方言ではありません。Marp 向けに書いたデッキはここでも同じように読み込まれ、slides expand を使えば素の Marp Markdown に戻せるので、以下の 2 つの追加機能を使っても囲い込まれることはありません。
--- でスライドを区切ります。グローバル、ローカル、スポット（_class）のディレクティブをフロントマターや HTML コメントに書け、Marp と同じくスライドからスライドへ引き継がれます。
![bg] とそのサイズやフィルター、分割背景、そして Marp が解釈する画像キーワード。
ヘッダー、フッター、ページ番号。コメントから作るスピーカーノート。段階表示のリスト。1 枚のスライド専用の CSS を書く <style scoped>。
default、gaia、uncover を、Marp と同じく theme: で選べます。
デッキは text/template として、Markdown の解析より前に評価されます。そのためテンプレートでスライドを生成でき、デッキを「データ＋レイアウト」として書けます。
{{ .title }} でフロントマターを読み、その data: マッピングにデッキが必要とするその他の値を置けます。
--- を出力する {{ range }} はスライドのジェネレーターです。項目ごと、登壇者ごと、リリースごとに 1 枚のスライドを作れます。
{{ page }} と {{ total }} はデッキを分割して初めて決まる値なので、その時点で埋め込まれます。
コードブロックとインラインコードは既定では評価されないので、Go テンプレートを解説するスライドでもそのまま表示できます。include で別ファイルを取り込めます。
kind: section は、ヘッダー、フッター、ページ番号、クラス、背景といったローカルディレクティブのプリセットに名前を付けます。kind: はそのスライドと以降のスライドに、_kind: はそのスライドだけに適用されます。スライドに直接書いたディレクティブが常に優先されます。
title、section、content、blank。いずれも再定義できます。
フロントマターの kinds: に書くか、チームのすべてのデッキが参照する kinds の YAML ファイルにまとめられます。
種類を切り替えると前の種類が設定したものはクリアされるので、クラスやフッターが次のセクションまでついてくることはありません。
プレイグラウンドは、WebAssembly にコンパイルした go-slides そのものです。左側に書くと、右側のスライドが追従します。インストールは不要で、サーバーには何も送信されません。 プレイグラウンドの画面は英語です。
入力に合わせてワーカー内でスライドがレンダリングされ、プレビューはエディターと連動してスクロールし、ミニマップとスライドのサムネイル列も追従します。スライドショーはトランジション付きで再生されます。「Present」を押すと、ノートとタイマー付きの発表者ビューが別ウィンドウで開きます。
ディレクティブ、種類、テンプレート関数の補完と解説。問題は該当行に表示。数式、画像、背景などのサンプルデッキ（画像ファイルはエディターにドロップできます）。ドキュメントへのリンク。ファイルパネルには、テーマ、種類、データファイル、ドロップしたメディアといったプロジェクト一式が、slides コマンドが作るのと同じ構成で並びます。Format タブは、太字、斜体、下線、リスト、グリッドから作る表、スライドの文字揃え、リンクの Markdown を代わりに書いてくれます（元に戻すこともできます）。すべてのペインはサイズを変更できます。
リンクの # にはデッキそのものが圧縮して格納されます。HTML、ベクター PDF、編集可能な PowerPoint や OpenDocument として保存でき、すべてブラウザ内で生成されます。プロジェクト全体を .zip でダウンロードすることもできます。下書きはリロードしても残り、保存先はお使いのブラウザだけです。
marp-cli は画像や PDF をヘッドレス Chrome を操作してレンダリングします。go-slides では、代わりにフリート自身の Go ライブラリがそれを担います。画像と PDF は v0.1.0、PPTX・数式・ハイライトは v0.2.0、ODP・見出しの自動フィット・HCL は v0.3.0、ベクター PDF（テキスト選択可能）と絵文字は v0.4.0 で登場しました。v0.5.0 では PPTX と ODP が編集可能になりました（marp-cli の PPTX は画像です）。v0.6.0 で watch、serve、トランジション、marp-cli のオプション、v0.7.0 で発表者ビューが加わりました。詳しくはドキュメントをご覧ください。
Marp と同じく、デッキごとに 1 ページを出力します。各スライドはウィンドウに合わせて拡大縮小する SVG 枠付きの <section> で、テーマの CSS とキーボード操作のビューアーが付きます。
テンプレートを評価し、種類をスポットディレクティブに変換したデッキを、素の Marp Markdown として書き戻します。そこから先はどの Marp ツールにも渡せます。
slides notes はスピーカーノートを出力し、slides kinds と slides themes はデッキで指定できるものを一覧表示します。
デッキを集めたフォルダー用の設定ファイル。共有の種類、テーマ、テンプレートのデータ、HTML のオプション、言語を指定できます。
--images png|jpeg はスライドごとに 1 枚の画像（deck.001.png, …）を、--image は最初のスライドを書き出します。レンダリングはヘッドレス Chrome ではなく、Go で書かれたブラウザエンジン go-webengine が行います。--image-scale 2 で 2 倍の密度で描画します。
--pdf または -o deck.pdf：スライドのサイズで 1 スライド 1 ページ、スライドと見出しのアウトライン付きで、go-pdfkit が書き出します。フォントは埋め込まれ、ネットワークには一切アクセスしません。v0.4.0 からページはベクターになりました。テキストは選択でき、図形はシャープで、100 スライドで 758 KiB（marp-cli は 837 KiB）です（--pdf-raster で 1 ページ 1 画像のままにできます）。
--pptx または -o deck.pptx：スピーカーノートとデッキのメタデータ付きで、go-ooxml が書き出します。v0.5.0 からスライドは編集可能です。デッキ自身のフォント（埋め込み）によるテキストボックス、図形、グラデーション、一度だけ格納される画像で構成され、画像になる marp-cli とは異なります（--pptx-raster で画像のままにできます）。100 スライドで 348 ms・760 KiB、marp-cli は 7.8 s・7.2 MiB です。
--odp または -o deck.odp：スピーカーノート付きの OpenDocument プレゼンテーション。PPTX と同じく v0.5.0 から編集可能です（--odp-raster で 1 スライド 1 画像）。
# <!-- fit --> Title は、ページでもすべてのエクスポートでも、スライドの幅いっぱいに 1 行で表示されます。
:smile: のショートコードと Unicode 絵文字（😄 👩💻 🇫🇷）は、Marp Core とまったく同じ形の Twemoji 画像になります。ただし CDN から読み込むのではなく go-icons/twemoji から埋め込むので、ネットワーク不要で、ページ、画像、PDF、PPTX、ODP に描画されます。絵文字 →
デッキが YAML を受け付ける場所ならどこでも HCL2 が使えます。---hcl のフロントマター、slides.hcl、種類やデータのファイルで、式や関数を書けます：footer = "${upper(data.company)} · ${page()}/${total()}"。slides expand はフロントマターを YAML として書き戻します。HCL →
--watch は変更された部分を再ビルドし、開いているページを再読み込みします。--server dir はデッキのフォルダーを配信します。deck.md はページとして、deck.md?pdf、?pptx、?png、?notes はリクエスト時に変換され、127.0.0.1 上で Host と Origin を検査し、フォルダーの外には出ません。--preview はブラウザを開きます。marp-cli のルートとライブリロードを、ポートを外部に開かずに実現します。コマンドライン →
slides -I decks/ -o site/ はフォルダー以下のすべてのデッキを変換し、ディレクトリ構成をそのまま再現します。複数のファイル、フォルダー、パターンを一度に指定でき、-P で並列数を指定できます。
marp-cli の <!-- transition: fade 1s --> と 33 種類の組み込みトランジションを、ブラウザの View Transition API で再生します。画面上のコントローラーと --template bare にも対応しています。
--notes はスピーカーノートをテキストで書き出し、--pdf-notes は PDF のページに載せ、--pdf-outlines はしおりを付けます。--title、--author、--keywords、--url、--og-image、--theme に対応し、marp-cli の .marprc と --config-file（JSON、YAML）も読み込みます。
o を押すと、すべてのスライドがグリッドで表示されます。矢印キーで選び、Enter かクリックで移動します。ページ上でも発表者ビュー上でも使え、marp-cli の URL と同期方式に従い、ネットワークは不要です。スライドにはラベルが付きフォーカス可能で、閉じた一覧ビューは inert になります。コマンドライン →
ページで p を押すと、現在のスライド、次のステップ、スピーカーノート（エスケープ済みで、聴衆側のスクリーンリーダーには読まれません）、時計とタイマーが別ウィンドウに表示され、2 つのウィンドウが互いに追従します。marp-cli の URL と同期方式を localStorage で実現し、サーバーもネットワークも不要です。1 ページあたり約 10 KB です。コマンドライン →
```go {lineNumbers} はコードブロックに行番号を付けます（{lineNumbers=10} で 10 から開始）。行末のコメントにマーカー（// <1>）を書き、番号付きリストを続けると、その行と対応する注釈に番号付きの丸印が付きます。ページ、画像、PDF、PPTX、ODP で有効で、番号や丸印はコードと一緒にコピーされません。数式とコード →
slides コマンドとそのライブラリ。Marp の Markdown を Go で解析・レンダリングし、その上に Go テンプレートとスライドの種類を加えます。v0.13.0 としてリリース済み：go install github.com/go-slides/slides/cmd/slides@latest。
v0.13.0 を解説するドキュメント（Hugo + Hextra）。入門、Marp との互換性、テンプレート、種類、コマンドラインを扱います。ソース →
Marp for VS Code が Marp にとってそうであるように、go-slides のための VS Code 拡張機能です。WebAssembly にコンパイルした go-slides が VS Code の Markdown プレビューでデッキを表示し（バイナリ不要、vscode.dev でも動作）、テンプレートを経由してもエディターと同期スクロールし、エラーは「問題」パネルに表示され、ディレクティブ・種類・テンプレート関数を補完し、エディターの横に一覧ビューと発表者ビューを開き、slides でエクスポートします。GitHub のリリースに添付された .vsix をインストールしてください。Marketplace と Open VSX での公開は準備中で、まだ公開されていません。VS Code →
ロゴマーク（ドキュメントファミリーのインディゴで描いた、スタンドに載ったスライド）と、その各種フォーマット：SVG、PNG、JPG、ICO、ICNS、アバター、ソーシャル画像。
go-richdoc、go-ooxml、go-tex、go-docutils とともに、文書の読み込み・組版・書き出しを Go で行います。C は一切使いません。
GitHub の組織ページへ →