Strona Przegląd schematu

Informacje o tej stronie

Ta strona formularza umożliwia identyfikowanie i dokumentowanie schematu punktów rozszerzeń. Umożliwia również włączanie i wykorzystywanie gramatyk zdefiniowanych przez inne współużytkowane schematy punktów rozszerzeń.

Sekcje strony

Ta strona składa się z następujących sekcji:

Sekcja Informacje ogólne

W tej sekcji jest jednoznacznie zidentyfikowany edytowany schemat punktów rozszerzeń. Format identyfikatora schematu punktów rozszerzeń jest taki sam, jak pełny identyfikator odpowiedniego punktu rozszerzenia: <identyfikator wtyczki>.<identyfikator punktu>

Sekcja Informacje ogólne

Pola sekcji Informacje ogólne

W polu Identyfikator wtyczki można określić część kwalifikatora unikalnego identyfikatora schematu punktów rozszerzeń. Wartość tego pola powinna pasować do identyfikatora wtyczki, w której jest zdefiniowany odpowiedni punkt rozszerzenia schematu.

W polu Identyfikator punktu można określić część unikalnego identyfikatora schematu punktów rozszerzeń. Wartość tego pola powinna pasować do identyfikatora użytego do zdefiniowania odpowiedniego punktu rozszerzenia schematu.

W polu Nazwa punktu można określić czytelną dla człowieka nazwę schematu punktów rozszerzeń. Wartość tego pola powinna pasować do nazwy użytej do zdefiniowania odpowiedniego punktu rozszerzenia schematu.

Sekcja Włączenia schematu

Ta sekcja umożliwia włączanie i wykorzystywanie gramatyki z innych współużytkowanych schematów punktów rozszerzeń.

Sekcja Włączenia schematu

Pola sekcji Włączenia schematu

W polu przeglądarki znajduje się lista współużytkowanych schematów punktów rozszerzeń, których gramatyki są włączane i wykorzystywane przez edytowany schemat punktów rozszerzeń.

Włączać można współużytkowane schematy punktów rozszerzeń znajdujące się w tej samej wtyczce, co edytowany schemat punktów rozszerzeń. Schematy te są reprezentowane w przeglądarce przez ścieżkę względną do ich nazwy pliku: <ścieżka względna>/<nazwa pliku schematu>

Włączać można współużytkowane schematy punktów rozszerzeń znajdujące się w innej wtyczce obszaru roboczego. Schematy te są reprezentowane w przeglądarce przez specjalną pełną ścieżkę do ich nazwy pliku: schema://<identyfikator wtyczki definiującej>/<ścieżka>/<nazwa pliku schematu>

Działania w sekcji Włączenia schematu

Kliknij przycisk Dodaj, aby otworzyć okno dialogowe Wybór pliku i w edytowanym schemacie włączyć oraz wykorzystać gramatykę z istniejącego współużytkowanego schematu punktów rozszerzeń. W oknie dialogowym wyświetlany jest przefiltrowany hierarchiczny widok wszystkich schematów punktów rozszerzeń w obszarze roboczym. Jeśli zostanie wybrany schemat punktów rozszerzeń znajdujący się w innej wtyczce niż schemat edytowany, w polu przeglądarki zostanie skonstruowana i wprowadzona specjalna pełna ścieżka. Jeśli zostanie wybrany schemat punktów rozszerzeń znajdujący się w tej samej wtyczce co schemat edytowany, zostanie obliczona i wprowadzona w polu przeglądarki ścieżka względna ze schematu edytowanego do wybranego.

Kliknij przycisk Usuń, aby usunąć gramatykę wybranego schematu punktów rozszerzeń z włączenia i wykorzystania przez edytowany schemat punktów rozszerzeń. To działanie jest dostępne tylko wtedy, gdy w polu przeglądarki jest zaznaczony schemat.

Kliknij dwukrotnie schemat punktów rozszerzeń w polu przeglądarki, aby otworzyć ten schemat w nowym Edytorze schematów punktów rozszerzeń.

Sekcja Dokumentacja

Ta sekcja umożliwia udokumentowanie edytowanego schematu punktów rozszerzeń. Na podstawie jego zawartości składany jest dokument referencyjny edytowanego schematu punktów rozszerzeń. Wskutek tego we wszystkich polach sekcji można używać poprawnego języka znaczników HTML.

Ta sekcja zawiera następujące karty:

Sekcja Dokumentacja

Pola sekcji Dokumentacja

W polu na karcie Opis można określić szczegółowy opis definiującego punktu rozszerzenia dla tego edytowanego schematu. Zazwyczaj w polu tym opisuje się przeznaczenie punktu rozszerzenia, program narzędziowy i powiązane pojęcia.

W polu na karcie Od można określić, do której wersji Eclipse ten edytowany schemat został dodany po raz pierwszy. Jeśli na przykład edytowany schemat został po raz pierwszy dodany do Eclipse 3.0, wartość w polu powinna wynosić 3.0. Przyjmuje się założenie, że gramatyka edytowanego schematu jest interfejsem API, który po wprowadzeniu do użycia jest trwały z wersji na wersję oraz jest utrzymywana jego wsteczna zgodność. Pole to ma podobne znaczenie, jak znacznik @since w dokumentacji Javadoc języka Java.

W polu na karcie Przykłady można określić prawidłowy fragment kodu XML rozszerzenia, który jest zgodny z gramatyką edytowanego schematu. Spróbuj użyć przykładu, który ilustruje typowy przypadek użycia rozszerzenia.

W polu na karcie Informacje o interfejsie API można opisać strukturę, treść i semantykę elementów i atrybutów punktu rozszerzenia.

W polu na karcie Dostarczone implementacje można określić, czy wtyczka, która definiuje punkt rozszerzenia dla tego edytowanego schematu, wnosi również dla niego rozszerzenia. To pole wskazuje rzeczywistą implementację rozszerzenia, której użytkownik może użyć jako szablonu lub odwołania, definiując własne rozszerzenia.

W polu na karcie Prawa autorskie można zaznaczyć wyłączne prawa do reprodukowania, publikowania, sprzedaży lub dystrybuowania edytowanego schematu.

Przydatne odsyłacze