# Dopełnianie tekstu w XML

## Wprowadzenie

Wtyczka ta powoduje wyświetlanie podpowiedzi o dostępnych w danej pozycji edytowanego pliku &XML; elementach, zgodnie z określonym dla tego pliku szablonem DTD. Wyświetlana będzie lista elementów, atrybutów, wartości atrybutów lub encji, w zależności od pozycji kursora (np. wszystkie encje będą wyświetlone jeżeli znakiem na lewo od kursora jest&). Jedną z funkcji jest także zamykanie najbliższego, znajdującego się po lewej stronie kursora, otwartego znacznika.

Szablon dokumentu XML DTD musi istnieć i być określony w formacie generowanym przez polecenie Perla `dtdparse`. Szablon w tym formacie jest nazywany meta szablonem DTD. Wraz z wtyczką zainstalowane jest kilka meta szablonów DTD w katalogu: `$KDEDIR/share/apps/katexmltools/`, który jest katalogiem domyślnym przy wywoływaniu funkcji Przyporządkuj Meta DTD.... Aby stworzyć własne meta szablony DTD należy skorzystać z programu `dtdparse` dostępnego na stronach: http://dtdparse.sourceforge.net.

## Jak korzystać z wtyczki

Należy uruchomić program &kate; i otworzyć okno dialogowe konfiguracji za pomocą menu Ustawienia Konfiguracja &kate;.... Następnie należy zaznaczyć opcję Uzupełnianie składni XML znajdującą się w karcie Program/Wtyczki. Po włączeniu wtyczki i zamknięciu okna, należy wybrać z menu pozycję XML Przyporządkuj Meta DTD.... Jeżeli edytowany dokument nie posiada elementu DOCTYPE lub jeżeli jest on nieznany to należy wskazać meta szablon DTD znajdujący się na dysku. W przeciwnym wypadku zostanie automatycznie załadowany meta szablon DTD odpowiadający elementowi DOCTYPE bieżącego dokumentu.

Od tego momentu można już korzystać z wtyczki podczas edycji naciskając następujące klawisze:

< (znak mniejszości)

- Wyświetli listę dostępnych elementów (tagów). Klawisz działa tylko jeżeli kursor znajduje się poza znacznikiem. Należy zauważyć iż nie można użyć tego klawisze do wstawiania elementów najwyższego poziomu ( jak np.: <html>).

" (cudzysłów)

- Klawisz wyświetli listę dostępnych wartości atrybutów (jeżeli występują). Klawisz działa jeżeli kursor znajduje się wewnątrz znacznika.

(spacja)

- Naciśnięcie tego klawisza wyświetli listę dostępnych atrybutów dla bieżącego elementu. Klawisz działa jeżeli kursor znajduje się wewnątrz znacznika.

&

- Klawisz wywoła listę dostępnych encji.

## Możliwości i ograniczenia

Użytkownik może przetestować wszystkie funkcje i ograniczenia wtyczki wczytując plik `$KDEDIR/share/apps/katexmltools/testcases.xml` i postępując zgodnie z zawartymi tam instrukcjami. Należy zaznaczyć iż praca z kilkoma widokami tego samego dokumentu nie jest jeszcze poprawnie obsługiwana przez tą wtyczkę.

## Pozycje menu

&Ctrl;Return XML Wstaw element...

- Otwiera okno dialogowe pozwalające na wstawienie znacznika &XML;. Znaki <, > oraz znacznik zamykający będą dołączone automatycznie. Jeżeli przed wybraniem tej opcji w dokumencie był zaznaczony fragment tekstu, to zostanie on umieszczony pomiędzy znacznikiem otwierającym i zamykającym. W oknie dialogowym działa również funkcja autouzupełniania nazw znaczników oraz elementów, które można umieścić w bieżącej pozycji kursora zgodnie ze zdefiniowanym za pomocąPrzyporządkuj Meta DTD... meta szablonem DTD.

&Ctrl;< XML Zamknij element

- Spowoduje przeszukanie dokumentu w poszukiwaniu znacznika, który jeszcze nie został zamknięty i zamknięcie go poprzez wstawienie odpowiedniego znacznika zamykającego. Poszukiwanie rozpoczyna się od pozycji kursora w lewą stronę. Jeżeli żaden otwarty znacznik nie zostanie znaleziony to nic nie zostanie wstawione.

XML Przyporządkuj Meta DTD...

- Pozwala na wskazanie pliku DTD, który powinien zostać użyty dla bieżącego dokumentu. Przyporządkowanie to nie zostanie zapisane, należy je ponowić przy każdym następnym uruchomieniu &kate;.

## Podziękowania i zasługi

Wtyczka &kate; Uzupełnianie składni XML. Prawa autorskie (c) 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;.

Prawa autorskie do dokumentacji (c) 2001,2002 &Daniel.Naber;

Krzysztof Woźniak wozniakk@ceti.pl

&underGPL;