スキーマ概要ページ

このページについて

このフォーム・ページを使用して、拡張ポイント・スキーマを識別し、文書化することができます。 他の共有拡張ポイント・スキーマによって定義された文法を組み込み、使用することも可能になります。

ページ・セクション

このページは、次のセクションで構成されています。

一般情報セクション

このセクションは、編集済みの拡張ポイント・スキーマを一意的に識別します。拡張ポイント・スキーマ ID のフォーマットは、対応する拡張ポイント <plugin-id>.<point-id> の完全修飾 ID と同じです。

一般情報セクション

一般情報セクションのフィールド

「プラグイン ID」フィールドを編集して、固有拡張ポイント・スキーマ ID の 修飾子部分を指定します。このフィールドの値は、スキーマの対応する拡張ポイントが 定義されているプラグインの ID と一致しなければなりません。

「ポイント ID」フィールドを編集して、固有拡張 ポイント・スキーマ ID の ID 部分を指定します。このフィールドの値は、スキーマの対応する拡張ポイントの定義に 使用する ID と一致しなければなりません。

「ポイント名」フィールドを編集し、拡張ポイント・スキーマについて人間 が判別可能な名前を指定します。このフィールドの値は、スキーマの対応する拡張ポイントの定義に 使用する名前と一致しなければなりません。

スキーマの取り込みセクション

このセクションを使用して、他の共有拡張ポイント・スキーマの文法を組み込み、使用することができます。

スキーマの取り込みセクション

スキーマの取り込みセクションのフィールド

ビューアー・フィールドに、共有拡張ポイント・スキーマがリストされます。そのスキーマの文法は、編集済み拡張ポイント・スキーマによって取り込まれ、使用されています。

編集済み拡張ポイント・スキーマと同じプラグインに存在する共有拡張ポイント・スキーマを取り込むことができます。 これらのスキーマは、ファイル名への相対パス <relative-path>/<schema-file-name> によってビューアーで表されます。

別のワークスペース・プラグインに存在する共有拡張ポイント・スキーマを取り込むことができます。 これらのスキーマは、ファイル名への特別な絶対パス schema://<defining-plugin-id>/<path>/<schema-file-name> によってビューアーで表されます。

スキーマの取り込みセクションのアクション

「追加...」ボタンをクリックし、「ファイルの選択」ダイアログを開いて、編集済みスキーマの既存の共有拡張ポイント・スキーマから文法を取り込み、使用します。 ダイアログには、すべてのワークスペース拡張ポイント・スキーマが、フィルターを掛けて階層的に表示されます。編集済みスキーマとは別のプラグインに含まれる拡張ポイント・スキーマを選択した場合、特別な絶対パスが作成され、ビューアー・フィールドに入力されます。編集済みスキーマと同じプラグインに含まれる拡張ポイント・スキーマを選択した場合、編集済みスキーマからその選択されたスキーマへの相対パスが計算され、ビューアー・フィールドに入力されます。

「削除」ボタンをクリックして、選択した共有拡張ポイント・スキーマの文法を、編集済み拡張ポイント・スキーマが取り込み、使用している文法から削除します。 このアクションは、スキーマがビューアー・フィールドで選択されている場合にのみ使用可能です。

ビューアー・フィールドの拡張ポイント・スキーマをダブルクリックして、新規の拡張ポイント・スキーマ・エディターでそのスキーマを開きます。

文書セクション

このセクションを使用して、編集済みの拡張ポイント・スキーマを文書化できます。 コンテンツを使用して、編集済み拡張ポイント・スキーマの参照文書を作成できます。結果として、任意のセクションのフィールドで、有効な HTML マークアップを使用できるようになります。

このセクションには、以下のタブが含まれています。

文書セクション

文書セクションのフィールド

「説明」タブのフィールドを編集して、 この編集済みスキーマの定義拡張ポイントの詳細説明を指定します。 通常は、このフィールドを使用して、拡張ポイントの目的、有用性、および関連概念を記述します。

「リリース」タブのフィールドを編集して、この編集済みスキーマが最初に追加された Eclipse のバージョンを指定します。例えば、この編集済みスキーマが最初に Eclipse 3.0 に追加された場合は、フィールドの値は 3.0 でなければなりません。 編集済みスキーマの文法が、これまでに導入されたリリースに準拠した API であること、および下位互換性が維持されていることが前提です。 このフィールドは、Java の Javadoc @since タグと似ています。

「例」タブのフィールドを編集して、この編集済みスキーマの文法に準拠した拡張の有効な XML スニペットを指定します。拡張の一般的な使用状況を説明した例を使用してください。

「API 情報」 タブのフィールドを編集して、拡張ポイントの要素および属性の構造、コンテンツおよびセマンティクスを記述します。

「提供される実装」タブのフィールドを編集して、この編集済みスキーマの拡張ポイントを定義しているプラグインが拡張もコントリビュートするかどうかを指定します。このフィールドは、ユーザーに実際の拡張実装を示し、ユーザーはこれをテンプレートまたは参照として使用し、独自の拡張を定義できます。

「著作権」タブのフィールドを編集し、編集済みスキーマを複製、公開、販売、または配布するための排他的な法的権利の概要を記述できます。

関連リンク