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.3k
sphinxからAnsible Playbookを読み込む
shirou
3
620
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.6k
code generation from C in gopsutil
shirou
1
6.1k
Other Decks in Technology
See All in Technology
初参加のハノーバーメッセで感じた世界最大級イベントの熱気とAI活用の未来
hamadakoji
0
110
Kent Beckの思想と学びの道筋 / 20250517 Ryutaro Yoshiba & Hiromitsu Akiba
shift_evolve
1
200
技術選定の仕方 - FLEXYウェビナー / How to select technology
shinden
1
130
SONiCで構築・運用する生成AI向けパブリッククラウドネットワーク
sonic
1
550
株式会社Awarefy(アウェアファイ)会社説明資料 / Awarefy-Company-Deck
awarefy
3
17k
4月15日の AZ 障害をテクサポの中の人目線で振り返ってみる
kazzpapa3
3
190
水耕栽培に全部賭けろ
mutsumix
0
170
激動の一年を通じて見えてきた「技術でリードする」ということ
ktr_0731
8
8.6k
newmo の創業を支える Software Architecture と Platform Engineering
110y
5
780
4社統合におけるマスタデータ管理に立ち向かう / Towards master data management in the four-company integration
carta_engineering
0
350
生成AI時代における人間の情熱とプロダクト志向 / 20250517 Takuya Oikawa
shift_evolve
2
380
Azure の裏側を支える SRE の世界
tsubasaxzzz
2
360
Featured
See All Featured
Art, The Web, and Tiny UX
lynnandtonic
298
21k
Building Applications with DynamoDB
mza
94
6.4k
Adopting Sorbet at Scale
ufuk
76
9.4k
Done Done
chrislema
184
16k
Build The Right Thing And Hit Your Dates
maggiecrowley
35
2.7k
10 Git Anti Patterns You Should be Aware of
lemiorhan
PRO
656
60k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
137
33k
Designing for humans not robots
tammielis
253
25k
Intergalactic Javascript Robots from Outer Space
tanoku
271
27k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
233
17k
Product Roadmaps are Hard
iamctodd
PRO
53
11k
Bash Introduction
62gerente
613
210k
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