Source documentation/ja

FreeCADのソースコードは、Doxygenを使ってHTMLドキュメントを自動生成するようにコメントされています. これは、FreeCADソースコードのC ++部分とPython部分の両方に当てはまります.

オンラインのソースドキュメントはhttp://www.freecadweb.org/api/にあります.

ソースドキュメントのビルド
Doxygenをインストールしてあればドキュメントのビルドは非常に簡単です. FreeCADビルド用のディレクトリに移動してCMakeでソースを設定した上で次のコマンドを実行します：

Then follow the same steps you would do to compile FreeCAD, as described on the compile on Unix page, and summarized here for convenience.
 * Get the source code of FreeCAD and place it in its own directory.
 * Create another directory in which you will compile FreeCAD and its documentation.
 * Configure the sources with, making sure you indicate the source directory, and specify the required options for your build.
 * Trigger the creation of the documentation using.

While you are inside the build directory issue the following instruction to create only the documentation.

その後でDoc/SourceDocu/html/index.htmlから始まる結果のhtmlファイルを調べてください.

The point of entrance to the documentation is the file, which you can open with your web browser:

（注意：DevDocターゲットは自動ツールビルドでは有効になっていません）その性質上、ソースドキュメントは常に作業進行中状態にあります. よく起きることですが必要がある時にはためらわずに再ビルドを行なってください. それはhttp://www.freecadweb.org/api/で使用されているバージョンも代わりに発行することによって生成することができます：

An alternative, smaller version of the documentation which takes only around 500 MB can be generated with a different target. This is the version displayed on the FreeCAD API website.

またこれとは別にこのドキュメントは折を見て生成されては、sourceforgeのここでアクセス可能な状態で置かれています.

FreeCAD 0.16 development documentation built by qingfeng.xia.

これはFreeCAD Doxygen documentationです qingfeng.xiaによって生成されます.

Coin3Dドキュメントの統合
UNIX系ではCoin3DのソースドキュメントをFreeCADのものとリンクすることが可能です. これを行うと移動が楽になり、またCoin派生クラスの継承ダイアグラムを作成できます.


 * Debianとそこから派生したシステムの場合：
 * - パッケージlibcoin60-docをインストール
 * - ファイル /usr/share/doc/libcoin60-doc/html/coin.tag.gzを展開
 * - ソースドキュメントを再生成
 * オフラインでのブラウジングができます.


 * もしCoinのドキュメントパッケージをインストールしたくない/できない場合、設定時(wget)にDoxygenタグファイルがダウンロード可能であればdoc.coin3D.orgにあるオンラインのCoinドキュメントへのリンクが生成されます.

How to integrate doxygen in to the FreeCAD source code
Example of a complete doxygen page: (from another project)

doxygen: http://www.vtk.org/doc/nightly/html/classvtkArrayCoordinates.html

source: https://github.com/Kitware/VTK/blob/master/Common/Core/vtkArrayCoordinates.h