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
570
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
How CERN serves 1EB of data via FUSE
ennael
PRO
0
15k
XPを始める新人に伝えたい近道の鍵
nakasho
1
190
Amazon BedrockとPR-Agentでコードレビュー自動化に挑戦・実際に運用してみた
diggymo
0
540
FastAPIでのasync defとdefの使い分け
takashi1029
6
1.7k
Oracle Cloud Infrastructure:2024年9月度サービス・アップデート
oracle4engineer
PRO
0
240
【shownet.conf_】多様化するネットワーク環境を柔軟に統合するルーティングテクノロジー
shownet
PRO
0
250
PREEMPT_RT over the years
ennael
PRO
0
250
Strong Skipping Mode によってrecompositionはどう変わったのか
mikanichinose
0
110
REST API Design Pitfalls
victorrentea
1
500
【shownet.conf_】ネットワークテストの最適化と利便性の追求
shownet
PRO
0
220
【shownet.conf_】ShowNet x 宇宙ネットワーク
shownet
PRO
0
270
スモールスタート、不都合な真実 〜 耳当たりの良い言葉に現場が振り回されないために/20240930-ssmjp-small-start
opelab
12
1.6k
Featured
See All Featured
The Illustrated Children's Guide to Kubernetes
chrisshort
47
48k
Designing for humans not robots
tammielis
248
25k
jQuery: Nuts, Bolts and Bling
dougneiner
61
7.4k
Rails Girls Zürich Keynote
gr2m
93
13k
Become a Pro
speakerdeck
PRO
23
4.9k
The Invisible Side of Design
smashingmag
296
50k
From Idea to $5000 a Month in 5 Months
shpigford
380
46k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
23
1.7k
The Pragmatic Product Professional
lauravandoore
31
6.2k
We Have a Design System, Now What?
morganepeng
48
7.1k
The Psychology of Web Performance [Beyond Tellerrand 2023]
tammyeverts
36
2.1k
Fireside Chat
paigeccino
31
2.9k
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