本サイトについて#
TIL (Today I Learned) は「今日学んだこと」という名前の通り、学んだことを書きためていくもので、GitHub 上で広がっているという。
Note
2021/7/1 時点で「Today I Learned」で GitHub 上を検索したところ、6145 件ヒットした。
TIL を通して自分が困って調べたことをまとめて書いておくことで、再び同じ問題にぶつかったときに調べ直さなくて良くなる効果がある。
文書の形式としては、比較的簡単に書ける Markdown を使用することが多いようである。
本サイトは 2019/12/6 のコミットから始まり、 Sphinx とその拡張機能を利用してソースコードや図、数式、グラフなどを含ませつつ、調査したことや実験したことなどをまとめている。軽い備忘録として書いているページから、他人への説明用を兼ねて書いたページまで、様々なレベルのやる気で書かれたページが存在するため、内容の品質はページによって大幅に異なる。
運用#
リポジトリ#
GitLab の TIL リポジトリ （作業用）
GitHub の TIL リポジトリ （ミラー）
主なツール#
-
Restructured Text の形式で書いた文章を HTML, CSS, Javascript によるサイトへ変換する。
ただ Markdown を書く場合に比べて環境構築は多少手間がかかるが、環境構築後はテキストの文章を書くだけで見た目の整ったページを作ることができ、拡張機能を用いて数式や UML などを挿入することもできる。
使用している拡張機能# 名前
用途
sphinx.ext.todo
TODO の記載。
sphinx.ext.mathjax
数式の記載。
myst_nb
Jupyter Notebook と Markdown によるページの追加。主に Plotly ライブラリを用いたグラフの描画に用いている。
sphinxcontrib.plantuml
PlantUML による UML の描画。
sphinxext.opengraph
Open Graph 用のメタデータの追加。
sphinxcontrib.bibtex
BibTeX による参考文献の追加。
Sphinx で生成するサイトの見た目を制御するテーマとして、本サイトでは sphinx-book-theme をベースに配色と文字サイズを調整したものを使用している。
-
Python の仮想環境を管理するツール。
Python パッケージのバージョンを作業環境と CI 環境で揃えるために使用する。
ライセンス#
本サイトはクリエイティブ・コモンズ 表示 4.0 国際 ライセンス の下に提供している。
なお、本サイトで使用している下記のアイコンは KIcon リポジトリ で別に管理しており、別のライセンスになっている。
