You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
243 lines
6.7 KiB
243 lines
6.7 KiB
<chapter id="xmltools">
|
|
<chapterinfo>
|
|
|
|
<title
|
|
>Dopełnianie tekstu w XML</title>
|
|
|
|
<authorgroup>
|
|
<author
|
|
><firstname
|
|
>Daniel</firstname
|
|
> <surname
|
|
>Naber</surname
|
|
> <affiliation
|
|
> <address
|
|
>&Daniel.Naber.mail;</address>
|
|
</affiliation>
|
|
</author>
|
|
</authorgroup
|
|
> <date
|
|
>2006-05-17</date
|
|
> <releaseinfo
|
|
>3.5.2</releaseinfo
|
|
> <abstract
|
|
> <para
|
|
>Wtyczka ta wspomaga tworzenie plików XML poprzez wyświetlanie dopuszczalnych tagów. Zawiera również inne narzędzia.</para>
|
|
|
|
</abstract>
|
|
<keywordset>
|
|
<keyword
|
|
>KDE</keyword>
|
|
<keyword
|
|
>kate</keyword>
|
|
<keyword
|
|
>xml</keyword>
|
|
</keywordset>
|
|
</chapterinfo>
|
|
|
|
<title
|
|
>Wprowadzenie</title>
|
|
|
|
<para
|
|
>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<quote
|
|
>&</quote
|
|
>). Jedną z funkcji jest także zamykanie najbliższego, znajdującego się po lewej stronie kursora, otwartego znacznika.</para>
|
|
|
|
<para
|
|
>Szablon dokumentu XML <acronym
|
|
>DTD</acronym
|
|
> musi istnieć i być określony w formacie generowanym przez polecenie Perla <command
|
|
>dtdparse</command
|
|
>. Szablon w tym formacie jest nazywany <quote
|
|
>meta szablonem DTD</quote
|
|
>. Wraz z wtyczką zainstalowane jest kilka meta szablonów DTD w katalogu: <filename class="directory"
|
|
>$TDEDIR/share/apps/katexmltools/</filename
|
|
>, który jest katalogiem domyślnym przy wywoływaniu funkcji <guimenuitem
|
|
>Przyporządkuj Meta DTD...</guimenuitem
|
|
>. Aby stworzyć własne meta szablony DTD należy skorzystać z programu <command
|
|
>dtdparse</command
|
|
> dostępnego na stronach: <ulink url="http://dtdparse.sourceforge.net"
|
|
>http://dtdparse.sourceforge.net</ulink
|
|
>.</para>
|
|
|
|
<sect1 id="xmltools-how-to-use">
|
|
<title
|
|
>Jak korzystać z wtyczki</title>
|
|
|
|
<para
|
|
>Należy uruchomić program &kate; i otworzyć okno dialogowe konfiguracji za pomocą menu <menuchoice
|
|
><guimenu
|
|
>Ustawienia</guimenu
|
|
> <guimenuitem
|
|
>Konfiguracja &kate;...</guimenuitem
|
|
></menuchoice
|
|
>. Następnie należy zaznaczyć opcję <guilabel
|
|
>Uzupełnianie składni XML </guilabel
|
|
> znajdującą się w karcie <guilabel
|
|
>Program</guilabel
|
|
>/<guilabel
|
|
>Wtyczki</guilabel
|
|
>. Po włączeniu wtyczki i zamknięciu okna, należy wybrać z menu pozycję <menuchoice
|
|
><guimenu
|
|
>XML</guimenu
|
|
><guimenuitem
|
|
>Przyporządkuj Meta DTD...</guimenuitem
|
|
></menuchoice
|
|
>. Jeżeli edytowany dokument nie posiada elementu <quote
|
|
>DOCTYPE</quote
|
|
> 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.</para>
|
|
|
|
<para
|
|
>Od tego momentu można już korzystać z wtyczki podczas edycji naciskając następujące klawisze:</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term
|
|
>< (znak mniejszości)</term>
|
|
<listitem
|
|
><para
|
|
>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.: <quote
|
|
><html></quote
|
|
>).</para
|
|
></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
>" (cudzysłów)</term>
|
|
<listitem
|
|
><para
|
|
>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.</para
|
|
></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
>(spacja)</term>
|
|
<listitem
|
|
><para
|
|
>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term
|
|
>&</term>
|
|
<listitem
|
|
><para
|
|
>Klawisz wywoła listę dostępnych encji.</para
|
|
></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="xmltools-features-and-limitations">
|
|
<title
|
|
>Możliwości i ograniczenia</title>
|
|
|
|
<para
|
|
>Użytkownik może przetestować wszystkie funkcje i ograniczenia wtyczki wczytując plik <filename
|
|
>$TDEDIR/share/apps/katexmltools/testcases.xml</filename
|
|
> 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ę.</para>
|
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="xmltools-menu">
|
|
<title
|
|
>Pozycje menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice
|
|
><shortcut
|
|
> <keycombo action="simul"
|
|
>&Ctrl;<keycap
|
|
>Return</keycap
|
|
></keycombo
|
|
> </shortcut
|
|
> <guimenu
|
|
>XML</guimenu
|
|
> <guimenuitem
|
|
>Wstaw element...</guimenuitem
|
|
> </menuchoice>
|
|
</term>
|
|
<listitem
|
|
><para
|
|
>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ą<guimenuitem
|
|
>Przyporządkuj Meta DTD...</guimenuitem
|
|
> meta szablonem DTD. </para
|
|
></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice
|
|
><shortcut
|
|
> <keycombo action="simul"
|
|
>&Ctrl;<keycap
|
|
><</keycap
|
|
></keycombo
|
|
> </shortcut
|
|
> <guimenu
|
|
>XML</guimenu
|
|
> <guimenuitem
|
|
>Zamknij element</guimenuitem
|
|
> </menuchoice>
|
|
</term>
|
|
<listitem
|
|
><para
|
|
>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.</para
|
|
></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice
|
|
><guimenu
|
|
>XML</guimenu
|
|
> <guimenuitem
|
|
>Przyporządkuj Meta DTD...</guimenuitem
|
|
> </menuchoice>
|
|
</term>
|
|
<listitem
|
|
><para
|
|
>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;.</para
|
|
></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="xmltools-thanks-and-acknowledgements">
|
|
<title
|
|
>Podziękowania i zasługi</title>
|
|
|
|
<para
|
|
>Wtyczka &kate; <quote
|
|
>Uzupełnianie składni XML</quote
|
|
>. Prawa autorskie (c) 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
|
|
|
|
<para
|
|
>Prawa autorskie do dokumentacji (c) 2001,2002 &Daniel.Naber; </para>
|
|
|
|
<para
|
|
>Krzysztof Woźniak <email
|
|
>wozniakk@ceti.pl</email
|
|
></para
|
|
>
|
|
&underGPL; </sect1>
|
|
</chapter>
|
|
|
|
<!--
|
|
Local Variables:
|
|
mode: sgml
|
|
sgml-omittag: nil
|
|
sgml-shorttag: t
|
|
End:
|
|
-->
|
|
|