活動
2020/02/07から2020/03/07まで
2020/02/25
- 高徹 00:09 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する
- h4. Windows上でUTF-8でソースコードを記述した際、PlantUMLの図で文字化け
Windows日本語版のデフォルト文字コードはWindows-31J（シフトJIS系）のため、ソースコードをUTF-8で記述していると、ASCII文字以外の文字がPlantUMLの生成した図で文字化けしてしまう。
そこで、明示的に文字コードを指定する。
2020/02/24
- 高徹 23:54 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する
- h4. javadoc実行時にplantumlの記述が警告にならないようにしたい
Javadocのドキュメントコメント内にplantumlの記述をすると、
* @startumlや、@endumlが未定義タグとして警告
* 大なり・小なり記号（<、>）が警告（エラー）
などがあります。
-そこで、plantumlの記述をドキュメントコメントではなくjavadoc処理対象外のブロックコメントに記述します。-
以下はダメ - 高徹 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を右クリック > [ショートカットを作成]
ウィザードが表示されるので、メニューなりツールバーに追加する
以下はツールバーへの追加設定例
{{thumbnail(create_shortcut_toolbar-1.png, size=320)}}
{{thumbnail(create_shortcut_tool... - 高徹 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 JDK 8u241 Windows 64bit版 |
|_. NetBeans IDE | 8.2 日本語版 |
NetBeans IDEを起動し、Javaアプリケーションプロジェクトを新規作成する。
その際、パッケージ名： com... - 高徹 19:30 調査 #104: Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する
- javaソースコードのコメントにPlantUMLのUML記述を記載し、Antでビルドする方法が次のドキュメントにあり。
https://plantuml.com/ja/ant-task
NetBeans IDEのAntプロジェクトで上述のAntタスクを使用してJavadocコメントにPlantUMLで生成したUML図を貼る方法が次のドキュメントにあり。
http://randomthoughtsonjavaprogramming.blogspot.com/20... - 高徹 13:18 調査 #104 (進行中): Javadocで生成するドキュメントにPlantUMLで記述したUML図を埋め込む方法を調査する
- 調査目的：JavaソースファイルのコメントにPlantUMLツール用の言語（テキスト）を記述し、それから生成したUML図（シーケンス図、クラス図など）をJavadocで生成するドキュメントに含めたい
調査結果：
* [#104-2] に JavadocでPlantUMLの図を生成しドキュメントに貼る手順を記載。
課題：
* imgタグにパッケージの深さに応じた相対パスを記載するのは億劫、doc-filesに生成するようにしたい
⇒ 解決[#10... - 高徹 13:35 調査 #105: 主要ダウンロード先サイトへのホップ数調査
- h5. 2020-02-24調査
|_. サイトURL |_. IPv6 |_. ホップ数 |
|ftp.tsukuba.wide.ad.jp | yes | 14 |
|ftp.yz.yamagata-u.ac.jp | yes | 10 |
|ftp.nara.wide.ad.jp | yes | 15 |
|ftp.riken.jp | no ... - 高徹 13:22 調査 #105 (解決): 主要ダウンロード先サイトへのホップ数調査
- 調査目的：大きなファイルをダウンロードする際、ネットワーク的な遠近を判断するためにトレースルートする
調査結果：
完了条件：
2020/02/22
- 高徹 23:58 調査 #101: WSL上のCentOS 7でリモートXで日本語入力をする
- ibus-kkc を入れてうまく動かなかった
https://torutk.hatenablog.jp/entry/2019/11/24/110818
ibus がWSLで動かない？ 動く事例が散見される。何が不足しているのか？
dbus-x11 が必要との記述が散見される。ibus-kkcをyumでインストールした際はdbus-x11は依存関係で一緒にインストールされていた。
以下のブログによると、デスクトップ起動時にdbusが起動されるので、デス... - 高徹 20:33 調査 #101: WSL上のCentOS 7でリモートXで日本語入力をする
- CentOS 7では、日本語入力手段はibusが標準である。
WSL上では、ibusが動くとか動かないとか情報が一貫していない。
Ubuntuでは、日本語入力手段にfcitxを使う模様。
古くはuim、scim、scimなどがある。
- 高徹 20:27 調査 #101 (進行中): WSL上のCentOS 7でリモートXで日本語入力をする
- * 調査目的
WindowsのWSLでCentOS 7を動かし、その上でGUIを持つアプリケーションを実行する。Windows側にXサーバーを入れることで、Windowsデスクトップ上にWSLのCentOS 7で動くアプリケーションの画面が表示する。そのX画面上で日本語を入力する方法を調査する。
但し、GNOMEデスクトップ等の重い機能は使わず、Xウィンドウマネージャも使わないで実現したい。
* 調査結果：
uim-anthyについては、[[CentOS 7...
2020/02/19
- 高徹 22:58 調査 #100: Javadocで生成するドキュメントにUML図を埋め込む方法を調査する
- UMLGraph というツールがあるらしい。PlantUMLとは別のツールで、テキストで記述した情報からクラス図、シーケンス図を生成できる。Javadocと連携できるらしい。
https://www.spinellis.gr/umlgraph/
EPEL 7リポジトリにumlgraphと、umlgraph-javadocのパッケージがある。CentOS 7で取り込むのが容易かも。
2020/02/17
- 高徹 01:04 調査 #100: Javadocで生成するドキュメントにUML図を埋め込む方法を調査する
- ソースコードのコメントにPlantUMLの記述をして、javadoc生成時にUML図を生成し生成されたHTMLに貼ることができるツールを探してみた。
docletではなくtagletで実現しているツールを発見
https://github.com/mnlipp/jdrupes-taglets
要試行 - 高徹 00:55 調査 #100 (進行中): Javadocで生成するドキュメントにUML図を埋め込む方法を調査する
- PlantUMLのサイトに、javadocに埋め込む関連の記述を発見
https://plantuml.com/ja/doclet
UMLDocletを試してみた。
https://github.com/talsma-ict/umldoclet
まずは、JDK 9以降対応のumldoclet-2.0.7.jarをダウンロードし、graphviz 2.38へのPATHを通して実行。 - 高徹 00:38 調査 #100 (進行中): Javadocで生成するドキュメントにUML図を埋め込む方法を調査する
- 調査目的：Javadocで生成するドキュメントに、UML図（シーケンス図、クラス図など）を含めたい
調査結果：
完了条件：入手物、生成手順、サンプルをWikiに記載する。