46

XSD スキーマで十分に文書化されている XML ベースのインターフェースがいくつかあります。インターフェイスは公開される予定であり、それらのリファレンス ドキュメントを作成したいと考えています。

XSD ファイルをより読みやすい形式に自動的に変換できるツールはありますか?

4

8 に答える 8

19

xs3pはあなたが望むことを行うかもしれません ( SourceForce ページも参照してください)。

于 2008-10-27T04:22:42.370 に答える
17

これを XSD の先頭に挿入します

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="xs3p.xsl"?>

その後、Web ブラウザーを使用して XSD ファイルを直接表示できます。Web ブラウザーは、指定された XSLT を使用して HTML への変換を行います。

XSL プロセッサは必要ありませんが、xs3p のようなスタイルシートはこのアプローチを使用してリンクを生成しません。私は Firefox Web ブラウザーを使用していますが、これには IE8 は役に立たないようです。

これらの xsl スタイルシートを試しました: https://sourceforge.net/projects/xs3p/files/xs3p-1.1.3.zip/download http://crism.maden.org/consulting/pub/xsl/xsd2html.xsl

私は xs3p の方が好きだと思います。

于 2010-02-01T12:16:20.763 に答える
6

oXygenには、オプションや追加の CSS ファイルを使用して簡単にカスタマイズできる、非常に優れたXSD スキーマ ドキュメント ツールがあります。

これまで使用したことはありませんが、FlexDoc/XMLは、 XSDDocという XSD ドキュメント コンポーネントを備えた XML ドキュメント ツールで、興味深いものです。

もちろん、他の回答で指摘されているように、XSD は単なる XML ファイルであるため、カスタム XSLT を記述して任意のドキュメント出力を生成できます。

于 2008-10-26T19:20:27.130 に答える
2

スキーマを文書化するために一般的なツールを使用したくないという可能性はかなり高いです。スキーマ文書化ツール (私は XML Spy のツールに最も精通しています) は、スキーマを読みやすくするように設計されています。あなたの説明から、それはあなたが本当に望んでいるものではないように思えます。必要なのは、スキーマ内の情報をソフトウェア ドキュメントの基礎として使用することです。

これを行う必要が生じたとき、私が採用したアプローチは、必要なドキュメントの外観に合わせて HTML を設計し、それを入力するためにスキーマ内のどの情報を取得する必要があるかを判断することでした。これをテンプレートとして使用すると、XSLT を使用してスキーマから関連情報を簡単に取得できます。

于 2008-10-27T02:36:51.193 に答える
1

Freshmeat.net で見つけたxsddocというツールを使用して、過去にドキュメントを生成しました。（直接リンクを取得するために）今調べてみると、開発者によってxnsdocというツールに取って代わられたことがわかりました。新しいものはオープンソース プロジェクトで無料で使用できますが、これを商用製品に使用する場合は、ライセンスが必要になる場合があります。「xsddoc」バナーの下でリリースされた最後のバージョンが目的に合っている場合は、それをそのまま使用できます。

それが生成するドキュメントは、Javadoc のルック アンド フィールを備えており、スタイルシートなどである程度の制御が可能です。

于 2008-10-27T04:10:14.687 に答える
1

XSLT スクリプトがその役割を果たします。

于 2008-10-26T15:00:02.117 に答える
1

Sandcastleの複雑さを詳しく調べる準備ができている場合は、優れたSandcastle Help File BuilderのプラグインであるXML Schema Documenterを強くお勧めします。

可能な出力は Sandcastle と同じです: Web サイト、HTML ヘルプ (CHM) ファイル、MS Help 2コンテンツ、MS Help Viewer 1 ...

于 2010-09-23T07:07:11.137 に答える
-3

それをdocbook形式に変換する (または事前に作成する) のはそれほど難しくありません。

于 2008-10-26T12:59:18.583 に答える