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
1.8k
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.2k
sphinxからAnsible Playbookを読み込む
shirou
3
540
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.4k
code generation from C in gopsutil
shirou
1
5.9k
Other Decks in Technology
See All in Technology
Cracking the KubeCon CfP
inductor
2
270
KubeConにproposalを送りたい人へのアドバイス
sat
PRO
3
270
Building Dashboards as a Hobby
egmc
0
350
いつか使うかも貯金してたらめちゃめちゃ機能が増えてた話
riyaamemiya
0
580
Python と Snowflake はズッ友だょ!~ Snowflake の Python 関連機能をふりかえる ~
__allllllllez__
2
140
FrontDoorとWebAppsを組み合わせた際のリダイレクト処理の注意点
kenichirokimura
1
700
Building a RAG-poweredAI chat appwith Python and VS Code
pamelafox
0
140
EMとして2023年度に頑張ったこと / What we did well in FY2023 as a EM
pauli
1
200
BPStudyの200回を中心にIT業界を振り返る。そしてこれから
haru860
3
390
EM完全に理解した と思ったけど、 やっぱり何も分からなかった話 / EM Night Fukuoka #1
hirutas
0
260
家族アルバム みてねにおけるGrafana活用術 / Grafana Meetup Japan Vol.1 LT
isaoshimizu
1
900
Azureの基本的な権限管理の勉強会
yhana
1
2k
Featured
See All Featured
ParisWeb 2013: Learning to Love: Crash Course in Emotional UX Design
dotmariusz
104
6.6k
What’s in a name? Adding method to the madness
productmarketing
PRO
17
2.7k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
22
1.6k
Why Our Code Smells
bkeepers
PRO
331
56k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
155
14k
BBQ
matthewcrist
80
8.8k
Visualization
eitanlees
137
14k
Faster Mobile Websites
deanohume
300
30k
The Straight Up "How To Draw Better" Workshop
denniskardys
228
130k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
13
8.3k
Making Projects Easy
brettharned
109
5.5k
Facilitating Awesome Meetings
lara
43
5.6k
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