diff options
Diffstat (limited to 'tde-i18n-pl/docs/tdeaddons/kate-plugins/xmltools.docbook')
| -rw-r--r-- | tde-i18n-pl/docs/tdeaddons/kate-plugins/xmltools.docbook | 209 |
1 files changed, 40 insertions, 169 deletions
diff --git a/tde-i18n-pl/docs/tdeaddons/kate-plugins/xmltools.docbook b/tde-i18n-pl/docs/tdeaddons/kate-plugins/xmltools.docbook index 8c7490143a8..b141992c34b 100644 --- a/tde-i18n-pl/docs/tdeaddons/kate-plugins/xmltools.docbook +++ b/tde-i18n-pl/docs/tdeaddons/kate-plugins/xmltools.docbook @@ -1,234 +1,105 @@ <chapter id="xmltools"> <chapterinfo> -<title ->Dopełnianie tekstu w XML</title> +<title>Dopełnianie tekstu w XML</title> <authorgroup> -<author -><firstname ->Daniel</firstname -> <surname ->Naber</surname -> <affiliation -> <address ->&Daniel.Naber.mail;</address> +<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> +</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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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 -> +<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> |