Doxygenでは、出力に数式を含めることができます(これはHTML、
、RTF出力でのみ機能します)。HTMLおよびRTFドキュメントに数式(画像として)を含めるには、以下のツールもインストールする必要があります。
latex:
数式を解析するために必要なdvips:
DVIファイルをPostScriptファイルに変換するツール。テストではRadical Eye softwareのバージョン5.92bを使用しました。gs:
PostScriptファイルをビットマップに変換するためのGhostScriptインタープリター。テストではAladdin GhostScript 8.0を使用しました。HTML出力の場合、上記のツールを必要としないMathJaxを使用した代替ソリューションもあります。設定でUSE_MATHJAXを有効にすると、LaTeX数式はHTMLに「そのまま」コピーされ、クライアントサイドのJavaScriptがそれらを解析し、(インタラクティブな)画像に変換します。
ドキュメントに数式を含める方法は4つあります。
本文中に現れるインライン数式を使用します。これらの数式は、一対の\f$コマンドの間に配置する必要があります。例:
The distance between \f$(x_1,y_1)\f$ and \f$(x_2,y_2)\f$ is \f$\sqrt{(x_2-x_1)^2+(y_2-y_1)^2}\f$.
結果:
と
の間の距離は
です。
\f$とは異なり、本文中に現れるインライン数式を使用します。これはで数式モードを明示的に開きません。これらの数式は\f(と\f)コマンドの間に配置する必要があります。例:
The LaTeX and Tex logos are: \f(\LaTeX \f) and \f(\TeX \f).
結果:
LaTeXとTexのロゴは: と
です。
\f[ |I_2|=\left| \int_{0}^T \psi(t) \left\{ u(a,t)- \int_{\gamma(t)}^a \frac{d\theta}{k(\theta,t)} \int_{a}^\theta c(\xi)u_t(\xi,t)\,d\xi \right\} dt \right| \f]結果:
environment
は\f{eqnarray*}{ g &=& \frac{Gm_2}{r^2} \\ &=& \frac{(6.673 \times 10^{-11}\,\mbox{m}^3\,\mbox{kg}^{-1}\, \mbox{s}^{-2})(5.9736 \times 10^{24}\,\mbox{kg})}{(6371.01\,\mbox{km})^2} \\ &=& 9.82066032\,\mbox{m/s}^2 \f}結果:
最初のコマンドと3番目のコマンドについては、数式がの数式モードで有効なコマンドを含んでいることを確認する必要があります。2番目のコマンドは、USE_MATHJAXを使用する際に数式モードでも機能する有効なテキストモードコマンドである必要があります。4番目のコマンドの場合、そのセクションは特定の環境で有効なコマンドを含んでいる必要があります。
formula.repository
ファイル、およびform_*
ファイルを削除する必要がある場合があります。例えば、数式の構成要素や特定の単語の一貫した記述のために、独自のコマンドを定義する機能を持たせるには、設定オプションFORMULA_MACROFILEを使用して、
コマンドを含むファイルを指定できます。このファイルには
\newcommandおよび\renewcommandコマンドを含めることができ、それらは数式(画像バージョンおよびMathJaxバージョン)だけでなく、生成される
出力(PDF生成用)にも含まれます。
\newcommand(および\renewcommand)はオプションパラメータのないバージョンに制限されており、以下のタイプのみがサポートされています
例: