# Dopełnianie tekstu w XML

Daniel
Naber

    &Daniel.Naber.mail;

2006-05-17
3.5.2

Wtyczka ta wspomaga tworzenie plików XML poprzez wyświetlanie dopuszczalnych tagów. Zawiera również inne narzędzia.

KDE
kate
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;