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
|
<chapter id="xmltools">
<chapterinfo>
<title>&XML;-komplettering</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>Dette plugin understøtter at skrive &XML;-filer ved at give en liste af tilladte mærker og mere.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>kate</keyword>
<keyword>xml</keyword>
</keywordset>
</chapterinfo>
<title>Indledning</title>
<para>Dette plugin giver vink om hvad der er tilladt på et bestemt sted i en &XML;-fil, ifølge filens DTD. Det vil give en liste af mulige elementer, attributter, attribut-værdier eller entiteter, afhængig af markørens aktuelle position (⪚ er alle entiteter på en liste hvis tegnet til venstre for markøren er <quote>&</quote>). Det er også muligt at lukke det nærmeste åbne mærke til venstre.</para>
<para><acronym>DTD</acronym>'en skal findes i &XML;-format, som produceret af Perl-programmet <command>dtdparse</command>. Vi vil kalde en DTD i dette en <quote>meta-DTD</quote>. Nogle meta-DTD'er medfølger. De er installerede i <filename class="directory">$TDEDIR/share/apps/katexmltools/</filename>, som også er standardmappen når du vælger <guimenuitem>Tilknyt Meta-DTD...</guimenuitem>. For at producere dine egne meta-DTD'er, skal du have <command>dtdparse</command> fra <ulink url="http://dtdparse.sourceforge.net">http://dtdparse.sourceforge.net</ulink>.</para>
<sect1 id="xmltools-how-to-use">
<title>Hvordan bruges det</title>
<para>Start &kate; og åbn indstillingsdialogen med <menuchoice><guimenu>Opsætning</guimenu> <guimenuitem>Indstil &kate;...</guimenuitem></menuchoice>. Markér derefter <guilabel>Kate XML-komplettering</guilabel>, som vises i afsnittet <guilabel>Program</guilabel> <guilabel>Plugin</guilabel>. Vælg derefter <menuchoice><guimenu>XML</guimenu> <guimenuitem>Tilknyt meta-DTD...</guimenuitem></menuchoice>. Hvis dokumentet ikke indeholder en <quote>doctype</quote> eller en ukendt doctype, skal du vælge en meta-DTD i filsystemet. Ellers så indlæses den meta-DTD som hører sammen med det nuværende dokuments doctype automatisk.</para>
<para>Du kan nu bruge dette plugin mens du skriver din tekst:</para>
<variablelist>
<varlistentry>
<term>< (mindre end-tasten) </term>
<listitem><para>Dette vil udløse en liste af mulige elementer, med mindre markøren allerede er indeni et mærke. Bemærk at du ikke for øjeblikket kan bruge dette til at indsætte topniveau-elementet (f.eks. <quote><html></quote>).</para></listitem>
</varlistentry>
<varlistentry>
<term>" (citationstegn-tast)</term>
<listitem><para>Citationstasten vil udløse en liste af mulige attributværdier (hvis der er nogen) hvis du er indeni et mærke.</para></listitem>
</varlistentry>
<varlistentry>
<term>(mellemrumstast)</term>
<listitem><para>Denne tast vil udløse en liste af mulige attributter for det aktuelle element hvis du er indeni et mærke.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>& (ét-tasten)</term>
<listitem><para>Denne tast vil udløse en liste af navngivne entiteter.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="xmltools-features-and-limitations">
<title>Egenskaber og begrænsninger</title>
<para>Du kan teste alle funktioner og begrænsninger ved at indlæse <filename>$TDEDIR/share/apps/katexmltools/testcases.xml</filename> i &kate; og følge instruktionerne. Bemærk at arbejde med mere end en visning pr dokument endnu ikke er understøttet rigtigt af dette plugin. </para>
</sect1>
<sect1 id="xmltools-menu">
<title>Menustruktur</title>
<variablelist>
<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Retur</keycap> </keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Indsæt element...</guimenuitem> </menuchoice>
</term>
<listitem><para>Dette vil åbne en dialog der lader indsætte et &XML;-element. <-, >-tegnene og afslutningsmærket vil blive indsat automatisk. Hvis du har markeret tekst når dette menupunkt er valgt, vil den markerede tekst blive omgivet af åbnings- og afslutningsmærket. Dialogen tilbyder også komplettering af alle elementer der kan indsættes ved den aktuelle markørposition hvis du har tilknyttet en meta-DTD ved brug af <guimenuitem>Tilknyt Meta-DTD...</guimenuitem>. </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap><</keycap></keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Afslut element</guimenuitem> </menuchoice>
</term>
<listitem><para>Dette vil gennemsøge din tekst for et mærke, der endnu ikke er lukket og vil lukke det ved at indsætte det tilsvarende lukke-mærke. Søgningen starter ved markørens position og går til venstre. Hvis den ikke kan finde et åbent mærke så vil ingenting ske.</para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>XML</guimenu> <guimenuitem>Tilknyt meta-DTD...</guimenuitem> </menuchoice>
</term>
<listitem><para>Dette vil fortælle dette plugin hvilket meta-DTD der skal bruges for det aktuelle dokumenter. Bemærk at denne tilknytning ikke vil blive gemt. Du vil skulle gentage det når du starter &kate; næste gang.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="xmltools-thanks-and-acknowledgements">
<title>Tak og anerkendelser</title>
<para>&kate;-plugin <quote>XML-Komplettering</quote> ophavsret 2001,2002 ved &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para>Dokumentation ophavsret 2001,2002 &Daniel.Naber; </para>
&erik.kjaer.pedersen.credit;
&underGPL; </sect1>
</chapter>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
|
