追加.HTMLでは、ネイティブでは数式の記法はサポートされていません。Sphinxでは、ドキュメントの中に数式を表現するための拡張機能を2つサポートしています。他に数式をサポートを行うための拡張機能を作成する場合には、使用できるのであれば、このモジュールを再利用してください。設定値に追加しないでください。数式の入力言語としてはLaTeXのマークアップを利用します。これはプレーンテキストで数式を表現する記法としてはデファクトスタンダードになっています。LaTeX出力を行う場合には、変換をしないでそのまま利用できるというメリットもあります。以下の新しいマークアップの要素を定義しています::math:¶インラインの数式のロールです。いう式が成り立つことが示されました。数式を表示するディレクティブです。この数式は1行丸ごと使って表示されます。このディレクティブは、複数行の等式をサポートしています。b^2それぞれの数式は分割された環境にセットされます。ドキュメントを参照してください。b^2通常は数式には番号は付きません。オプションを使用してください。これが指定されると、数式のラベルを選択できます。この数式のラベルを使ってクロスリファレンスを作成することができます。ナンバリングの形式は出力フォーマットに依存します。オプションを使用することで、math環境で自動的にラッピングされるのを止めることができます。このオプションを指定した場合には、自分自身で適切な設定を行う必要があります。数式のラベルに対する、クロスリファレンスを行うためのロールです。この機能は、現在では同じドキュメント内でのみ動作します。ある、オイラーの恒等式は、最も美しい数学の法則に選出されました。使用して、数式をPNG画像にレンダリングします。当然のことながら、この拡張を使ったドキュメントをビルドするマシンでは、この両方のプログラムが利用可能である必要があります。この拡張用の設定値がいくつかあります。これらの設定値を変更することで、画像のビルドをカスタマイズしたりできます:pngmath_latex¶LaTeXを呼び出す場合のコマンド名です。コマンドが実行ファイルの検索パスにない場合には、フルパスを指定する必要があります。この設定はシステムの環境に依存するものなので、この設定はシステム間でポータブルではありません。オプションを使用して渡す方が望ましいでしょう。この値にはLaTeXの実行ファイルのパスだけを含むようにして下さい。呼び出す時のコマンド名です。実行ファイルの検索パス外にある場合には、絶対パスを指定してください。pngmath_latex_args¶LaTeXに渡す追加の引数です。デフォルト値は空のリストになります。数式のコード片を変換するのに使用する、短いLaTeXファイルの中の前置きとして入れる、追加のLaTeXコードです。デフォルトでは空です。このオプションは、例えば、数式の中で使いたいコマンドのためのパッケージを追加したりするのに使用することができます。pngmath_dvipng_args¶dvipngに与える、追加の引数をリストで渡します。画像をデフォルトよりも、多少暗く、サイズは少々大きくしmさう。追加したい引数をここで追加することができます。いうオプションを渡すと、背景が透明なPNG画像を生成することができます。Explorerもいくつか存在するために、デフォルトでは無効になっています。レンダリングされたテキストの”深さ”を決定することができます。行の文章の中に分数を写植する場合、テキストのベースラインと、生成された画像の底辺の高さが同じであってはならず、画像はベースラインよりも少し低い位置になるべでしょう。これがTeXの世界でいう”深さ”です。スタイルで画像が生成され、HTMLドキュメントに入れられます。インストールされていなければ動作しません。JavaScriptを使用して数式をレンダリングします¶この拡張機能は、数式をそのままHTMLファイルに埋め込みます。ロードされ、LaTeXのマークアップが、ブラウザ上で動的に読める数式に変換します。jsMath(と必要なフォント)はかなり巨大です。そのため、Sphinxには含まれていません。自分でインストールを行い、設定値を使って、その置き場のパスをSphinxに知らせなければなりません:jsmath_path¶JavaScriptファイルをHTMLファイルに取り込み、JSMathをロードするために必要なオプションです。デフォルト値はありません。パスは絶対パスでも、相対パスでもどちらでも大丈夫です。相対パスの場合には、ビルド済みのドキュメントのルートが絶対パスになります。Sphinxのドキュメントをサーバ上に何セットも設置する場合には、共有の場所にjsMathをインストールするのが賢明でしょう。