From 8f764806d980ca964330d3151c93fd7229e21e17 Mon Sep 17 00:00:00 2001 From: 安竹洋平 <61961825+yasutakeyohei@users.noreply.github.com> Date: Wed, 31 Jan 2024 00:42:45 +0900 Subject: build --- build/blog/2024/01/27/docusaurus-admonition-heading-toc/index.html | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'build/blog/2024/01/27/docusaurus-admonition-heading-toc') diff --git a/build/blog/2024/01/27/docusaurus-admonition-heading-toc/index.html b/build/blog/2024/01/27/docusaurus-admonition-heading-toc/index.html index 15057122..a39ef305 100644 --- a/build/blog/2024/01/27/docusaurus-admonition-heading-toc/index.html +++ b/build/blog/2024/01/27/docusaurus-admonition-heading-toc/index.html @@ -8,9 +8,9 @@ - - - + + +
メインコンテンツまでスキップ

Docusaurusの注意書きや警告文のタイトルを見出しにして、目次にも乗せる方法

· 約17分
安竹 洋平

Docusaurus🦖

@@ -64,6 +64,7 @@
markdownからHTMLへ変換処理の流れ
| ........................ process ........................... |
| .......... parse ... | ... run ... | ... stringify ..........|

+--------+ +----------+
Input ->- | Parser | ->- Syntax Tree ->- | Compiler | ->- Output
+--------+ | +----------+
X
|
+--------------+
| Transformers |
+--------------+

上図(Unified Overviewより)にTransformersとあるところがRemark/Rehypeの動作するところ。

Remarkはmarkdown形式で、RehypeはHTML形式でASTを扱います。どちらも同じようにASTを操作できますが、データ構造が違うため、目的に応じて選択することになるのかなと思います。

+

こちらのサイトなどが詳しいです。

Docusaurusにおけるプラグインの実行タイミング

Docusaurusでこれらのプラグインを利用するためにはdocusaurus.config.jsonに設定が必要です。このページによると次の4種類の設定値にてプラグインを登録できます。

デフォルトプラグイン適用前デフォルトプラグイン適用後
Remark
Markdown形式
beforeDefaultRemarkPluginsremarkPlugins
Rehype
HTML形式
beforeDefaultRehypePluginsrehypePlugins
-- cgit v1.2.3-54-g00ecf