Put 🐱 Cat Emojis
in your Documents!

在你的文档里加入🐱猫咪表情吧！

Takanori Suzuki

PyCon China 2025 / 2025 Sep 20

Do you like cats? 🐱

你喜欢猫吗？🐱

IMO, Many programmers like Cats
🧑‍💻 👩‍💻 ❤️ 🐱

在我看来，许多程序员喜欢猫

For example

[1]

I like cats too 🐈

But I like Ferrets even more! 😍

About Cat Emojis 🐱

关于猫咪表情符号

Cat Emojis for Slack & Discord 💬

• Cat Emojis are Created and Distributed by Shikamatsu-san(@shi_ka_ma_tsu)

Cat Emojis for Slack & Discord 💬

• I use it every day in company / community Slack

Cat Emojis for Slack & Discord 💬

• You can download Cat Emojis!!

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

Cat Emojis in Documents 🐱 📄

文档中的猫咪表情符号

Motivation 💪

• Use Cat Emojis on My Slides

• Can do it by Copy & Paste Emoji image

Programmer is Lazy 🫠

Copy & Paste lots of Emojis is Boring

We have Python

Simplify the Boring Stuff with Python

sphinx-nekochan 🔧

(“Nekochan” is Cat in Japanese)

(“Nekochan” 是日语中的 “猫”)

sphinx-nekochan 🔧

• Sphinx extension for adding Cat emoji to docs

• sphinx-nekochan.readthedocs.io

Sphinx 👁️‍🗨️

• www.sphinx-doc.org

• Easy to create intelligent and beautiful docs

• docs.python.org using Sphinx

Get Started 🏃

# sphinx is also install
(env) % pip install sphinx-nekochan
# generates Sphinx base files
(env) % sphinx-quickstart

• add sphinx_nekochan extension in conf.py

extensions = [
    ...
    "sphinx_nekochan",
]

Get Started 🏃

• Use nekochan role in the document

I love {nekochan}`beer`

I love :nekochan:`beer`

• Build html documents

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

Get Started 🏃

• Cat Emoji displayed in the document!! 🎉

Find the Name of Cat Emoji 🔎

• List of Nekochan emoji

• List of Nekochan emoji without text

sphinx-nekochan on slides 💻

sphinx-nekochan 在幻灯片上

sphinx-revealjs

• sphinx-revealjs.readthedocs.io

• Sphinx extension to generate Reveal.js slides

sphinx-revealjs with sphinx-nekochan

• Same code will display Cat Emoji in slides

* I love {nekochan}`beer
* I want to see {nekochan}`panda`

* I love :nekochan:`beer`
* I want to see :nekochan:`panda`

• I love

• I want to see

Customize emoji

自定义表情符号

Customize emoji Height [3]

* Big bear {nekochan}`bear;1.5em` default {nekochan}`bear`
* Huge hot-sprint nekochan {nekochan}`hot-spring;100px`

* Big bear :nekochan:`bear;1.5em` default :nekochan:`bear`
* Huge hot-sprint nekochan :nekochan:`hot-spring;100px`

• Big bear default

• Huge hot-sprint nekochan

Transform emoji [4]

* {nekochan}`skip` rotate {nekochan}`skip;;;rotate-90`
* {nekochan}`yoshi` flip horizontal
{nekochan}`yoshi;;;flip-horizontal`

* :nekochan:`skip` rotate :nekochan:`skip;;;rotate-90`
* :nekochan:`yoshi` flip horizontal
:nekochan:`yoshi;;;flip-horizontal`

• rotate

• flip horizontal

Enjoy sphinx-nekochan

• sphinx-nekochan.readthedocs.io

• takanory/sphinx-nekochan

  • Please GitHub star if you like it!

• pypi.org/project/sphinx-nekochan

Thank you / 谢谢

slides.takanory.net

sphinx-nekochan.readthedocs.io

takanory takanory takanory takanory