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
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.3k
sphinxからAnsible Playbookを読み込む
shirou
3
580
ansible x sphinx for ssmjp-2016-07-29 but-not-used
shirou
0
140
Sphinx with Markdown
shirou
2
23k
Ansible 2.0 at Ansible Meetup in Tokyo 2015.09
shirou
10
8.5k
code generation from C in gopsutil
shirou
1
6k
Other Decks in Technology
See All in Technology
rootlessコンテナのすゝめ - 研究室サーバーでもできる安全なコンテナ管理
kitsuya0828
3
380
IBC 2024 動画技術関連レポート / IBC 2024 Report
cyberagentdevelopers
PRO
0
110
B2B SaaSから見た最近のC#/.NETの進化
sansantech
PRO
0
720
Amazon Personalizeのレコメンドシステム構築、実際何するの?〜大体10分で具体的なイメージをつかむ〜
kniino
1
100
なぜ今 AI Agent なのか _近藤憲児
kenjikondobai
4
1.3k
AIチャットボット開発への生成AI活用
ryomrt
0
170
Can We Measure Developer Productivity?
ewolff
1
150
SREによる隣接領域への越境とその先の信頼性
shonansurvivors
2
510
AWS Lambdaと歩んだ“サーバーレス”と今後 #lambda_10years
yoshidashingo
1
170
[FOSS4G 2024 Japan LT] LLMを使ってGISデータ解析を自動化したい!
nssv
1
210
100 名超が参加した日経グループ横断の競技型 AWS 学習イベント「Nikkei Group AWS GameDay」の紹介/mediajaws202411
nikkei_engineer_recruiting
1
170
スクラムチームを立ち上げる〜チーム開発で得られたもの・得られなかったもの〜
ohnoeight
2
350
Featured
See All Featured
StorybookのUI Testing Handbookを読んだ
zakiyama
27
5.3k
Visualization
eitanlees
145
15k
Documentation Writing (for coders)
carmenintech
65
4.4k
The Pragmatic Product Professional
lauravandoore
31
6.3k
Fireside Chat
paigeccino
34
3k
ReactJS: Keep Simple. Everything can be a component!
pedronauck
665
120k
Scaling GitHub
holman
458
140k
What’s in a name? Adding method to the madness
productmarketing
PRO
22
3.1k
Happy Clients
brianwarren
98
6.7k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
4
370
5 minutes of I Can Smell Your CMS
philhawksworth
202
19k
Fashionably flexible responsive web design (full day workshop)
malarkey
405
65k
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