絵文字

絵文字はショートコードでも、文字そのものでも書けます。

# Launch :rocket: 🎉

Shortcodes :smile: :+1: :heart_eyes: and Unicode 😄 👍🏽 👩‍💻 🇫🇷 1️⃣.

いずれも Marp Core が描画するのと同じ Twemoji の画像になり、 Marp Core と同じマークアップで出力されます。

<img class="emoji" draggable="false" alt="😄" src="data:image/svg+xml;base64,…" data-marp-twemoji=""/>

ネットワーク不要

Marp Core の src は CDN 上の URL なので、オフラインで表示したり、印刷したり、 ネットワークに接続していないマシンで PDF に変換したりすると、画像が壊れて表示されます。 go-slides は SVG そのものを data: URI に埋め込みます。画像データ（Twemoji 17.0.3、Emoji 17.0 の 4,009 個）は、 純粋な Go のモジュール go-icons/twemoji からプログラムに組み込まれています。 圧縮時のサイズは 2 MB で、スライドデッキに絵文字が含まれる場合にだけ読み込まれます。

画像は HTML ページでも、--images/--image、--pdf、 --pptx、--odp でも同じように描画されます。SVG のラスタライズは go-webengine が行います。4,009 個の 画像はすべて、その SVG ラスタライザーで解析・描画でき、テストでそれを確認しています。 v0.5.0 以降、このラスタライザーは go-gfx/oksvg v0.2.0 です。clipPath、fill-rule: evenodd、円弧コマンドが Chrome と同じように描画されるようになり、 その結果 Twemoji の 1 個とそのほか 211 個の描画が変わり、SVG のロゴも崩れなくなりました。

絵文字をテキストに合わせたサイズにするルール（img[data-marp-twemoji]、1 em 四方、 ベースラインに揃える）は、Marp Core と同様にテーマへ追加されます。 そのため、独自のテーマにも適用されます。

変換されるもの

ルールは Marp Core と同じです。あらゆるケースを含むスライドデッキについて、 Marp Core 4.4.0 が出力する HTML と比較するテストがあります。

見出しの id とアウトラインでは、ショートコードの名前ではなく絵文字が使われます。 # Launch :rocket: の id は、Marp と同じく launch-%F0%9F%9A%80 になります。

go-slides が Marp Core と異なる点では、go-slides のほうが多くを変換します。✌️ ☝️ ✍️ 🏋️ など、 Marp Core の emoji-regex がテキストのまま残す、デフォルト表示がテキストの文字をいくつか変換するほか、 Twemoji は描画できるものの Unicode には登録されていない少数のシーケンスも変換します。

無効にする

--no-emoji（コードでは slides.Config{NoEmoji: true}）を指定すると、ショートコードと Unicode の絵文字は書いたとおりのテキストのまま残ります。これは Marp Core の emoji: false に相当します。

クレジット表記

画像は Twemoji（Copyright 2020 Twitter, Inc and other contributors）で、 CC-BY 4.0 の下でライセンスされており、 jdecked/twemoji プロジェクトによって引き継がれています。 これらを表示するスライドデッキでは、フッターや最後のスライドなどでクレジットを記載してください。 ショートコードの対応表は markdown-it-emoji のもの（MIT）です。