Torutk

2020/02/24

00:09 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. Windows上でUTF-8でソースコードを記述した際、PlantUMLの図で文字化け
Windows日本語版のデフォルト文字コードはWindows-31J（シフトJIS系）のため、ソースコードをUTF-8で記述している...

23:54 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. javadoc実行時にplantumlの記述が警告にならないようにしたい
Javadocのドキュメントコメント内にplantumlの記述をすると、
* @startumlや、@endumlが未定義タグとして警告
...

23:28 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. PNGではなくSVGを生成
build.xmlで、plantumlタスクの属性 format に"svg"を指定します。...

23:24 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. javadoc-umlビルド後、ブラウザに表示するところまで自動化したい
build.xmlでjavadoc-umlターゲットの最後に-javadoc-browseターゲットを呼び出すantcallを追加します。
...

23:21 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. 独自のAntターゲットを実行するのは面倒
* 左側ペインで[ファイル]タブを選択、build.xmlを展開し、javadoc-umlを右クリック > [ショートカットを作成]
ウィザードが表示されるので、メニューなりツ...

23:14 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

h4. imgタグにパッケージの深さに応じた相対パスではなくdoc-filesに生成するようにしたい
Javaソースコードコメントには次のように記述する。...

22:16 ソフトウェアエンジニアリング 調査 #104 (進行中): Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

javadocで生成したドキュメント例。シーケンス図が貼られている。
{{thumbnail(umlsequence-1.png, size=320)}}

22:10 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

次の環境で、PlantUMLのUML図（シーケンス図）をJavadocコメントに貼る方法を調査する。
|_. OS | Windows 10 Pro 1909 64bit 日本語版 |
|_. JDK | Oracle JD...

19:30 ソフトウェアエンジニアリング 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する

javaソースコードのコメントにPlantUMLのUML記述を記載し、Antでビルドする方法が次のドキュメントにあり。
https://plantuml.com/ja/ant-task
NetBeans IDEのAntプロジェ...

13:35 ソフトウェアエンジニアリング 調査 #105: 主要ダウンロード先サイトへのホップ数調査

h5. 2020-02-24調査
|_. サイトURL |_. IPv6 |_. ホップ数 |
|ftp.tsukuba.wide.ad.jp | yes | 14 |
|ftp.y...