鈴木たかのり（@takanory）です。今月の「Python Monthly Topics」では、Python製の静的サイトジェネレーターSphinxを使用してWebサイトを構築し、テーマを適用、外部へ公開する流れについて紹介します。後半ではSphinxの便利な拡張機能を紹介し、Webサイトをより便利にしていきます。 Markdownでドキュメントを書くだけで、きれいなWebサイトが簡単に公開できるので、ライブラリのドキュメントなどでもよく使われています。 Sphinxとは SphinxはPython製の静的サイトジェネレーターです。静的サイトジェネレーターとは、Markdown等の軽量マークアップのテキストファイルから、静的なWebサイトを生成するアプリケーションのことを言います。Python製の静的サイトジェネレーターにはSphinxを含め以下のツールなどがあります。 Sphinx：h
SPHINX (水道橋/レストラン)
リクエスト予約希望条件をお店に申し込み、お店からの確定の連絡をもって、予約が成立します。 1 予約の申し込み ご希望の条件を当サイトよりご入力ください。 2 お店からのメール ご予約が承れるか、お店からの返信メールが届きます。 3 お店へ来店 予約が確定した場合、そのままお店へお越しください。
Sphinxでクロスリファレンスを機能させるためには、includeするファイルをrst以外の拡張子にすべきと身をもって学びました - nikkie-ftnextの日記
はじめに 頑張れば、何かがあるって、信じてる。nikkieです。 技術同人誌執筆以来使っているドキュメンテーションツールSphinxで、includeするファイルはrst以外の拡張子にするべきということを知りました。 Tips: you should use other extensions for included documents (cf .txt). 目次 はじめに 目次 要するに サンプルドキュメント index.rst section1.rst subsec1.rst subsec2.rst 環境 PDFビルドコマンド 解決策 解決する理由 拡張子を変えたあとの色分け設定（VSCode） 終わりに 要するに Sphinxにはrefやnumrefを使ったクロスリファレンスの仕組み1があります。 セクションの直前にラベルを付けて、それを参照できます（ドキュメントにある例）。 ..
docsifyとは documentation site generator. ドキュメントサイトを構築するツールです。 使ってみるとわかりますが、すごく手軽に使えます。 開発ドキュメントを書くのにピッタリです。 似たようなツールとして、gitbookやSphinxもこれまで使ってきましたが、 gitbookはローカルで使うにはサポート切れ SphinxはPython使わないプロジェクトでPython環境構築するのしんどい などあって、良いツールを探していましたが、やっと見つけました。 docsifyでできること 以下のような要件であれば、docsifyはちょうど良いと思います。 Markdownでドキュメントを書きたい 書いたドキュメントをクラウド上でホスティングしたい ドキュメントはgitでソースコードと一緒に管理したい plantumlを使いたい docsifyのいいところ セットア
Sphinx拡張 pydata-sphinx-theme に見る、動的に生成したTranslatorクラスの指定 - nikkie-ftnextの日記
はじめに 0ビットLLM見えましたね、nikkieです。 本日もSphinxネタ、めちゃ頭いいなと思った実装の紹介です。 目次 はじめに 目次 復習：Sphinx拡張でTranslatorを指定する pydata-sphinx-theme setup()関数 見事な実装 translator モジュール BootstrapHTML5TranslatorMixin 動的クラス生成を使った setup_translators() 終わりに 復習：Sphinx拡張でTranslatorを指定する 自作のSphinx拡張の実装について def setup(app): app.set_translator("html", NewTabLinkHTMLTranslator) HTML用のBuilder（"html"）に 出力フォーマット変換にNewTabLinkHTMLTranslatorを使うように
CNN 10 - How did the Great Sphinx end up in the desert? | November 8, 2023 英英辞典(Collins Cobuild Advanced Dictionary) 1 - 英語のブログ
CNN 10 - How did the Great Sphinx end up in the desert? | November 8, 2023 英英辞典(Collins Cobuild Advanced Dictionary) 1 今日、英英辞典(Collins Cobuild Advanced Dictionary Collins Cobuild (編集))で引いた単語数、18語。 terriercertain1certain2cross-breedselectiveyieldfrogconvenientbreedingill-bredpure-bredwell-bredhighlandsresearchcase studyhigh-speedescarpmehntfirst-class視覚と聴覚の融合のための本題のステップ4は目標通りDVD(Full House)を鑑賞。 You
Homepage – Sphinx Restaurant
エジプトのおもてなしの真髄を発見してください 私たちの親切で気配りのあるスタッフは、お客様が皇族のように扱われることを保証するために最善を尽くします。それにより、温かく歓迎の雰囲気が生まれ、お食事をより一層特別なものにします エジプトの味を融合させた料理 私たちの融合料理は、エジプトの豊かな文化遺産へのオマージュであり、エキサイティングで斬新な方法で国の多様な影響や味わいを表現した料理です
Sphinxを使う準備をする Sphinxを導入する 公式の手順に従って、導入します。 Sphinxのインストール — Sphinx documentation 適当なプロジェクトを作成する 公式の手順に従って、適当なプロジェクトを作成します。 sphinx-quickstart docs Getting started — Sphinx documentation テーマを変更する デフォルトテーマの「alabaster」は、本記事の方法で最終更新日が表示されません。そのため、他のテーマに変更します。 conf.py html_theme = "classic" ビルドする HTMLサイトをビルドします。 cd docs make html ビルド後は、下記のファイルを開いて、確認します。 open build/html/index.html ドキュメントの最終更新日を表示する conf
CNN 10 - How did the Great Sphinx end up in the desert? | November 8, 2023 英英辞典(Collins Cobuild Advanced Dictionary) - 英語のブログ
CNN 10 - How did the Great Sphinx end up in the desert? | November 8, 2023 英英辞典(Collins Cobuild Advanced Dictionary) 今日、英英辞典(Collins Cobuild Advanced Dictionary Collins Cobuild (編集))で引いた単語数、13語。 sliparablefar-flungoutpostpushing backvolcanicstratosphereanchoramongstboaastsbowlingbowlerbatting視覚と聴覚の融合のための本題のステップ4は目標通りDVD(Full House)を鑑賞。 YouTubeはCNN 10のHow did the Great Sphinx end up in the desert?
make htmlだけじゃない！？ Sphinxのビルドコマンドには make singlehtml というものもあるんです！ - nikkie-ftnextの日記
はじめに 先輩、飲みます？ nikkieです。 Python Boot Camp（a.k.a. pycamp）のライディングページをSphinxで作って得た知見をアウトプットするシリーズです。 このページ、HTMLなのでmake htmlでビルドしてると思うじゃないですか〜1。 実はmake singlehtmlを使うという工夫2をしてるんです！ 目次 はじめに 目次 ドキュメント変換ツールSphinx SphinxのMakefileの秘密 singlehtmlビルダー 過去の記事との関連 終わりに ドキュメント変換ツールSphinx Sphinx（スフィンクス）は、あるルールに従って記述されたテキストファイルを、HTMLやPDFなどの形式に変換するドキュメント変換ツールです。 『Sphinxをはじめよう 第3版』（1章）より pycampランディングページはreStructuredTex
pandocの使い方覚書です。ePUBとHtmlの出力に主に利用しています。 pandocはmarkdown preview enhancedとあわせて使うと便利です。
Sphinxの使い方
$ cd プロジェクト名 $ poetry init $ poetry add --group=docs sphinx $ poetry add --group=docs myst_parser $ poetry add --group=docs sphinx_rtd_theme $ sphinx-quickstart docs PythonのパッケージはPoetryで管理する前提 ドキュメント関係のパッケージは--group=docsに追加する（--group=devでも--groupをつかなくてもいい） ドキュメントはプロジェクト名/docsに作成する テーマを変更する sphinx_rtd_theme から pydata_sphinx_theme に変更してみたい さらに sphinx_book_themeに変更したい $ pip3 install pydata_sphinx_the
飯田橋にあるSPHINX （スフィンクス）というエジプト料理をビュッフェで食べられるお店がとても良さそう「お茶も美味しい」「コーシャリには手を出すな」
莉香 @mostaleyja エジプトご飯のビュッフェ行ってきた。これで平日1500円は激アツ。飯田橋（水道橋からもいける）SPHINXさんにて。 めちゃめちゃおいしかった。 内装もエジプトな感じでいい。 pic.twitter.com/783JbtPL6x
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Python製静的サイトジェネレーターSphinxでWebサイトを構築して公開 | gihyo.jp
docsifyでgitbookやSphinxより手軽にドキュメントサイトを構築 - Qiita
Sphinxでドキュメントの最終更新日を表示する | DevelopersIO
vscodeでpandoc 3の使い方/商用利用やライセンスは?Re:VIEWとSphinxとの比較