🐱絵文字をドキュメントに入れよう！

Takanori Suzuki

PyCon mini 東海 2025 / 2025 Nov 8

Who am I? / お前 誰よ 👤

• Takanori Suzuki / 鈴木 たかのり ( @takanory)

• BeProud 取締役 / Python Climber

• PyCon JP Association 代表理事

• Python Boot Camp 講師、Python mini Hack-a-thon 主催、Pythonボルダリング部 部長

PyCon JP 2026共同座長 [1] 🪑🪑

• 日程：2026年8月21日（金）〜23日（日）

• 会場： 広島国際会議場

• 共同座長：佐野浩士、鈴木たかのり

主催メンバー募集中！！ 🙌

• イベントの方向性やチーム運営の方法を
  一緒に考えてくれる方をまず募集

• PyCon JP 2026主催メンバー申込フォーム [2]

ネコは好きですか？ 🐱

Do you like Cats 🐱?

プログラマーの多くはネコ好き
（個人の意見です）🧑‍💻 👩‍💻 ❤️ 🐱

IMO, Many programmers like Cats

例 / For example

[3]

私も猫が好き 🐈

I like cats too

フェレットがもっと好き！ 😍

But I like Ferrets even more!

ネコチャン絵文字について 🐱

About Cat Emojis

SlackとDiscord用ネコチャン絵文字 🐈‍⬛

Cat Emojis for Slack & Discord

• しかまつさん(@shi_ka_ma_tsu)が作成、配布

SlackとDiscord用ネコチャン絵文字 🐈‍⬛

• 会社やコミュニティのSlackで毎日使っている

• I use it every day in company / community Slack

SlackとDiscord用ネコチャン絵文字 🐈‍⬛

• ネコチャン絵文字をダウンロードできます！

• note.com/shikamatsu/n/nd217dc0617db [4]

ドキュメントに
ネコチャン絵文字 🐱 📄

Cat Emojis in Documents

モチベーション / Motivation

• スライドでネコチャン絵文字を使用

• 絵文字画像をCopy & Pasteすれば可能

プログラマーは怠惰 / Programmer is Lazy

絵文字をたくさんCopy & Pasteするのは退屈

Copy & Paste lots of Emojis is Boring

私たちにはPythonがある / We have Python

退屈なことはPythonで簡単にしよう

Simplify the Boring Stuff with Python

sphinx-nekochan

sphinx-nekochan

• ドキュメントにネコチャン絵文字を追加するSphinx拡張

• Sphinx extension for adding Cat emoji to docs

• sphinx-nekochan.readthedocs.io

Sphinx 👁️‍🗨️

• www.sphinx-doc.org

• きれいなドキュメントが簡単に作成できる

• docs.python.orgはSphinxを使っている

やってみよう

(env) % pip install sphinx-nekochan  # sphinxもインストールされる
(env) % sphinx-quickstart  # ベースファイルを生成

• conf.pyに拡張を追加

extensions = [
    ...
    "sphinx_nekochan",
]

やってみよう

• ドキュメントで nekochan ロールを使用

I love {nekochan}`beer`

I love :nekochan:`beer`

• HTMLドキュメントをビルド

(env) % make html
(env) % open build/html/index.html

やってみよう

• ネコチャン絵文字が表示された！！ 🎉

• Cat Emoji displayed in the document!! 🎉

ネコチャン絵文字の名前を探す 🔎

• List of Nekochan emoji

• List of Nekochan emoji without text

スライドでsphinx-nekochan 💻

sphinx-nekochan on slides

sphinx-revealjs

• sphinx-revealjs.readthedocs.io

• Reveal.jsスライドを生成するSphinx拡張

sphinx-revealjsとsphinx-nekochan

• 同じコードでネコチャン絵文字が表示

• Same code will display Cat Emoji

I love {nekochan}`beer`

I love :nekochan:`beer`

I love

絵文字をカスタマイズ

Customize emoji

絵文字の高さを変更 [5]

* 大きいクマー{nekochan}`bear;1.5em` 普通{nekochan}`bear`
* 巨大ダパーネコチャン{nekochan}`dapaa;128px`

* 大きいクマー:nekochan:`bear;1.5em` 普通:nekochan:`bear`
* 巨大ダパーネコチャン:nekochan:`dapaa;128px`

• 大きいクマー 普通

• 巨大ダパーネコチャン

絵文字を回転 [6]

* {nekochan}`skip` 90度回転 {nekochan}`skip;;;rotate-90`
* {nekochan}`yoshi` 左右反転 {nekochan}`yoshi;;;flip-horizontal`

* :nekochan:`skip` 90度回転 :nekochan:`skip;;;rotate-90`
* :nekochan:`yoshi` 左右反転 :nekochan:`yoshi;;;flip-horizontal`

• 90度回転

• 左右反転

Enjoy sphinx-nekochan

• sphinx-nekochan.readthedocs.io

• takanory/sphinx-nekochan

  • 気に入ったらGitHub starしてね！

• pypi.org/project/sphinx-nekochan

• Version 0.4.0リリースしました！！[7]

Thank you

slides.takanory.net

sphinx-nekochan.readthedocs.io

takanory takanory takanory takanory