Update document. Extension Scaffold.

docs/tmdmaker.doc/src/site/sphinx/index.rst

@@ -4,24 +4,26 @@
    contain the root `toctree` directive.
 
 TMD-Maker ドキュメント
-=======================
+================
 
 このドキュメントでは、TMD-Makerの説明とTMD-Makerを使ったTMD(T字形ER図)の作成方法を解説します。
 
 ※内容はTMD-Makerの進化と、私のTM(T字形ER手法)の理解の深化に伴い順次更新します。
 
-目次:
-------
+目次
+--
 
 .. toctree::
    :maxdepth: 2
 
    p1
    p2
    p3
+   p4
+   p5
 
 索引と検索
------------
+-----
 
 * :ref:`genindex`
 * :ref:`search`

docs/tmdmaker.doc/src/site/sphinx/p1-ch2.rst

@@ -7,6 +7,7 @@ TMD-Makerは日々バージョンアップしていますので、できない
 
 TMD-Makerへ追加して欲しい機能があれば、`新規チケット <https://ja.osdn.net/ticket/newticket.php?group_id=4743>`_ でリクエストをください。
 
+
 特徴
 --
 

docs/tmdmaker.doc/src/site/sphinx/p1-ch4.rst

@@ -1,8 +1,7 @@
 TMD-Maker Pluginのインストール
 =======================
 
-TMD-Maker Pluginは、Eclipse
-Pluginです。普段Eclipseを使用している人や、説明不足のマニュアル作成者に文句を言わずに自分で道を切り開ける人にお勧めします。少々脅してしまいましたが、あまり身構えずに一度深呼吸してから始めましょう。
+TMD-Maker Pluginは、EclipseのPluginです。普段Eclipseを使用している人や、説明不足のマニュアル作成者に文句を言わずに自分で道を切り開ける人にお勧めします。少々脅してしまいましたが、あまり身構えずに一度深呼吸してから始めましょう。
 
 動作環境
 ----
@@ -17,7 +16,7 @@ Pluginです。普段Eclipseを使用している人や、説明不足のマニ
 -  Eclipse 3.4 以上（4.7推奨）
 
    現在、Eclipse
-   4.7.0(Oxygen)で開発しています。またPluginの動作確認では、バージョン3.4.2以降を使用していますので、多分バージョン3.5以降と4.2以降で動作します。もしかしたらまだバージョン3.3でも動作するかも知れません。
+   4.8.0(Photon)で開発しています。またPluginの動作確認では、バージョン3.4.2以降を使用していますので、多分バージョン3.5以降と4.2以降で動作します。もしかしたらまだバージョン3.3でも動作するかも知れません。
 
 -  GEF(Eclipse Graphical Editing Framework) 
 

docs/tmdmaker.doc/src/site/sphinx/p3-ch1.rst

@@ -0,0 +1,51 @@
+拡張機能の雛形プロジェクトのセットアップ
+====================
+
+まずは拡張機能を開発するための準備をしましょう。
+
+拡張機能の雛形プロジェクトダウンロード
+-------------------
+
+tmdmaker\_extensionsのダウンロードサイトから
+拡張機能の雛形プロジェクト、 `tmdmaker_extension_scaffold_x.y.z.zip <https://tmdmaker/ddlutils/>`_ をダウンロードします。
+
+解凍後にフォルダを任意の名前に変更してください。拡張機能の名前と合わせた方が分かりやすいです。
+
+Eclipseセットアップ
+-------------
+
+Eclise 4.x系であれば多分大丈夫ですが、なるべく最新版をご利用ください。
+
+
+拡張機能プロジェクトの取り込み
+---------------
+
+EclipseのFile-ImportからExisting projects into WorkspaceでNextを選び
+Select root directoryで拡張機能のフォルダを選択してFinishを選択します。
+インポート後にプロジェクトフォルダをリファクタリングして拡張機能に名前を付けます。
+
+拡張機能の依存関係解決
+-----------
+
+まだプロジェクトにエラーが出ていますのTMD-Makerの必須プラグインとの依存関係を解決しましょう。
+プロジェクトフォルダ直下のplugin-development.targetを開き
+右上のReload Target Platformをクリックしてください。
+しばらく待つとエラーが消えます。
+
+お疲れ様でした。拡張機能の開発準備が整いました。
+
+雛形の説明
+-----
+雛形には以下のクラスが既に用意されています。これらのクラスはplugin.xmlで関連付けされています。
+
+- tmdmaker.extensions.scaffold.Actovator
+
+  拡張機能起動時に呼び出されます。雛形では特に何もやっていません。
+
+- tmdmaker.extensions.scaffold.importer.FileImporter1
+
+  tmdmaker.importersを実装するインターフェースを継承したクラス。今回は特に紹介しませんが、興味があれば挑戦してみてください。
+
+- tmdmaker.extensions.scaffold.generator.Generator1
+
+  tmdmaker.generatorsを実装するインターフェースを継承したクラス。これからサンプルを実装します。  

docs/tmdmaker.doc/src/site/sphinx/p3-ch2.rst

@@ -0,0 +1,51 @@
+Generator拡張機能作成
+===============
+
+それでは拡張機能を開発していきましょう。
+まずはGeneratorを拡張した簡単なファイル出力サンプルを作成します。
+
+コンテキストメニューに表示する名前を決める
+---------------------
+
+以下のメソッドをオーバーライドするとコンテキストメニューに表示する名前が決まります。グループ名はコンテキストメニュー表示される順番に影響します。::
+
+    @Override
+    public String getGeneratorName() {
+       return "エンティティ一覧";
+    }
+
+    @Override
+    public String getGroupName() {
+       // TODO Auto-generated method stub
+       return "雛形グループ";
+    }
+
+モデルの情報をファイルに出力する
+----------------
+
+以下が実行時の処理です。ファイルを作成してモデルの情報を出力しています。::
+
+    @Override
+    public void execute(String rootDir, List<AbstractEntityModel> models) {
+        File file = new File(rootDir, "entity_name.txt");
+        PrintWriter writer = null;
+      
+        try {
+           writer = new PrintWriter(file, "UTF-8");
+           for (AbstractEntityModel model : models) {
+              writer.print(model.getName());
+              writer.print(",");
+              writer.println(model.getEntityType());
+           }
+        } catch (Exception e) {
+            // TODO: 例外をthrow
+        } finally {
+           if (writer != null) {
+              writer.flush();
+              writer.close();
+           }
+        }
+     }
+
+
+これだけです。モデルの構成やEclipse Pluginの仕組みを理解すれば、より高度なデータ出力が実現可能です。

docs/tmdmaker.doc/src/site/sphinx/p3-ch3.rst

@@ -0,0 +1,26 @@
+Generator拡張機能実行
+===============
+
+最後に作成した拡張機能を実行します。
+拡張機能のjarファイルを作成してTMD-Makerにインストールして拡張機能を動かしてみましょう。
+
+サンプル拡張機能をエクスポート
+---------------
+
+1. plugin.xmlを開きます。
+2. Overviewタブの右下、Export Wizardをクリックします。
+3. DestinationタブのDirectoryで任意の出力先を指定してFinishボタンをクリックします。
+4. 出力先のpluginsフォルダ内にjarファイルが作成されます。
+
+サンプル拡張機能をインストール
+---------------
+
+TMD-Makerのフォルダ配下のdropinsフォルダにjarファイルを配置した後、TMD-Makerを実行します。
+
+TMD-Makerで動作確認
+--------------
+
+エディタ内で右クリックした時にコンテキストメニューに表示された拡張機能選択してみましょう。
+ファイルが出力されましたか？
+
+

docs/tmdmaker.doc/src/site/sphinx/p3-ch4.rst

@@ -0,0 +1,8 @@
+拡張機能まとめ
+=======
+
+今回はGeneratorのサンプルを作成してみました。
+FileImporterについても興味があれば是非挑戦してみてください。
+
+またTMD-Makerのモデル自体や他の機能も公開されていますので
+皆でTMD-Makerをより良いものにしていきましょう。

docs/tmdmaker.doc/src/site/sphinx/p3.rst

@@ -1,10 +1,30 @@
-リファレンス
-=============
+TMD-Makerの機能を拡張する
+=================
+
+このパートでは、TMD-Makerの機能拡張の作成方法を説明します。
+
+TMD-Makerは機能を拡張できるポイントをいくつか持っています。
+この機能拡張ポイントを利用して独自の機能拡張を作成することができます。
+現在利用可能な機能拡張ポイントは以下の通りです。
+
+1. tmdmaker.generators
+
+   TMD-Makerのモデルから、別フォーマットのファイルを生成できます。
+   htmlやDDL、Sphinx、csv形式のドキュメント出力機能もこの拡張ポイントを使っています。
+
+2. tmdmaker.importers
+
+   別フォーマットのファイルからTMD-Makerのモデルを生成できます。
+   csv形式からTMD-Makerへのインポート機能もこの拡張ポイントを使っています。
+
+TMD-MakerはEclipse Pluginで作成されていますが、
+紹介する雛形のプロジェクトを利用すればEclipse Pluginが分からなくても、Javaが書ければ多分大丈夫！
+是非挑戦してみてください。
 
 .. toctree::
    :maxdepth: 2
 
-   rcp
-   database
-   csvformat
-   faq
+   p3-ch1
+   p3-ch2
+   p3-ch3
+   p3-ch4

docs/tmdmaker.doc/src/site/sphinx/p4.rst

@@ -0,0 +1,17 @@
+TMD-Makerの開発に参加する
+=================
+
+このパートでは、TMD-Makerの開発方法を説明します。
+
+TMD-Makerはosdnを利用しています。
+
+開発に必要な情報は以下に記載しています。随時更新してます。
+
+https://osdn.net/projects/tmdmaker/wiki/Development
+
+osdnは無料なのでアカウント登録したら是非以下のページからメンバー参加してみてください。
+
+https://osdn.net/projects/tmdmaker/memberlist/
+
+.. toctree::
+   :maxdepth: 2

docs/tmdmaker.doc/src/site/sphinx/p5.rst

@@ -0,0 +1,10 @@
+リファレンス
+=============
+
+.. toctree::
+   :maxdepth: 2
+
+   rcp
+   database
+   csvformat
+   faq

src/site/site.xml

@@ -61,8 +61,14 @@
 		</links>
 
 		<menu name="ドキュメント" inherit="top">
-			<item name="マニュアル" href="./doc/index.html" />
-			<item name="よくある質問" href="./doc/faq.html" />
+			<item name="リリースバージョン" >
+				<item name="マニュアル" href="./doc/index.html" />
+				<item name="よくある質問" href="./doc/faq.html" />
+			</item>
+			<item name="Latest" >
+				<item name="マニュアル" href="https://tmdmaker.readthedocs.io/ja/latest/index.html" />
+				<item name="よくある質問" href="https://tmdmaker.readthedocs.io/ja/latest/faq.html" />
+			</item>
 	    </menu>
 
 		<menu name="プロジェクト" inherit="top">