blob: 219cb82d22372a2d715b3d15dd9b01f697c12791 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
<chapter id="xmlcheck">
<chapterinfo>
<title
>Sprawdzanie poprawności XML-a</title>
<authorgroup>
<author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
>&Daniel.Naber.mail;</address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Krzysztof</firstname
><surname
>Woźniak</surname
><affiliation
><address
><email
>wozniakk@ceti.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
>
</authorgroup>
<date
>2006-05-17</date
> <releaseinfo
>3.5.2</releaseinfo
> <abstract
> <para
>Ta wtyczka sprawdza poprawność składni edytowanych plików XML.</para>
</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>xml</keyword>
<keyword
>DTD</keyword>
</keywordset>
</chapterinfo>
<title
>Wprowadzanie</title>
<para
>Wtyczka sprawdza poprawność bieżącego dokumentu. Lista ostrzeżeń i błędów pojawi się dolnej części głównego okna &kate;. Kliknięcie na wybrany komunikat błędu spowoduje przeskok do odpowiadającej mu linii dokumentu. Jeżeli dany plik posiada zdefiniowany parametr <quote
>DOCTYPE</quote
> to do sprawdzania poprawności będzie użyty odpowiadający mu plik szablonu DTD. Poszukiwanie pliku DTD jest przeprowadzane względem katalogu w którym znajduje się bieżący dokument. Jeżeli np. szablon odnosi się do rodzaju dokumentu XML: <quote
>DTD/xhtml1-transitional.dtd</quote
> a edytowanym plikiem jest <filename
>/home/peter/test.xml</filename
> to szablon DTD powinien być umieszczony w katalogu <filename
>/home/peter/DTD/xhtml1-transitional.dtd</filename
>. Obsługiwane są również zdalne szablony DTD, do którym można się odwoływać poprzez http.</para>
<para
>Jeżeli dla danego pliku nie znaleziono definicji składni 'doctype' to będzie on sprawdzany jedynie pod kątem formalnym.</para>
<para
>Więcej informacji na temat &XML; znajduje się na <ulink url="http://www.w3.org/XML/"
> oficjalnych stronach W3C &XML;</ulink
>.</para>
<para
>Wtyczka wykorzystuje polecenie <command
>xmllint</command
>, będące częścią pakietu libxml2. Jeżeli polecenie to nie jest poprawnie zainstalowane w systemie to wtyczka nie będzie działać.</para>
<note
><para
>Program w czasie działania tworzy plik tymczasowy w tym samym katalogu co plik dokumentu. Konieczne jest więc zapewnienie odpowiednich uprawnień zapisu w tym katalogu.</para
></note>
<para
>Włączenie wtyczki odbywa się w oknie konfiguracyjnym &kate; wywoływanym przez menu <menuchoice
><guimenu
>Ustawienia</guimenu
> <guimenuitem
>Konfiguracja &kate;...</guimenuitem
></menuchoice
>. Należy wybrać pozycję <guilabel
>Sprawdzanie poprawności XML-a</guilabel
> znajdującą się w karcie <guilabel
>Program</guilabel
>/<guilabel
>Wtyczki</guilabel
>. </para>
<sect1 id="xmlcheck-menu">
<title
>Pozycje menu</title>
<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Waliduj XML</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Polecenie to uruchomi opisywaną wcześniej procedurę sprawdzania dokumentu.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="xmlcheck-thanks-and-acknowledgements">
<title
>Podziękowania i zasługi</title>
<para
>Wtyczka &kate; <quote
>Sprawdzanie poprawności XML'a</quote
>. Prawa autorskie (c) 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Prawa autorskie do dokumentacji (c) 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:
-->
|
