summaryrefslogtreecommitdiffstats
path: root/tde-i18n-es/docs/kdenetwork/kopete/chatstyle.docbook
blob: 6d7f41306816a94b4b35061f15aa892884c1388e (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
>Guía de estilo de la ventana de charla de &kopete;</title>
<sect1 id="chatstyle-reference">
<title
>Referencia de estilo de la ventana de charla de &kopete;</title>
<para
>Desde &kopete; 0.12 estamos utilizando el formato <ulink url="http://www.adiumx.com/"
>Adium</ulink
> para nuestro estilo de ventana de charla. El formato del tema se basa en plantillas <acronym
>HTML</acronym
> y <acronym
>CSS</acronym
>. Es sencillo de crear y desarrollar, ya que solo es necesario un conocimiento de <acronym
>HTML</acronym
> y <acronym
>CSS</acronym
>. Además, los estilos pueden tener variantes (definidas como archivos <acronym
>CSS</acronym
>) que añaden un valor de personalización :). </para>

<sect2 id="chatstyle-reference-guide">
	<title
>Guía de referencia.</title>
<para
>El formato Adium está formado por una estructura de directorio, plantillas <acronym
>HTML</acronym
>, archivos <acronym
>CSS</acronym
> y palabras clave que se reemplazan cada vez que se procesa la plantilla. La conversación final es una página <acronym
>XHTML</acronym
> en la que los mensajes se añaden con operaciones <acronym
>DOM</acronym
>. El elemento central es un elemento div llamado <filename
>Chat</filename
>. Antes y después de este elemento div se encuentra la cabecera y el pie de la plantilla. Los mensajes son hijos del elemento div <filename
>Chat</filename
>. </para>

<sect3 id="chatstyle-refrerence-directory">
	<title
>Estructura del directorio</title>
<para
>Un estilo debe respetar esta estructura de directorio. El código de &kopete; está pensado alrededor de esta estructura de directorio. Cuando se guarda un estilo, se guarda el directorio <filename
>styleName</filename
>. La estructura del directorio es una estructura de un paquete de <application
>Mac OS X</application
> para aquellos que estén familiarizados con este sistema operativo. También debe respetar las mayúsculas que se muestran aquí, ya que un sistema <acronym
>UNIX</acronym
> es sensible a mayúsculas y minúsculas.</para>
<programlisting
>styleName\ (puede tener .adiumMessageStyle como sufijo, porque en Mac OS X es un paquete)
        Contents\
                Info.plist
                Resources\
                        main.css
                        Header.html
                        Footer.html
                        Status.html
                        Incoming\ (y saliente\)
                                Content.html
                                NextContent.html (para mensajes consecutivos)
                                Context.html (para mensajes del historial)
                                NextContext.html
                                Action.html
                        Variants\
                                *.css
</programlisting>
</sect3>

<sect3 id="chatstyle-reference-divinsert">
	<title
>Acerca de &lt;div id="insert"&gt;&lt;/div&gt;</title>
	<para
>Este es un elemento div especial utilizado internamente. Es el lugar en el que se indica dónde insertar el siguiente mensaje. Si es un mensaje nuevo se elimina y el mensaje nuevo toma su lugar. Pero si es un mensaje consecutivo, el elemento div se reemplaza con el contenido del nuevo mensaje. Este elemento especial div se <emphasis
>requiere</emphasis
> en las plantillas Content, Context, NextContent, NextContext, todo ello sin perjuicio de que se pueda colocar en las plantillas Action y Status. </para>
</sect3>

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

<variablelist
><title
>Descripción de la plantilla.</title>

<varlistentry
><term
><filename
>Header.html</filename
> (Requerido)</term>
<listitem>
<para
>Utilice la plantilla Header para mostrar una bonita cabecera a la conversación. Esta plantilla se inserta antes del elemento div <filename
>Chat</filename
>. Sino lo utiliza, deje un archivo vacío. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Footer.html</filename
> (Requerido)</term>
<listitem>
<para
>Es más o menos lo mismo que la cabecera, pero para el pie de una conversación. Esta plantilla se inserta después del elemento div <filename
>Chat</filename
>. Si no lo utiliza, deje un archivo vacío. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Status.html</filename
> (Requerido)</term>
<listitem>
<para
>Esta plantilla se utiliza para mostrar un mensaje interno. Los mensajes internos como el cambio de estado, mensajes de Kopete (ej: entrada de un archivo transferido). Cuando el estilo no proporciona una plantilla de Acción, se utiliza para mostrar un mensaje de Acción. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Incoming/Content.html</filename
></term>
              <term
><filename
>Outgoing/Content.html</filename
> (Requerido)</term>
<listitem>
<para
>La plantilla Content es el corazón del mensaje. Piense en ella como en un bloque en el que se incluyen los mensaje. Asegúrese de que está preparado para recibir mensajes consecutivos, no lo diseñe para mostrar un solo mensaje. Los mensajes consecutivos se insertarán en el elemento div insert. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Incoming/NextContent.html</filename
></term>
              <term
><filename
>Outgoing/NextContent.html</filename
> (Requerido)</term>
<listitem>
<para
>La plantilla NextContent es un fragmento de mensaje para mensajes consecutivos. Se insertará en el bloque principal del mensaje. La plantilla HTML debería contener lo mínimo para mostrar un mensaje. </para>
</listitem>
</varlistentry>


<varlistentry
><term
><filename
>Incoming/Action.html</filename
></term>
              <term
><filename
>Outgoing/Action.html</filename
> (Opcional) (Extensión de &kopete;)</term>
<listitem>
<para
>Esta plantilla es una extensión de &kopete; para el formato Adium. Está disponible tanto para la entrada (Incoming) como para la salida (Outgoing). Los mensajes de Acción (Action) son mensajes especiales indicar que se está realizando una acción. Ejemplo: «estoy instalando &kopete;» debería mostrarse como «DarkShock está instalando &kopete;». </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>Incoming/Context.html</filename
></term>
              <term
><filename
>Incoming/NextContext.html</filename
></term>
              <term
><filename
>Outgoing/Context.html</filename
></term>
              <term
><filename
>Outgoing/NextContext.html</filename
> (Opcional)</term>
<listitem>
<para
>Estas plantillas no se utilizan en Kopete. En Adium, se utilizan para mostrar el historial. Es más o menos lo mismo que Content y NextContent pero con algunas diferencias que las distinguen de los mensajes normales. </para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="chatstyle-reference-css">
	<title
>Acerca de los estilos CSS y sus variantes</title>
	<para
>La plantilla HTML se utiliza para describir como está creada la estructura. Pero todo el estilo se describe en los archivos <acronym
>CSS</acronym
>. <filename
>main.css</filename
> es el estilo principal, y las variantes son alteraciones del estilo principal. Ejemplos de variantes son colores diferentes, no mostrar la foto del usuario. Tanto <filename
>main.css</filename
> como las variantes se importan en la página final <acronym
>XHTML</acronym
>.</para>
	<sect4 id="chatstyle-reference-css-main">
		<title
>-<filename
>main.css</filename
></title>
		<para
>Éste es el principal archivo <acronym
>CSS</acronym
> que es común para todas las variantes. Este archivo debería contener toda la descripción principal del estilo.</para>
	</sect4>
	<sect4 id="chatstyle-refrence-css-variants">
		<title
>-Variantes</title>
		<para
>Las variantes son archivos <acronym
>CSS</acronym
> situados en el directorio <filename
>Variants/</filename
>. Cada variante es un archivo <acronym
>CSS</acronym
> que incluye el <filename
>main.css</filename
> y realiza la alteración del estilo principal.</para>
	</sect4>
</sect3>

<sect3 id="chatstyle-reference-debug">
	<title
>Estilos de depuración</title>
	<para
>Aquí encontraremos dos consejos para probar un estilo mientras se crea.</para>
	<sect4 id="chatstyle-reference-debug-save">
		<title
>-Guardar una conversación de muestra.</title>
		<para
>En la ventana de charla, puede <action
>guardar</action
> una conversación. Es una copia de la página XHTML interna mostrada. Utilícela en <application
>Konqueror</application
> para probar sus archivos <acronym
>CSS</acronym
>.</para>
	</sect4>
	<sect4 id="chatstyle-reference-debug-disable-cache">
		<title
>-Desactive la caché del estilo.</title>
		<para
>Una pequeña configuración activa o desactiva la caché del estilo. Cuando se activa, se recarga las plantillas HTML cada vez que se pide el estilo. Añada las siguientes líneas a su <filename
>kopeterc</filename
>. Es muy práctico cuando se está probando un estilo en &kopete;.</para>
		<programlisting
>[KopeteStyleDebug]
disableStyleCache=true
</programlisting>
	</sect4>
</sect3>

</sect2>

<sect2 id="chatstyle-reference-keywords">
	<title
>Referencia de palabras clave</title>
	<para
>Las palabras clave son como los hoyos que hay que rellenar con detallas. En cada nuevo mensaje, se reemplazan con el valor correcto que corresponde a su contexto. Para soportar completamente todas las características de Kopete, añadimos algunas extensiones de palabras clave de Adium. Algunas palabras clave también están disponibles en algún contexto.</para>

<variablelist
><title
>Lista de palabras clave para las plantillas de cabecera y de pie. </title>
<para
>Estas palabras clave se procesan al principio de la charla.</para>
<varlistentry
><term
><filename
>%chatName%</filename
></term>
<listitem>
<para
>El nombre de la sensión de charla actual. En una sesión típica, muestra el nombre del contacto y su estado. Para <acronym
>IRC</acronym
>, muestra el tema de un canal. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%sourceName%</filename
></term>
              <term
><filename
>%destinationName%</filename
></term>
<listitem>
<para
>Son el nombre de los contactos para una sesión de charla. <filename
>%sourceName%</filename
> es su nombre. <filename
>%destinationName%</filename
> es el nombre del contacto con el que está charlando. Se prefiere <filename
>%chatName%</filename
> a los anteriores, porque pueden dar lugar a confusión en un grupo de charla y en el IRC. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%incomingIconPath%</filename
></term>
              <term
><filename
>%outgoingIconPath%</filename
></term>
<listitem>
<para
>Son las imágenes/fotos/avatares de los contactos para una sesión de chat. Incoming representa la foto del contacto y Outgoing representa la propia foto. Si no hay fotos disponibles, se utiliza la imagen <filename
>buddy_icon.png</filename
> que se encuentra en el directorio <filename
>Incoming</filename
> u <filename
>Outgoing</filename
>. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%timeOpened%</filename
></term>
              <term
><filename
>%timeOpened{X}%</filename
></term>
<listitem>
<para
>Es la hora en la que comienza la sesión de charla. <filename
>%timeOpened%</filename
> utiliza el formato de hora predeterminado local. Si desea utilizar un formato de hora específico, utilice <filename
>%timeOpened{X}%</filename
> donde X es una cadena que contiene el formato de la hora. Los parámetros de hora son los mismos que para la función <function
>strftime</function
> de glibc. Consulte <command
>man strftime</command
> para obtener la lista de los parámetros disponibles. </para>
</listitem>
</varlistentry>

</variablelist>

<variablelist
><title
>Lista de palabras clave para las plantillas Content, NextContent, Context, NextContext, Action</title>
<para
>Estas palabras clave se procesan para cada mensaje.</para>

<varlistentry
><term
><filename
>%userIconPath%</filename
></term>
<listitem>
<para
>Son las imágenes/fotos/avatares de los contactos asociados con el mensaje. Si no hay fotos disponibles, se utiliza la imagen <filename
>buddy_icon.png</filename
> que se encuentra en el directorio <filename
>Incoming</filename
> y <filename
>Outgoing</filename
> dependiendo de la dirección del mensaje. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%senderScreenName%</filename
></term>
<listitem>
<para
>Este es el ID de contacto del contacto asociado con el mensaje. Ejemplos: yo@hotmail.com, 45566576, JuanFernández. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%sender%</filename
></term>
<listitem>
<para
>Es el nombre del contacto asociado con el mensaje. Utiliza el nombre que se muestra en MetaContact como una fuente. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%service%</filename
></term>
<listitem>
<para
>Muestra el nombre del servicio asociado con el mensaje. Ejemplos: Jabber, Yahoo, MSN. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%textbackgroundcolor{X}%</filename
></term>
<listitem>
<para
>En &kopete;, esta palabra clave se utiliza para representar el color de fondo resaltado. Ignora los parámetros en las llaves y solo se utiliza como <filename
>%textbackgroundcolor{}</filename
>. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%senderStatusIcon%</filename
> (extensión de &kopete;)</term>
<listitem>
<para
>Muestra el icono de estado del contacto asociado con el mensaje. Es una ruta de archivo. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%senderColor%</filename
></term
>  <term
><filename
>%senderColor{N}%</filename
> (extensión de &kopete;)</term>
<listitem>
<para
>Genera un color enviado por el id del contacto. Puede utilizarse para mostrar un color diferente para el apodo del contacto. </para>
<para
><filename
>%senderColor{N}%</filename
> donde N es un número positivo. Si N es mayor de 100, representa un color más claro que el color del contacto. Si N es igual a 150 es un color con un 50% más de brillo. Si N es inferior a 100 es un color oscuro. Práctico para tener un fondo coloreado de forma diferente para cada contacto. </para>
<para
>Si desea utilizar estos colores en una variante, pero no en el estilo principal, puede conseguirlo. <programlisting>
<![CDATA[
<div style="color:%senderColor%;border:none;border-color:%senderColor{40}%;"
><p class="message"
>...</p
></div>
]]>
</programlisting
> puede aplicar el color al elemento p.message en su archivo <filename
>main.css</filename
>, y en su variante puede colocar algo similar a esto <programlisting
>p.message { color:inherit; border-color:inherit; }
</programlisting>

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

</variablelist>

<variablelist
><title
>La lista de palabras clave comunes para mensajes y Status.html</title>

<varlistentry
><term
><filename
>%message%</filename
></term>
<listitem>
<para
>El propio mensaje. Es un fragmento HTML. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%time%</filename
></term>
              <term
><filename
>%time{X}%</filename
></term>
<listitem>
<para
>La hora en la que se recibió el mensaje. <filename
>%time%</filename
> utiliza el formato de hora local predeterminado. Si desea utilizar un formato de hora específico, utilice <filename
>%time{X}%</filename
> donde X es una cadena que contiene el formato de la hora. Los parámetros de hora son los mismos que para la función <function
>strftime</function
> de glibc. Consulte <command
>man strftime</command
> para obtener la lista de los parámetros disponibles. </para>
</listitem>
</varlistentry>

<varlistentry
><term
><filename
>%messageDirection%</filename
> (extensión de &kopete;)</term>
<listitem>
<para
>Representa la dirección del mensaje, si el mensaje debe mostrarse de derecha a izquierda o de izquierda a derecha. El valor puede ser «rtl» o «ltr». Consulte <link linkend="chatstyle-guideline-direction"
>guía de dirección de mensaje</link
> para averiguar cómo utilizar esta palabra clave correctamente. </para>
</listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>

<sect1 id="chatstyle-guideline">
	<title
>Guía de estilo de la ventana de charla de &kopete;</title>
<para
>La guía de estilo de la ventana de charla de &kopete; es un conjunto de cosas que su estilo de ventana de charla puede soportar para integrarse con Kopete.</para>
<sect2 id="chatstyle-guideline-highlight">
	<title
>Soporte de resaltado</title>
	<para
>Su estilo debe mostrar el resaltado. En Kopete y Adium, el <filename
>%textbackgroundcolor{}%</filename
> se reemplaza con el color de resaltado. Añada este atributo de estilo: <userinput
>background-color: %textbackgroundcolor{}%</userinput
> al elemento HTML que muestra el mensaje.</para>
</sect2>
<sect2 id="chatstyle-guideline-consecutive">
	<title
>Se requieren las plantillas de mensajes consecutivos.</title>
	<para
>Esta guía es para la gente que está reescribiendo antiguos estilos XSL al nuevo formato. Todos los estilos deben proporcionar una plantilla para mensajes consecutivos. Ahora es la característica predeterminada.</para>
</sect2>

<sect2 id="chatstyle-guideline-encoding">
	<title
>Utilizar codificación <acronym
>UTF-8</acronym
>.</title>
	<para
>El propio título lo dice. Debe guardar sus archivos en <acronym
>UTF-8</acronym
>.</para>
</sect2>

<sect2 id="chatstyle-guideline-info">
	<title
>Incluya <filename
>Contents/Info.plist</filename
> para interoperar con Adium.</title>
	<para
>El archivo <filename
>Contents/Info.plist</filename
> todavía no se utiliza en Kopete. Pero si desea que su estilo sea compatible con <application
>Adium</application
>, debe incluir este archivo. Veamos un ejemplo de archivo básico. Las cadenas se encierran con «$».</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
>Incluya <filename
>buddy_icon.png</filename
>.</title>
	<para
>Debe colocar un archivo llamado <filename
>buddy_icon.png</filename
> en <filename
>Incoming</filename
> y <filename
>Outgoing</filename
>. Estas imágenes se utilizarán cuando el contacto no tenga foto.</para>
</sect2>

<sect2 id="chatstyle-guideline-direction">
	<title
>Soporte los idiomas de derecha a izquierda con la palabra clave <filename
>%messageDirection%</filename
>.</title>
	<para
><filename
>%messageDirection%</filename
> está presente para aquellos idiomas a nivel mundial que se escriban de derecha a izquierda. Define la dirección del mensaje, puede ser «rtl» (derecha a izquierda) o «ltr» (izquierda a derecha). Añada este atributo de estilo al elemento HTML que muestra el mensaje: <userinput
>dirección: %messageDirection%</userinput
>. La vista previa del estilo en la configuración del aspecto incluye un marca derecha a izquierda si su estilo lo muestra correctamente. Debería comenzar la cadena por la derecha.</para>
</sect2>
</sect1>
</appendix>