はじめに いいわいいわ！ nikkieです。 Python Boot Camp（a.k.a. pycamp）のライディングページをSphinxで作って得た知見をアウトプットするシリーズ1です。 ランディングページをぜひご覧になっていただきたいのですが、ボタンやカードの並びがあるんです…

はじめに 聞いて聞いて！ nikkieです。 ドキュメント変換ツールSphinxのautodoc拡張を使うと、Pythonファイルからドキュメント（HTMLやPDFなどなど）を作れます。 HTMLでドキュメントを作るときに、このautodoc拡張と、私が先日リリースしたライブラリsphinx…

はじめに 秘密はね、最後に明かされるんだよ、nikkieです。 Python Boot Camp1（a.k.a pycamp）のライディングページを今年Sphinxで作りました！2 この実装の一部「過去の開催回で集まった人数」の表について、実装の秘密を明かしちゃいます！ 目次 はじめに…

はじめに ずっとずっと、一緒だと思っていた。1 nikkieです。 reStructuredText（reST）にはいろんなマークアップがありますよね。 リンクを作りたいときは `Link text <https://domain.invalid/>`_ と書いてきた2のですが、これが何をしているか何も分かっていなかったことをこのたび</https://domain.invalid/>…

はじめに 「みんな、ウタだよ！」、nikkieです。 先日、愛用しているsphinx.ext.githubpagesを紹介しました。 今回はsphinx-revealjsとsphinx.ext.githubpagesの組合せについて紹介します。 目次 はじめに 目次 本記事の立ち位置 結論：sphinx.ext.githubpag…

はじめに 「みんな、ウタだよ！」、nikkieです。 今回はSphinxでビルドしたHTMLをGitHub Pagesで公開するときのtipsをアウトプットします。 sphinx.ext.githubpagesってご存知でしたか？ 目次 はじめに 目次 SphinxとGitHub Pagesを一緒に使うときの落とし穴…

はじめに 聞いて聞いて！ nikkieです。 このたびPyPIにちょっとしたSphinx拡張をリリースしました！ この記事ではそのライブラリについて紹介していきます。 目次 はじめに 目次 前提：SphinxでHTMLをビルドする たたーん♪ その名もsphinx-new-tab-link！ ブ…

はじめに 聞いて聞いて！ nikkieです。 先日以下のように書きました。 sphinx-revealjsいいと思うので、皆さんに使ってほしく、筆を進めねば・・ https://nikkie-ftnext.hatenablog.com/entry/yapc-japan-online-2022-awesome-talks#fn:5 こちらを実現させて…

はじめに 頑張れば、何かがあるって、信じてる。nikkieです。 技術同人誌執筆以来使っているドキュメンテーションツールSphinxで、includeするファイルはrst以外の拡張子にするべきということを知りました。 Tips: you should use other extensions for incl…