Slashcolon /:

『VSのXMLドキュメントファイル』の続きエントリです 結局、VSから吐き出されるXMLファイルだけではどうにもならないことが判明。と言うことで調べてみた。

Javaには、JavaDocという超定番のドキュメント作成の仕組みがある…では、C#にはC#Docとか.NETDocとかはないのか

Google先生に尋ねてみると…以下のようなものが引っかかってきた。

1. Sandcastle
2. Ndoc
3. C#仕様書工房
4. A HotDocument

ふ～ん、3は富士通製で昔近くの人が使っていた記憶が…ありゃ、もう終焉を迎えつつあるようなので除外。2のNDocもメンテされていないので除外。A HotDocumentも良くわからないが高いので除外

と言うことで、やはり選択肢はSandcastle（砂の城）ですか あ、個人的にはDoxygen好きなのですが…別の理由から却下されちゃいました

仕方ないので、Sandcastleを使うべくSandcastle Help File Builderもインストールして出力の日本語化なんてページもあったので参考にしてゴニョゴニョ。

はい。確かになかなか良くできています 出力は、MSDNチックな形式でchm形式かHTML形式で行えます。

サンプルを変換した雰囲気は以下のような感じ。

JavaDocには、Docletという手段が提供されていて色々調整ができますが…SandcastleにはDocletに相当する機能はないのかな

某所のお客さまは、Word文書じゃないとダメなのでなんとか変換しようとガンバッテみたのですが…CHM2WORDとかPDFにしてみたりとか…でも、どうしても望んだ形式にならない

とチャレンジしていたら…お客さまからの鶴の一声…

時代錯誤も良いとこですが…抵抗しようがないですね まぁ、今後のこともあるのでコメントはちゃんと書いてリバースできるようにはしておくしかないな。

JavaDocのDocletに相当する機能やSandcastleの出力を綺麗にWordかPDFに変換する方法があれば教えてください。

あSandcastleじゃなくても、もちろん構わないです

追記 2008-06-12 15:21:58
なんだか、ソース公開してないのにCodePlexに置くなぁ～という理由で一時的にSandcastleの公開が停止しているとのこと。via. InfoQ: オープンソースの違反により、MicrosoftがSandcastleを削除

追記　2008-06-13　10:40:17
ココで再公開されています。やっぱり、コードまでは出さなかったかぁ～残念

---

関連すると思われる他の投稿

• PDFが全然ポータブルじゃない？
• developerWorksの記事が盛りだくさん過ぎる件
• DjVu形式ってなかなか良いかも
• Excelの吐くCSVの特徴？
• なんとSandcastleのソースが公開された

Comments(2)       

トラックバック URL :