summaryrefslogtreecommitdiffstats
path: root/tde-i18n-da/docs/kdenetwork/kopete/chatstyle.docbook
blob: d59dddf24eda3cde6c8df56ef022d11c1f4631e7 (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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
<!-- Copyright (c) 2005 by Michaël Larouche <michael.larouche@kdemail.net
> -->
<!-- Licensed under the GNU Free Documentation License  -->

<appendix id="chatwindowstyleguide">
<title
>Stilguide for chatvindue i &kopete;</title>
<sect1 id="chatstyle-reference">
<title
>Stilreference for chatvindue i &kopete;</title>
<para
>Fra og med &kopete; 0.12, bruger vi nu formatet <ulink url="http://www.adiumx.com/"
>Adium</ulink
> til chatvinduestil. Temaformatet er baseret på <acronym
>HTML</acronym
>-skabeloner og <acronym
>CSS</acronym
>. De er enklere at oprette og udvikle, kun kunskab om <acronym
>HTML</acronym
> og <acronym
>CSS</acronym
> behøves. Desuden kan stiler have varianter (definerede med en <acronym
>CSS</acronym
>-fil), som tilføjer flere egenindstillede værdier). </para>

<sect2 id="chatstyle-reference-guide">
	<title
>Reference guide.</title>
<para
>Adium-formatet består af en mappestruktur, <acronym
>HTML</acronym
>-skabeloner, <acronym
>CSS</acronym
>-filer og nøgleord som erstattes hver gang skabelonen behandles. Den endelige konvertering er en <acronym
>XHTML</acronym
>-side hvor meddelelser tilføjes med <acronym
>DOM</acronym
>-handlinger. Det centrale element er et div-element som hedder <filename
>Chat</filename
>. Før og efter dette div-element findes skabeloner for sidehoved og sidefod. Meddelelser findes under div-elementet <filename
>Chat</filename
>. </para>

<sect3 id="chatstyle-refrerence-directory">
	<title
>Mappestruktur</title>
<para
>En stil skal holde sig til denne mappestruktur. Koden i &kopete; styres af denne mappestruktur. Når stilen arkiveres, arkivér så mappen <filename
>styleName</filename
>. Mappestrukturen er en struktur ifølge med en bundle i <application
>Mac OS X</application
>, for dem som kender til det operativsystem. Du skal desuden følge versaltilstanden som vises her, eftersom <acronym
>Unix</acronym
>-systemer er versalfølsome.</para>
<programlisting
>styleName\ (kan have .adiumMessageStyle som suffix, eftersom det er en bundle i Mac OS X)
        Contents\
                Info.plist
                Resources\
                        main.css
                        Header.html
                        Footer.html
                        Status.html
                        Incoming\ (och Outgoing\)
                                Content.html
                                NextContent.html (for efterfølgende meddelelsen)
                                Contekst.html (for meddelelsehistorik)
                                NextContekst.html
                                Action.html
                        Variants\
                                *.css
</programlisting>
</sect3>

<sect3 id="chatstyle-reference-divinsert">
	<title
>Om &lt;div id="insert"&gt;&lt;/div&gt;</title>
	<para
>Dette er et særligt div-element som bruges internt. Det er en pladsmarkør som angiver hvor næste meddelelse skal indsættes. Hvis det er en ny meddelelse, fjernes det og den nye meddelelse tager dens plads. Men hvis det er en efterfølgende meddelelse erstattes div-elementet med den nye meddelelses indhold. Dette særlige div-element <emphasis
>kræves</emphasis
> i skabelonerne Content, Context, NextContent, NextContext. Det skader dog ikke også at tilføje det i skabelonerne Action og Status. </para>
</sect3>

<sect3 id="chatstyle-reference-templates">
	<title
>HTML-skabeloner.</title>

<variablelist
><title
>Skabelonbeskrivelse.</title>

<varlistentry
><term
><filename
>Header.html</filename
> (kræves)</term>
<listitem>
<para
>Brug skabelonen Header til at vise et pænt sidehoved for konversationen. Denne skabelon indsættes inden div-elementet <filename
>Chat</filename
>. Hvis du ikke bruger det, så brug blot en tom fil. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Footer.html</filename
> (kræves)</term>
<listitem>
<para
>Dette er i hovedsagen det samme som Header, men er for konversationens sidefod. Denne skabelon indsættes efter div-elementet <filename
>Chat</filename
>. Hvis du ikke bruger det, bruges blot en tom fil. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Status.html</filename
> (kræves)</term>
<listitem>
<para
>Denne skabelon bruges til at vise en intern meddelelse. Interne meddelelser såsom statusændringer, meddelelser fra Kopete (f.eks. indkommende filoverførsel) vises. Når stilen ikke sørger for skabelonen Action, bruges den til at vise sådanne meddelelser. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Incoming/Content.html</filename
></term>
              <term
><filename
>Outgoing/Content.html</filename
> (kræves)</term>
<listitem>
<para
>Indholdsskabelonen er meddelelsens kerne. Forestil dig det som en blok som vil indeholde meddelelser. Sørg for at det er parat til at tage imod de efterfølgende meddelelser, konstruér den ikke til kun at vis en meddelelse. Efterfølgende meddelelser indsættes ved div-elementet. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Incoming/NextContent.html</filename
></term>
              <term
><filename
>Outgoing/NextContent.html</filename
> (kræves)</term>
<listitem>
<para
>Skabelonen NextContent er meddelelsefragment for efterfølgende meddelelser. Den indsættes i hovedmeddelelsesblokken. HTML-skabelonen skal kun indeholde det som minimalt behøves for at vise en meddelelse. </para>
</listitem>
</varlistentry>


<varlistentry
><term
><filename
>Incoming/Action.html</filename
></term>
              <term
><filename
>Outgoing/Action.html</filename
> (valgfri) (udvidelse i &kopete;)</term>
<listitem>
<para
>Denne skabelon er en udvidelse af Adium-formatet i &kopete;. Den er tilgængelig for indkommende og udgående retninger. Handlingsmeddelelser er specialmeddelelser som fortæller at en handling udføres. For eksempel: "/me installerer &kopete;" vil blive vist som "DarkShock installerer &kopete;".  </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Incoming/Content.html</filename
></term>
              <term
><filename
>Incoming/NextContent.html</filename
></term>
              <term
><filename
>Outgoing/Context.html</filename
></term>
              <term
><filename
>Outgoing/NextContext.html</filename
> (valgfri)</term>
<listitem>
<para
>Disse skabeloner bruges ikke i Kopete. I Adium bruges de til at vise historik. De er i hovedsagen ligesom Content og NextContent men med visse forskelle for at adskille dem fra normale meddelelser. </para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="chatstyle-reference-css">
	<title
>Om CSS-stilskabeloner og varianter</title>
	<para
>HTML-skabeloner bruges til at beskrive hvordan strukturen laves, men alle stiler beskrives i <acronym
>CSS</acronym
>-filer. <filename
>main.css</filename
> er hovedstilen, hvor varianter kun er ændringer af hovedstilen. Eksempel på varianter er anderledes farver, ingen visning af brugerfoto. Både <filename
>main.css</filename
> og varianter importeres i de endelige <acronym
>XHTML</acronym
>-sider.</para>
	<sect4 id="chatstyle-reference-css-main">
		<title
>-<filename
>main.css</filename
></title>
		<para
>Dette er den hoved <acronym
>CSS</acronym
>-filen som er fælles for alle varianter. Denne fil skal indeholde al hovedbeskrivelse af stilen.</para>
	</sect4>
	<sect4 id="chatstyle-refrence-css-variants">
		<title
>Varianter</title>
		<para
>Varianter er <acronym
>CSS</acronym
>-filer placerede i mappen <filename
>Variants/</filename
>. Hver variant er en enkelt <acronym
>CSS</acronym
>-fil som inkluderer <filename
>main.css</filename
> og gør ændringer af hovedstilen.</para>
	</sect4>
</sect3>

<sect3 id="chatstyle-reference-debug">
	<title
>Fejlsøgning af stiler</title>
	<para
>Her er to vink om hvordan man tester en stil mens den laves.</para>
	<sect4 id="chatstyle-reference-debug-save">
		<title
>- Gem et eksempel på en konversation.</title>
		<para
>Du kan <action
>gemme</action
> en konversation i chatvinduet. Dette er en kopi af den interne XHTML-side som vises. Brug den i <application
>Konqueror</application
> for at teste dine <acronym
>CSS</acronym
>-filer.</para>
	</sect4>
	<sect4 id="chatstyle-reference-debug-disable-cache">
		<title
>- Deaktivér stilcachen.</title>
		<para
>Et lille indstillingsflag findes til at deaktivere stilcachen. Når den aktiveres, genindlæses HTML-skabeloner hver gang en stil efterspørges. Tilføj følgende rækker i <filename
>kopeterc</filename
>. Meget nyttigt når en stil testes i &kopete;.</para>
		<programlisting
>[KopeteStyleDebug]
disableStyleCache=true
</programlisting>
	</sect4>
</sect3>

</sect2>

<sect2 id="chatstyle-reference-keywords">
	<title
>Nøgleordsreference</title>
	<para
>Nøgleord ligner huller som skal udfyldes med information. For hver ny meddelelse erstattes de af den rigtige værdi som svarer til deres sammenhæng. For helt at støtte alle funktioner i Kopete, er visse udvidelser af nøgleord tilføjet i Adium. Visse nøgleord er desuden også kun tilgængelige i visse sammenhænge.</para>

<variablelist
><title
>Nøgleordsliste for skabelonerne Header og Footer. </title>
<para
>Der behandles nøgleord når chatten starter.</para>
<varlistentry
><term
><filename
>%chatName%</filename
></term>
<listitem>
<para
>Dette er navnet på nuværende chatsession. I en typisk session viser dette navn og status for kontakten. For <acronym
>IRC</acronym
> vises kanalens emne. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%sourceName%</filename
></term>
              <term
><filename
>%destinationName%</filename
></term>
<listitem>
<para
>Disse er navnene på kontakterne i en chatsession. <filename
>%sourceName%</filename
> er dit navn. <filename
>%destinationName%</filename
> er navnet på kontakten du chatter med. Foretræk <filename
>%chatName%</filename
> frem for disse, eftersom de kan være forvirrende i gruppechatter og IRC. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%incomingIconPath%</filename
></term>
              <term
><filename
>%outgoingIconPath%</filename
></term>
<listitem>
<para
>Dette er kontakternes billede, foto eller avatar for en chatsession. Incoming repræsenterer kontaktfotoet og Outgoing repræsenterer dit eget foto. Hvis et foto ikke er tilgængeligt, bruges billedet <filename
>buddy_icon.png</filename
> som findes i mappen <filename
>Incoming</filename
> eller <filename
>Outgoing</filename
>. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%timeOpened%</filename
></term>
              <term
><filename
>%timeOpened{X}%</filename
></term>
<listitem>
<para
>Dette er tiden da chatsessionen begyndte. <filename
>%timeOpened%</filename
> bruger standardtidformatet for den nuværende landsindstilling. Hvis du vil bruge et specifikt tidsformat, brug <filename
>%timeOpened{X}%</filename
> hvor X er en streng som indeholder tidsformatet. Tidsparametrene er de samme som i glibc-funktionen <function
>strftime</function
>. Skriv <command
>man strftime</command
> for at få en liste med tilgængelige parametre. </para>
</listitem>
</varlistentry>

</variablelist>

<variablelist
><title
>Nøgleordsliste for skabelonerne Content, NextContent, Context, NextContext, Action</title>
<para
>Der behandles nøgleord for hver meddelelse.</para>

<varlistentry
><term
><filename
>%userIconPath%</filename
></term>
<listitem>
<para
>Dette er kontaktens billede, foto eller avatar som hører sammen med meddelelsen. Hvis et foto ikke er tilgængeligt, bruges billedet <filename
>buddy_icon.png</filename
> som findes i mappen <filename
>Incoming</filename
> eller <filename
>Outgoing</filename
> afhængig af meddelelsens retning. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%senderScreenName%</filename
></term>
<listitem>
<para
>Dette er kontaktidentifikationen for kontakten som hører sammen med meddelelsen, Eksempelvis jeg@hotmail.com, 45566576, AnnaKrogh. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%sender%</filename
></term>
<listitem>
<para
>Dette er kontaktens navn som hører sammen med meddelelsen. Det bruger metakontaktens navn at vise som kilde. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%service%</filename
></term>
<listitem>
<para
>Viser tjenestens navn som hører sammen med meddelelsen. Eksempel: Jabber, Yahoo, MSN. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%textbackgroundcolor{X}%</filename
></term>
<listitem>
<para
>Dette nøgleord bruges til at repræsentere markeret baggrundsfarve i &kopete;. Ignorér parametrene indenfor parenteserne og brug det kun som <filename
>%textbackgroundcolor{}</filename
>. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%senderStatusIcon%</filename
> (udvidelse af &kopete;)</term>
<listitem>
<para
>Viser kontaktens statusikon som hører sammen med meddelelsen. Det er en filsøgesti. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%senderColor%</filename
></term
>  <term
><filename
>%senderColor{N}%</filename
> (udvidelse af &kopete;)</term>
<listitem>
<para
>Opret en farve fra afsenderens kontaktidentifikation. Kan bruges til at vise en anden farve for kontaktens alias. </para>
<para
><filename
>%senderColor{N}%</filename
> hvor N er et positivt tal. Hvis N er større end 100 repræsenterer det en lysere farve end kontaktens farve. Hvis N er lig med 150 er det en farve som er 50 % lysere. Hvis N er mindre end 100 er det en mørkere farve. Brugbar for at lade baggrunden farves forskelligt for hver kontakt. </para>
<para
>Hvis du vil bruge farverne i en variant, men ikke i hovedstilen, findes en måde at komma rundt om det. <programlisting>
<![CDATA[
<div style="color:%senderColor%;border:none;border-color:%senderColor{40}%;"
><p class="message"
>...</p
></div>
]]>
</programlisting
> Du kan bruge farven for elementet p.message i filen <filename
>main.css</filename
>, og skrive noget som ligner følgende i varianten: <programlisting
>p.message { color:inherit; border-color:inherit; }
</programlisting>

</para>
</listitem>
</varlistentry>

</variablelist>

<variablelist
><title
>Nøgleordsliste fælles for meddelelser og Status.html</title>

<varlistentry
><term
><filename
>%message%</filename
></term>
<listitem>
<para
>Selve meddelelsen. Det er et HTML-fragment. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%time%</filename
></term>
              <term
><filename
>%time{X}%</filename
></term>
<listitem>
<para
>Tiden da meddelelsen blev modtaget. <filename
>%time%</filename
> bruger standardtidsformatet for den nuværende landsindstilling. Hvis du vil bruge et specifikt tidformat, brug så <filename
>%time{X}%</filename
> hvor X er en streng som indeholder tidsformatet. Tidsparametrene er de samme som i glibc-funktionen <function
>strftime</function
>. Skriv <command
>man strftime</command
> for at få en liste med tilgængelige parametre. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%messageDirection%</filename
> (udvidelse af &kopete;)</term>
<listitem>
<para
>Repræsenterer meddelelsens retning, om meddelelsen skal vises skrevet fra højre til venstre eller fra venstre til højre. Værdierne er enten "rtl" eller "ltr". Læs <link linkend="chatstyle-guideline-direction"
>Guide for meddelelseretning</link
> for at finde ud af hvordan nøgleordet bruges på en rigtig måde. </para>
</listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>

<sect1 id="chatstyle-guideline">
	<title
>Stilguide for chatvindue i &kopete;</title>
<para
>Stilguide for chatvindue i &kopete; er et sæt ting som din chatvinduesstil skal støtte for at fungere sammen med Kopete.</para>
<sect2 id="chatstyle-guideline-highlight">
	<title
>Understøt markeringer</title>
	<para
>Stilen skal vise markeringer. I Kopete og Adium erstattes <filename
>%textbackgroundcolor{}%</filename
> med markeringsfarven. Tilføj stilattributten <userinput
>background-color: %textbackgroundcolor{}%</userinput
> i HTML-elementet som viser meddelelsen.</para>
</sect2>
<sect2 id="chatstyle-guideline-consecutive">
	<title
>Meddelelsesskabeloner for efterfølgende meddelelser kræves.</title>
	<para
>Denne guide er til for dem som skriver gamle XSL-stiler om til det nye format. Alle stiler skal sørge for en skabelon for efterfølgende meddelelser. Det er nu en standardfunktion.</para>
</sect2>

<sect2 id="chatstyle-guideline-encoding">
	<title
>Brug kodningen <acronym
>UTF-8</acronym
>.</title>
	<para
>Overskriften siger alt. Du skal gemme filerne som <acronym
>UTF-8</acronym
>.</para>
</sect2>

<sect2 id="chatstyle-guideline-info">
	<title
>Sørg for at <filename
>Contents/Info.plist</filename
> for at virke  sammen med Adium</title>
	<para
>Filen <filename
>Contents/Info.plist</filename
> bruges ikke endnu i Kopete, men hvis du ønsker at stilen skal fungere sammen med <application
>Adium</application
> skal du sørge ofr denne fil. Her er en grundlæggende eksempelfil. Strenge at erstatte omgives af "$".</para>
<programlisting
><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
        <key
>CFBundleDevelopmentRegion</key>
        <string
>English</string>
        <key
>CFBundleGetInfoString</key>
        <string
>$Your style full name$</string>
        <key
>CFBundleIdentifier</key>
        <string
>$Your style ID in the form: com.adiumx.smooth.operator.style$</string>
        <key
>CFBundleInfoDictionaryVersion</key>
        <string
>1.0</string>
        <key
>CFBundleName</key>
        <string
>$Your style name here$</string>
        <key
>CFBundlePackageType</key>
        <string
>AdIM</string>
        <key
>MessageViewVersion</key>
        <integer
>3</integer>
</dict>
</plist>
]]>
</programlisting>

</sect2>

<sect2 id="chatstyle-guideline-buddyicon">
	<title
>Sørg for <filename
>buddy_icon.png</filename
></title>
	<para
>Du skal placere en fil som hedder <filename
>buddy_icon.png</filename
> i <filename
>Incoming</filename
> og <filename
>Outgoing</filename
>. Billederne bruges når kontakten ikke har noget foto.</para>
</sect2>

<sect2 id="chatstyle-guideline-direction">
	<title
>Støtte for sprog som skrives fra højre til venstre med nøgleordet <filename
>%messageDirection%</filename
>.</title>
	<para
>Nøgleordet <filename
>%messageDirection%</filename
> er til for de sprog i verden som skrives fra højre til venstre. Det definerer meddelelsens retning om det er "rtl" (højre til venstre) eller "ltr" (venstre til højre). Tilføj stilattributten i HTML-elementet som viser meddelelsen: <userinput
>direction: %messageDirection%</userinput
>. Forhåndsvisning af stilen i udseendeindstillingen indeholder en kontrol af at stilen viser højre til venstre rigtigt. Den skal vise strengen med begyndelse fra højre.</para>
</sect2>
</sect1>
</appendix>