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.9k
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
560
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
5.9k
Other Decks in Technology
See All in Technology
Luupの開発組織におけるインシデントマネジメントの変遷 ver.RoadtoSRENEXT2024
grimoh
1
270
CTOから見た事業開発とプロダクト開発 / My Perspective on Business and Product Development as CTO
keisuke69
4
960
ギークの理想が7つ集まるエムスリーで夢を叶えよう - エムスリー株式会社
m3_engineering
1
260
What if...? 처음부터 다시 LLM 어플리케이션을 개발한다면
huffon
0
1k
LLMアプリケーションの評価の実践と課題 ~PharmaXにおける今後の展望~
pharma_x_tech
2
170
フルリモートワークはエンジニアの夢を叶えたか? #cm_odyssey
mamohacy
2
600
dxd2024-生成AIに振り回された3か月間の成功と失敗/dxd2024-link-and-motivation
lmi
2
260
エンジニアリングマネージャーはどう学んでいくのか #devsumi / How Do Engineering Managers Continue to Learn and Grow?
expajp
4
1.3k
Amazon FSx for NetApp ONTAPのパフォーマンスチューニング要素をまとめてみた #cm_odyssey #devio2024
non97
0
220
Datadog Cloud SIEMを使ってAWS環境の脅威を可視化した話/lifeistech-datadog-cloud-siem
gidajun
0
480
データ分析を支える技術 生成AI再入門
ishikawa_satoru
0
380
VPoEの視点から見た、ヘンリーがサーバーサイドKotlinを使う理由 / Why Server-side Kotlin 2024
cho0o0
1
420
Featured
See All Featured
No one is an island. Learnings from fostering a developers community.
thoeni
17
2.8k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
17
1.5k
The Illustrated Children's Guide to Kubernetes
chrisshort
39
47k
We Have a Design System, Now What?
morganepeng
46
7k
BBQ
matthewcrist
82
9k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
34
1.9k
A better future with KSS
kneath
231
17k
Product Roadmaps are Hard
iamctodd
PRO
48
10k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
26
2.1k
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
13
430
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
129
32k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
245
1.2M
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