refs #13 add directive sample code

takanory · takanory · commit 9d44ea75adf5 · 2025-03-19T00:03:41.000+09:00
diff --git a/docs/index.md b/docs/index.md
@@ -36,14 +36,15 @@ extensions = [
 ]
 ```
 
-### 3. Use `nekochan` role {nekochan}`clap-nya`
+### 3. Use `nekochan` role or directive {nekochan}`clap-nya`
 
-When you use the `nekochan` roll, you will see any Nekochan emoji.
+When you use the `nekochan` roll or directive, you will see any Nekochan emoji.
 
 ````{tab-set-code}
 ```{literalinclude} ./snippets/simple.md
 :language: markdown
 ```
+
 ```{literalinclude} ./snippets/simple.rst
 :language: rst
 ```
@@ -55,14 +56,14 @@ When you use the `nekochan` roll, you will see any Nekochan emoji.
 ```{include} ./snippets/simple.md
 ```
 
-
 ### 4. Customize emoji height and alt text {nekochan}`memo-nya`
 
 You can specify height and alt text with a semicolon(`;`) after the name of the `nekochan` role.
 
 ````{tab-set-code}
 ```{literalinclude} ./snippets/with-height-alt.md
 :language: markdown
+
 ```
 ```{literalinclude} ./snippets/with-height-alt.rst
 :language: rst
diff --git a/docs/snippets/simple.md b/docs/snippets/simple.md
@@ -2,3 +2,6 @@ Welcome to Nekochan emoji {nekochan}`banzai` world!!
 
 * Enjoy Nekochan emoji {nekochan}`ok`
 * I love {nekochan}`beer`
+
+```{nekochan} melty
+```
diff --git a/docs/snippets/simple.rst b/docs/snippets/simple.rst
@@ -1,4 +1,6 @@
-Welcome to Nekochan emoji {nekochan}`banzai` world!!
+Welcome to Nekochan emoji :nekochan:`banzai` world!!
 
-* Enjoy Nekochan emoji {nekochan}`ok`
-* I love {nekochan}`beer`
+* Enjoy Nekochan emoji :nekochan:`ok`
+* I love :nekochan:`beer`
+
+.. nekochan:: melty
diff --git a/docs/snippets/with-height-alt.md b/docs/snippets/with-height-alt.md
@@ -1,3 +1,8 @@
 * Big bear nekochan {nekochan}`kuma-nya;2em`
 * Huge hot-sprint nekochan {nekochan}`hot-spring;128px`
 * Customize alt text for emoji {nekochan}`gohan-taberu;3em;Nekochan eating rice ball`
+
+```{nekochan} lgtm
+:alt: Looks Good To Me
+:height: 3em
+```
diff --git a/docs/snippets/with-height-alt.rst b/docs/snippets/with-height-alt.rst
@@ -1,3 +1,7 @@
 * Big bear nekochan :nekochan:`kuma-nya;2em`
 * Huge hot-sprint nekochan :nekochan:`hot-spring;128px`
 * Customize alt text for emoji :nekochan:`gohan-taberu;3em;Nekochan eating rice ball`
+
+.. nekochan:: lgtm
+   :alt: Looks Good To Me
+   :height: 3em
diff --git a/docs/snippets/with-transform.md b/docs/snippets/with-transform.md
@@ -1,2 +1,7 @@
 * Skip {nekochan}`skip-nya;2em` rotated 90 degrees clockwise {nekochan}`skip-nya;2em;;rotate-90`
 * Flip the left and right side of the {nekochan}`yoshi;2em` Yoshi emoji {nekochan}`yoshi;2em;;flip-horizontal`
+
+```{nekochan} snake
+:transform: flip-vertical
+:height: 2em
+```
diff --git a/docs/snippets/with-transform.rst b/docs/snippets/with-transform.rst
@@ -1,2 +1,6 @@
 * Skip :nekochan:`skip-nya;2em` rotated 90 degrees clockwise :nekochan:`skip-nya;2em;;rotate-90`
 * Flip the left and right side of the :nekochan:`yoshi;2em` Yoshi emoji :nekochan:`yoshi;2em;;flip-horizontal`
+
+.. nekochan:: snake
+   :transform: flip-vertical
+   :height: 2em
