SVG 処理

guidebook は book.json で制御される 2 つの SVG 処理モードを提供します。

インライン SVG の外部化

HTML 内のインライン <svg> 要素を個別の .svg ファイルに抽出:

{
    "externalize_svg": true
}

インライン SVG は抽出されたファイルを指す <img> タグに置換されます。アイコン SVG(fill="currentColor" を持つもの)は動的な色の動作を保持するためインラインのまま維持されます。

SVG ファイルのインライン化

外部 SVG ファイルを HTML に直接埋め込み:

{
    "inline_svg": true
}

外部の <img src="*.svg"> 参照が SVG コンテンツのインラインに置換されます。アイコン SVG は <img> タグのまま維持されます。

使い分け

オプションユースケース
externalize_svgHTML サイズを削減、SVG のブラウザキャッシュを有効化
inline_svg追加の HTTP リクエストを排除、SVG の CSS スタイリングを有効化