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.6k
code generation from C in gopsutil
shirou
1
6k
Other Decks in Technology
See All in Technology
権威ドキュメントで振り返る2024 #年忘れセキュリティ2024
hirotomotaguchi
2
730
統計データで2024年の クラウド・インフラ動向を眺める
ysknsid25
2
840
どちらを使う?GitHub or Azure DevOps Ver. 24H2
kkamegawa
0
670
レンジャーシステムズ | 会社紹介(採用ピッチ)
rssytems
0
150
あの日俺達が夢見たサーバレスアーキテクチャ/the-serverless-architecture-we-dreamed-of
tomoki10
0
420
MLOps の現場から
asei
6
630
2024年にチャレンジしたことを振り返るぞ
mitchan
0
130
kargoの魅力について伝える
magisystem0408
0
200
[Ruby] Develop a Morse Code Learning Gem & Beep from Strings
oguressive
1
150
サイバー攻撃を想定したセキュリティガイドライン 策定とASM及びCNAPPの活用方法
syoshie
3
1.2k
Snykで始めるセキュリティ担当者とSREと開発者が楽になる脆弱性対応 / Getting started with Snyk Vulnerability Response
yamaguchitk333
2
180
NilAway による静的解析で「10 億ドル」を節約する #kyotogo / Kyoto Go 56th
ytaka23
3
370
Featured
See All Featured
Building Adaptive Systems
keathley
38
2.3k
Large-scale JavaScript Application Architecture
addyosmani
510
110k
Performance Is Good for Brains [We Love Speed 2024]
tammyeverts
6
510
Adopting Sorbet at Scale
ufuk
73
9.1k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
356
29k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
111
49k
Imperfection Machines: The Place of Print at Facebook
scottboms
266
13k
The Myth of the Modular Monolith - Day 2 Keynote - Rails World 2024
eileencodes
17
2.3k
[RailsConf 2023] Rails as a piece of cake
palkan
53
5k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
44
9.3k
Agile that works and the tools we love
rasmusluckow
328
21k
It's Worth the Effort
3n
183
28k
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