Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Sphinx-themes.org in Sphinx-con 2018
Search
shirou
November 28, 2018
Technology
0
2.2k
Sphinx-themes.org in Sphinx-con 2018
This is a LT slide of "Sphinx-themes.org" which is held in sphinx-con 2018.
shirou
November 28, 2018
Tweet
Share
More Decks by shirou
See All by shirou
Generate better JavaScript From Goa Design
shirou
0
1.4k
sphinxからAnsible Playbookを読み込む
shirou
3
660
ansible x sphinx for ssmjp-2016-07-29 but-not-used
shirou
0
150
Sphinx with Markdown
shirou
2
24k
Ansible 2.0 at Ansible Meetup in Tokyo 2015.09
shirou
10
8.7k
code generation from C in gopsutil
shirou
1
6.2k
Other Decks in Technology
See All in Technology
まずはマネコンでちゃちゃっと作ってから、それをCDKにしてみよか。
yamada_r
2
120
Oracle Cloud Infrastructure IaaS 新機能アップデート 2025/06 - 2025/08
oracle4engineer
PRO
0
110
バイブスに「型」を!Kent Beckに学ぶ、AI時代のテスト駆動開発
amixedcolor
3
590
はじめてのOSS開発からみえたGo言語の強み
shibukazu
4
1k
20250910_障害注入から効率的復旧へ_カオスエンジニアリング_生成AIで考えるAWS障害対応.pdf
sh_fk2
3
280
slog.Handlerのよくある実装ミス
sakiengineer
4
480
dbt開発 with Claude Codeのためのガードレール設計
10xinc
2
1.3k
20250913_JAWS_sysad_kobe
takuyay0ne
2
250
Platform開発が先行する Platform Engineeringの違和感
kintotechdev
4
590
20250912_RPALT_データを集める→とっ散らかる問題_Obsidian紹介
ratsbane666
0
100
Django's GeneratedField by example - DjangoCon US 2025
pauloxnet
0
160
S3アクセス制御の設計ポイント
tommy0124
3
210
Featured
See All Featured
Fantastic passwords and where to find them - at NoRuKo
philnash
52
3.4k
Documentation Writing (for coders)
carmenintech
74
5k
Building an army of robots
kneath
306
46k
Reflections from 52 weeks, 52 projects
jeffersonlam
352
21k
Designing for Performance
lara
610
69k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
229
22k
Principles of Awesome APIs and How to Build Them.
keavy
126
17k
YesSQL, Process and Tooling at Scale
rocio
173
14k
The Straight Up "How To Draw Better" Workshop
denniskardys
236
140k
Context Engineering - Making Every Token Count
addyosmani
3
63
The Cost Of JavaScript in 2023
addyosmani
53
8.9k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
23
1.4k
Transcript
sphinx-themes.org わかやま しろう
お前だれよ わかやま しろう 「sphinxをはじめよう」の著者の一人 https://github.com/shirou https://twitter.com/r_rudi AlpacaJapanという金融と機械学習の会社で働いています
テーマ Sphinxの魅力の一つは豊富なテーマです。 標準以外に多種多様なテーマが公開されており、簡単に使えます。 % pip install sphinxjp.themes.gopher あとは conf.py の
html_theme を編集するだけ html_theme = 'gopher'
問題点 あまりにも多くのテーマが公開されている。 説明がないものも多数。 古くてインストールに苦労するものも。
https://sphinx-themes.org (https://sphinx-themes.org) というのを作りました。 pypi上にあがっているテーマを一覧表示 chromium-headlessでスクリーンショットを取得 サンプルページを見れる conf.pyのサンプルも見れる 現在109ぐらいのテーマを一覧できるようにしてあります
どうやって作ってるの? 表示 preactを使って軽量に表示 jsonファイルとしてデータがあるので読み込んで表示 sakuraのサーバーでホスト サンプル作成 pip search sphinx でテーマっぽいものを調べる
ひたすら手動でpypiインストール。 sphinx用のdockerコンテナを用意し、コマンドも用意してあるので、一個にかかる時間は1 分ぐらい インストールに手間取るものだと時間がかかる ということで、更新は「手動」です。現状半年に一回ぐらい、気が向いた時にやるだけです。
苦労したところ 一つの拡張に複数のテーマが含まれていることがたまにある。 古いテーマはconf.pyの書き方が統一されてないのでインストールできないことがある そういうのは諦めています 思いついてドメインを取ってから5年たってました。誰も作ってくれなかったねん… 時間:2012-12-12 23:45 ドメイン名:sphinx-themes.org
None