sphinx-revealjs

はじめに ばーい！1 nikkieです。 発表資料を作るのにsphinx-revealjsを愛用しています。 年1ペースで発表資料リポジトリを作っているのですが、先日PHPカンファレンス関西2用のスライドを公開しました。 その中で実施した初期設定を未来の私に伝えるために、ここにまとめます。 目次 はじめに 目次 sphinx-quickstart conf.pyにReveal.jsの設定を書く 共通CSSの配置 GitHub Actions OGP設定 終わりに sphinx-quickstart コマンドラインから引数マシマシで渡して、対話的にはあえて使いません conf.pyにReveal…

はじめに エクスペクト・パトローナム！1 nikkieです。 久しぶりのSphinxネタです。 Sphinxを使ってチュートリアルや発表資料を作る中で、Pythonの対話モードの実行例を書くことがあります。 内容を調整しているうちに、気づかず実行例を壊してしまうことがあったのですが、Python標準ライブラリのdoctestでテストできることを知ってから、実行例を壊してしまう不安から解放されました！ 目次 はじめに 目次 この記事で扱うツール Sphinxと実行例 doctest 伝えたいこと nikkieのSphinx × doctest使用例 通常ユースケース reSTのコメントを使って前…

はじめに うるせェ！！！ 行こう！！！！、nikkieです。 Sphinxに関する小ネタです。 ビルドしたHTMLに取り消し線1を引く方法を共有します。 目次 はじめに 目次 結論：Sphinxで出力するHTMLに取り消し線を引く方法2つ 1. ライブラリ sphinxnotes-strike 2. Sphinxで出力するHTMLに取り消し線を引けるように設定追加する 2がこんなに簡単な秘密はdocutilsに 2の使用例（sphinx-revealjs） 終わりに 結論：Sphinxで出力するHTMLに取り消し線を引く方法2つ ライブラリ sphinxnotes-strike を使う 少しの…

はじめに 聞いて聞いて！ nikkieです。 先日以下のように書きました。 sphinx-revealjsいいと思うので、皆さんに使ってほしく、筆を進めねば・・ https://nikkie-ftnext.hatenablog.com/entry/yapc-japan-online-2022-awesome-talks#fn:5 こちらを実現させていきます。 まずは一番単純なトピックから。 sphinx-revealjsで作ったスライドをGitHub Pagesで公開する方法を共有します！ ちなみに私の登壇資料は、2021年からsphinx-revealjs × GitHub Pagesという…

はじめに PyCon mini Shizuoka 2024 continue、1日ありがとうございました！ nikkieです。 登壇準備からSphinxまわりの小ネタです。 スライド作成にはattakeiさんのsphinx-revealjsを使っています。 目次 はじめに 目次 sphinx-revealjs製スライドにMermaidによる図を表示 SphinxのドキュメントにMermaidによる図を埋め込んだことがあった sphinx-revealjs製スライドでも埋め込める理由 裏話 終わりに sphinx-revealjs製スライドにMermaidによる図を表示 こちらのスライドがそれで…

目次 目次 sphinx-revealjs製のスライドのコードブロックを、ボタン一発でコピーできるようにしたい！ sphinx-revealjs-copycode 0.1.0をリリースして P.S. エミリーちゃんかわいい sphinx-revealjs製のスライドのコードブロックを、ボタン一発でコピーできるようにしたい！ 先日「sphinx-revealjs製のスライドのコードブロックを、ボタン一発でコピーできるようにする」方法を書きました。 Reveal.jsのCopyCodeプラグインを採用 sphinx-revealjsの仕組みを使う conf.pyの設定値 site-packages…

はじめに 恋アスが現実に！胸熱... nikkieです。 登壇資料作成にはsphinx-revealjsを愛用して静的サイトとしてホストしています1。 このたびブレイクスルーが起きました！ コードブロックをワンクリックでコピーできるボタンを設置できたのです🙌 目次 はじめに 目次 結論 初手、sphinx-copybutton！ Reveal.js CopyCode sphinx-revealjsの機構を利用する 終わりに 結論 Reveal.jsのプラグインを使って実現しました！ https://ftnext.github.io/2024-slides/pyconshizu/logging-…