Edytor plików definicyjnych języków znacznikowych

Aby uzyskać dostęp do edytora plików definicyjnych (nazywanym w skrócie edytorem TDF - od ang. TagDefinition) użyj polecenia Edytor plików definicyjnych TDF (ikona polecenia jest pokazana wyżej), które znajduje się w Menu Wyświetl / Ogólne ustawienia programu. Możesz również uruchomić go za pomocą przycisku znajdującego się w oknie Ustawienia programu w kategorii Ułatwienia, dynamiczne atrybuty, inne lub w menu. Przycisk pokazany został powyżej.

Za pomocą edytora TDF możesz modyfikować lub rozszerzać listę znaczników w językach obsługiwanych przez Pająka z poziomu narzędzi dynamicznej pomocy (podpowiedzi dla znacznika, znaczników i ich atrybutów itp), a nawet (czy może przede wszystkim) tworzyć całkiem nowe definicje języków do tej pory nieobsługiwanych przez program. Dzięki temu Pająk jest niesamowicie elastycznym narzędziem, znacząco ułatwiającym tworzenie dokumentów w praktycznie dowolnym języku znacznikowym (nawet w języku nieznanym twórcom programu) przy zachowaniu działających mechanizmach podpowiedzi i automatycznego uzupełniania kodu.

Tworzenie od podstaw pliku definicyjnego dla języka znacznikowego jest jednak zajęciem bardzo żmudnym i czasochłonnym. Dlatego Pająk został wyposażony w unikalny mechanizm importowania danych języka z jego DTD. Wystarczy plik DTD zaimportować za pomocą opisanych niżej poleceń, a plik TDF zostanie automatycznie utworzony.

Okno edytora TDF składa się z dwóch głównych obszarów, tj. listy obsługiwanych języków znacznikowych (wraz z przyciskami umożliwiającymi jej obsługę) oraz obszaru z zakładkami, gdzie definiuje się ustawienia znaczników wybranego języka.

Kategorie znaczników

W tym miejscu możesz zarządzać listą języków znacznikowych, jakie obsługuje Pająk, dodawać je i usuwać,a także wybierać bieżący język.

Kategorie
Wybierz z listy kategorię (język znacznikowy), aby móc modyfikować definicję jego znaczników. Za pomocą przycisków obok możesz dodać, usunąć bądź zmienić nazwę kategorii.

Właściwości
Kliknij ten przycisk, by otworzyć okno Właściwości kategorii znaczników, w którym będzie można edytować takie ustawienia, jak ścieżkę do dokumentacji, czy opis języka,

Importuj
Pod tym przyciskiem kryją się dwa polecenia:

Importuj plik DTD - pod tym przyciskiem kryje się potężne narzędzie umożliwiając automatyczne zaimportowanie znaczników dowolnego języka z jego DTD. Jego obsługa sprowadza się do wskazania pliku DTD przeznaczonego do zaimportowania.
Importuj plik TDF - to polecenie umożliwia zaimportowanie utworzonego wcześniej własnego pliku TDF (np. z archiwum, czy wersji Pająka wcześniejszych od 5.3.0)

Uwaga
Jeśli tworzyłeś w Pająku w wersji wcześniejszej niż 5.3.0 własne pliki TDF, musisz jest zaimportowac za pomoca wymienionego wyżej polecenia Importuj plik TDF!

Znaczniki

Znaczniki w wybranej kategorii
Wybierz znacznik, aby móc modyfikować jego definicję. Za pomocą przycisków umieszczonych poniżej możesz zarządzać listą znaczników tj. dodawać nowe, usuwać czy zmieniać nazwy, a także ustawić jeden ze znaczników jako znacznik nadrzędny dokumentu. Znacznik nadrzędny dokumentu ma znaczenie podczas rozpoznawania języka w którym jest tworzony dokument (czytaj więcej na ten temat w opisie przełącznika Rozpoznaj kategorię znaczników na podstawie znacznika nadrzędnego dokumentu w pomocy do okna Właściwości kategorii znaczników).

Grupa zakładek znajdująca się po prawej stronie okna pozwala na określanie parametrów dla znacznika wybranego na liście. Po wybraniu znacznika możesz określić jego parametry w zakładkach:

Podstawowe dane znacznika

Ta zakładka pozwala na określenie ogólnych ustawień znacznika nie związanych z jego atrybutami i obsługiwanymi zdarzeniami dla języków skryptowych. Masz tutaj dostęp do następujących pól:

Nazwa znacznika
Nazwę możesz zmienić korzystając z przycisku umieszczonego obok pola z nazwą.

Bez zawartości
Określa, czy znacznik może zawierać jakąś treść. Przykładami znaczników w XHTML bez zawartości są <img />, <br />, które nie posiadają odpowiedniego znacznika zamykającego.

Zamknięcie nie wymagane
Określa czy zamknięcie znacznika jest wymagane. Opcja ta nie dotyczy znaczników języków XML'owych.

Opis znacznika
Opis wyświetlany jest np. w podpowiedziach do znaczników.

Status znacznika
Określa status znacznika, np. czy jest specyficzny dla jakiejś przeglądarki, czy może już zaniechany (deprecated).

Autouzupełnianie
To jest definicja reguły automatycznego uzupełniania. Znak | oznacza pozycję, w której ma być ustawiony kursor po uzupełnieniu znacznika.

Plik dokumentacji
Nazwa pliku z dokumentacją dla bieżącego znacznika. Ważne jest by oprócz nazwy tego pliku, prawidłowo określić nazwę katalogu z dokumentacją dla bieżącej kategorii w oknie Właściwości kategorii znaczników. Dokumentacja ta jest będzie wyświetlana na dolnym panelu pomocy po użyciu polecenia Wyświetl pomoc dla bieżącego znacznika (np. w menu podręcznym edytora, standardowy skrót to Ctrl+F1).

Znaczniki zawierające się:
Określa listę znaczników, które mogą być umieszczone wewnątrz modyfikowanego znacznika. Na przykład wewnątrz znacznika <UL> może być tylko znacznik <LI>. Symbol * oznacza dowolny znacznik.

Podgląd
Określa tekst podglądu, który jest używany w inspektorze znaczników podczas modyfikacji znacznika.

Podgląd (CSS)
Określa tekst podglądu, który jest używany w inspektorze stylów CSS podczas modyfikacji stylu dla znacznika.

Zgodność
Zaznacz ten przełącznik, aby określić zgodność bieżącego znacznika z przeglądarkami. Następnie kliknij przycisk obok, aby otworzyć okno Zgodność z przeglądarkami. Informacja ta wyświetli się np. w podpowiedziach do znaczników.

W celu zaakceptowania zmian koniecznie kliknij przycisk zapisz oznaczony pokazaną obok ikoną dyskietki. Dopiero wtedy zostaną one zapisane do pliku. W przypadku próby przełączenia się do innej zakładki, bądź wyłączenia edytora TDF program również spyta czy chcesz zachować zmiany.

Atrybuty znacznika

Na tej zakładce ustala się jakie atrybuty są dostępne dla wybranego znacznika oraz jakimi cechami się charakteryzują. Nowe atrybuty dodajesz za pomocą przycisku oznaczonego plusikiem. Po dodaniu atrybut dopisywany jest do listy i możliwe jest ustalenie jego parametrów w polach poniżej:

Nazwa atrybutu
Aby ją zmienić kliknij w przycisk obok pola.

Opis atrybutu
Opis wyświetlany jest np. w podpowiedziach do atrybutów.

Status atrybutu znacznika
Określa status atrybutu, np. czy jest specyficzny dla jakiejś przeglądarki, czy może już zaniechany (deprecated).

Ten atrybut jest wymagany
Niektóre znaczniki wymagają pewnych atrybutów. Tutaj możesz zaznaczyć, że atrybut, który modyfikujesz jest właśnie takim wymaganym atrybutem modyfikowanego znacznika.

Typ atrybutu
Określa typ atrybutu, który powoduje, że dla danego atrybutu używany jest taki, a nie inny edytor własności w inspektorze znaczników.

Wartości
Określa listę wartości dla modyfikowanego atrybutu znacznika. Wartości te są wyświetlane w inspektorze znaczników oraz w funkcji dynamicznych atrybutów. Jeśli atrybut może posiadać wiele wartości oddzielonych za pomocą separatora, zaznacz przełącznik Dopuszczaj wartości wielokrotne, a następnie wprowadź Separator (najczęściej jest to średnik, przecinek, bądź spacja).

Zgodność
Zaznacz ten przełącznik, aby określić zgodność bieżącego atrybutu z przeglądarkami. Następnie kliknij przycisk obok, aby otworzyć okno Zgodność z przeglądarkami. Informacja ta wyświetli się np. w podpowiedziach do znaczników.

Zdarzenia znacznika

Na tej zakładce ustala się jakie zdarzenia dla języków skryptowych są dostępne dla wybranego znacznika (na przykład onClick, czy onFocus itd.). Do dodawania i usuwania zdarzeń służą przycisku umieszczone obok listy. Dostępne są następujące ustawienia dla zdarzenia:

Nazwa zdarzenia
Możesz ją zmienić klikając na przycisk obok pola.

Opis zdarzenia
Pokaże się w podpowiedzi dla znacznika.

Status zdarzenia
Określa, czy zdarzenie jest opisane w specyfikacji języka, czy tez jest rozszerzeniem którejś z przeglądarek.

Rodzaj zdarzenia
Określa "skąd pochodzi" zdarzenie (np. od kliknięcia przyciskim myszy, czy wciśnięcia klawisza na klawiaturze).

Pokrewne tematy

Do góry