summaryrefslogtreecommitdiffstats
path: root/tde-i18n-es/docs/tdepim/konsolekalendar/index.docbook
blob: b7d43025f8e4cd30d621cb090b1eddac586b0b2e (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
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
<?xml version="1.0" ?>
<!-- TODO:
     + Change license to GPL+QT exception
     + Search for other TODOs
     END TODO -->
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [

  <!ENTITY konsolekalendar "<application>KonsoleKalendar</application>">
  <!ENTITY kappname "KonsoleKalendar">
  <!ENTITY package "tdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE">
]>
<!-- The language must NOT be changed here. -->

<book lang="&language;">

<bookinfo>

<title>El manual de &konsolekalendar;</title>

<authorgroup>
<author><firstname>Tuukka</firstname> <surname>Pasanen</surname> <affiliation><address><email>illuusio@mailcity.com</email></address></affiliation>
</author>

<author><firstname>Allen</firstname> <surname>Winter</surname> <affiliation><address><email>awinterz@users.sourceforge.net</email></address></affiliation>
</author>

<othercredit role="reviewer"><firstname>Malcolm</firstname> <surname>Hunter</surname> <affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation>
<contrib>Revisor</contrib>
</othercredit>
<othercredit role="translator"> <firstname>Juan Manuel</firstname> <surname>García Molina</surname> <affiliation><address><email>juanma@superiodico.net</email></address></affiliation> <contrib>Traductor</contrib> </othercredit> 
</authorgroup>

<copyright>
<year>2002</year><year>2004</year><holder>Tuukka Pasanen</holder>
</copyright>

<copyright>
<year>2003</year><year>2005</year><holder>Allen Winter</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date>2004-04-15</date>
<releaseinfo>1.1.1</releaseinfo>

<abstract>
<para>&konsolekalendar; es un interfaz en línea de comando para los calendarios de &kde;.</para>
</abstract>


<keywordset>
<keyword>KDE</keyword>
<keyword>&package;</keyword>
<keyword>&kappname;</keyword>
<keyword>KOrganizer</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title>Introducción</title>

<para>&konsolekalendar; es un interfaz en línea de órdenes para los calendarios de &kde;. Permite ver, insertar, eliminar o modificar eventos de calendario por medio de líneas de comando o desde un lenguaje de script. Además, &konsolekalendar; puede exportar un calendario de &kde; a una amplia variedad de formatos, así como importar otros calendarios de &kde;.</para>

<para>En su modo básico, &konsolekalendar; muestra la lista de eventos de su calendario predeterminado para el día actual (desde las 7:00 a las 17:00).</para>

<para>Características principales de &konsolekalendar;: <itemizedlist>
<listitem><para>Muestra entradas de calendario desde una fecha/hora de comienzo a una fecha/hora de fin</para></listitem>
<listitem><para>Inserta (añade) entradas de calendario</para></listitem>
<listitem><para>Elimina (borra) entradas de calendario</para></listitem>
<listitem><para>Modifica (cambia) entradas de calendario</para></listitem>
<listitem><para>Crea un calendario nuevo</para></listitem>
<listitem><para>Exporta entradas de calendario a otros formatos de archivo</para></listitem>
<listitem><para>Importa un calendario existente en &kde;</para></listitem>
</itemizedlist></para>

<para>&konsolekalendar; <emphasis>no</emphasis> es otro interfaz gráfico de usuario para el calendario de &kde; (p.ej., &korganizer;). &konsolekalendar; se proporciona para los casos en los que usar un interfaz gráfico no es práctico o no es posible.</para>

<para>&konsolekalendar; <emphasis>no</emphasis> proporciona un lenguaje plagado de características para realizar consultas sobre el calendario del usuario; tampoco es la intención de los autores dotar al programa de dicha capacidad. Las opciones principales de la línea del comando se proporcionan para acceder a los eventos del calendario con un rango consecutivo de sellos de fecha/hora. </para>

</chapter>

<chapter id="features">
<title>Características</title>
<para>En este capítulo, aprenderá cosas acerca de las características de &konsolekalendar; y cómo usar  los parámetros de la línea de órdenes (recuerde que &konsolekalendar; no es un interfaz gráfico de usuario, sino un programa sólo de línea de comando).</para>

<para>También aprenderá cosas sobre la inserción, eliminación y modificación de eventos del calendario y sobre la exportación de eventos a otros formatos de archivo. En este capítulo también se tratará la creación e importación de calendarios en &kde;. </para>

<sect1 id="viewing">
<title>Ver eventos</title>

<para>En su modo predeterminado o usando el parámetro <parameter>--view</parameter>, &konsolekalendar; mostrará todos los eventos en el rango de fechas/horas indicadas.</para>

<para>
<informalexample><para>Para ver todos los eventos del día de la fecha (de 7:00 a 17:00), ejecute:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command>
</userinput>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample><para>En este ejemplo veremos todos los eventos de la semana del 18 al 22 de agosto:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--view</option> <option>--date <replaceable>2003-08-18</replaceable></option> <option>--end-date <replaceable>2003-08-22</replaceable></option>
</userinput>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample><para>Mostrar los próximos eventos en el calendario a partir de este momento:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--next</option>
</userinput>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample><para>Para ver todos los eventos de de los próximos 5 días, ejecute:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--show-next</option> <replaceable>5</replaceable>

</userinput>
</screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="inserting">
<title>Insertar eventos</title>

<para>&konsolekalendar; puede insertar eventos en un calendario de &kde; usando el argumento <parameter>--add</parameter> en la línea de órdenes. Los eventos que se inserten correctamente se mostrarán inmediatamente en las aplicaciones de calendario de &kde; (como &korganizer;).</para>

<para>
<informalexample><para>En el siguiente ejemplo, se insertará un evento que comienza el 2003-06-04 (4 de junio de 2003) a las 1000 (10:00) y que acaba a las 1200 (12:00) con el resumen «Visita al doctor» en el calendario predeterminado del usuario:</para>


<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--add</option> <option>--date <replaceable>2003-06-04</replaceable></option> <option>--time <replaceable>10:00</replaceable></option>\
<option>--end-time <replaceable>12:00</replaceable></option> <option>--summary <replaceable>"Visita al doctor"</replaceable></option> </userinput></screen>
</para>
</informalexample>
</para>

<para>
<informalexample><para>En este ejemplo se añade un evento de cumpleaños al calendario predeterminado del usuario:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--add</option> <option>--date <replaceable>2003-06-06</replaceable></option> <option>--summary <replaceable>"Mi cumpleaños"</replaceable></option> \
<option>--description <replaceable>"Hora de la fiesta"</replaceable></option></userinput></screen>
</para>
</informalexample>
</para>

<para>
<informalexample><para>Aquí se inserta una semana de <replaceable>vacaciones</replaceable> en un calendario compartido:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--add</option> <option>--file <replaceable>vacation.ics</replaceable></option> <option>--date <replaceable>2003-08-01</replaceable></option> \
<option>--end-date <replaceable>2003-08-07</replaceable></option> <option>--summary <replaceable>"Vacaciones"</replaceable></option> <option>--description <replaceable>"Nadie podrá dar conmigo"</replaceable></option></userinput></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="deleting">
<title>Eliminar entradas</title>

<para>&konsolekalendar; admite la eliminación de entradas en un archivo de calendario o en un recurso mediante el uso del argumento <parameter>--delete</parameter> de la línea de órdenes. Las entradas del calendario que se van a eliminar son exactamente las que se especifiquen en su cadena de identificación única (<acronym>UID</acronym>), usando la opción <parameter>--uid</parameter>. Los <acronym>UIDs</acronym> se encuentrar al visualizar el evento, usando la opción <parameter>--view</parameter>.</para>

<para>Los eventos que se eliminen correctamente, se eliminarán inmediatamente de las aplicaciones de calendarios de &kde; (por ejemplo, &korganizer;).</para>

<warning><para>Cuando elimine algo del calendario, <emphasis>no podrá</emphasis> deshacerlo. En otras palabras, cuando elimine una entrada no podrá dar marcha atrás al borrado. Simplemente se va.</para></warning>

<para>
<informalexample><para>Aquí borramos una entrada del calendario con <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--delete</option> <option>--uid <replaceable>&konsolekalendar;-1887551750.196</replaceable></option></userinput></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="changing">
<title>Modificar entradas</title>

<para>&konsolekalendar; admite la modificación de las entradas existentes en un archivo de calendario o de un recurso usando el argumento <parameter>--change</parameter> de la línea de órdenes. Las entradas del calendario que se van a modificar se especifican exactamente por su cadena de identificación única (<acronym>UID</acronym>), usando la opción <parameter>--uid</parameter>. Los <acronym>UIDs</acronym> se encuentran al visualizar el evento usando la opción <parameter>--view</parameter>.</para>

<para>Los cambios se realizan de la misma forma que las inserciones: puede cambiar la fecha y hora de comienzo y de fin, el resumen, la ubicación y la descripción. Los eventos que se modifiquen correctamente, mostrarán las modificaciones inmediatamente en las aplicaciones de calendarios de &kde; (&korganizer;).</para>

<para><emphasis>Ejemplo:</emphasis> Aquí cambiaremos el resumen y la descripción de una entrada del calendario con <acronym>UID</acronym> <replaceable>&konsolekalendar;-1887551750.196</replaceable>:</para>

<para>
<informalexample>
<para><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--change</option> <option>--uid <replaceable>&konsolekalendar;-1887551750.196</replaceable></option> <option>--summary <replaceable>"Examinarme la cabeza"</replaceable></option> <option>--description <replaceable>"no volver a ir a ese doctor"</replaceable></option> </userinput> </para>
</informalexample>
</para>

</sect1>

<sect1 id="creating">
<title>Crear un archivo de calendario nuevo</title>

<para>&konsolekalendar; se puede usar para crear un archivo de calenario nuevo para &kde;. Debido a que puede insertar una entrada en un calendario que no exista, debe crear primero el archivo usando los argumentos <parameter>--create</parameter> y <parameter>--file</parameter> de la línea de comando.</para>

<para>
<informalexample><para>Cree un archivo de calendario llamado <filename><replaceable>/data/share/calendars/vacation.ics</replaceable></filename>:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--create</option> <option>--file <replaceable>/data/share/calendars/vacation.ics</replaceable></option></userinput></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="exporting">
<title>Exportar a otros formatos</title>

<para>&konsolekalendar; puede exportar un calendario de &kde; a otros formatos bien conocidos. La exportación es una forma especial de vista. De forma predeterminada, los eventos se visualizan con el formato <quote>texto de &konsolekalendar;</quote>. Para cambiar el formato de visualización, use el argumento <parameter>--export-type</parameter> de la línea del comando.</para>

<para>Para ver una lista de todos los formatos de exportación admitidos, use la opción <parameter>--export-list</parameter>, como en:</para>

<para>
<informalexample>
<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--export-list</option></userinput></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="formats">
<title>Formatos de exportación</title>

<para>En esta sección se describen algunos, aunque no todos, de los formatos admitidos.</para>

<sect2 id="native-format">
<title>Formato de texto de &konsolekalendar;</title>

<para>El formato de texto de &konsolekalendar; es un formato nativo y está diseñado para que sea legible y lo puedan analizar otros scripts.</para>

<para>El formato de texto de &konsolekalendar; es: <informalexample> <screen>Date:\t&lt;Fecha de la incidencia&gt;(dddd yyyy-MM-dd)
[\t&lt;Hora de comienzo de la incidencia&gt;(hh:mm) - &lt;Incidence End Hora&gt;(hh:mm)]
Summary:
\t&lt;Resumen de la incidencia | "(no summary available)"&gt;
Location:
\t&lt;Ubicación de la incidencia | "(no location available)"&gt;
Description:
\t&lt;Descripción de la incidencia | "(no description available)"&gt;
UID:
\t&lt;UID de la incidencia&gt;
--------------------------------------------------
</screen>
</informalexample>
</para>

<para>Por ejemplo: <informalexample> <screen>Date:   Tuesday 2003-11-01
        8:00 - 9:00
Summary:
        Reunión del personal
Location:
        Salón de actos
Description:
        Reunión con todo el personal para hablar del proyecto.
UID:
        &konsolekalendar;-1128954167.1013
--------------------------------------------------
</screen>
</informalexample>
</para>

</sect2>

<sect2 id="short-format">
<title>Formato corto de texto de &konsolekalendar;</title>

<para>El formato corto de texto proporciona una versión más compacta y menos informativa del formato nativo de &konsolekalendar;.</para>

<para>El formato corto de texto de &konsolekalendar; es: <informalexample> <screen>[--------------------------------------------------]
{&lt;Fecha de la incidencia&gt;(dddd yyyy-MM-dd)]
[&lt;Hora de comienzo de la incidencia&gt;(hh:mm) - &lt;Hora de finalización de la incidencia&gt;(hh:mm) | "\t"]
\t&lt;Resumen de la incidencia | \t&gt;[, &lt;Ubicación de la incidencia&gt;]
\t\t&lt;Descripción de la incidencia | "\t"&gt;
</screen>
</informalexample>
</para>

<para>Por ejemplo: <informalexample> <screen>--------------------------------------------------
Tuesday 2003-11-01
08:00 - 09:00   Reunión del personal, Salón de actos
                Reunión con todo el personal para hablar del proyecto.
</screen>
</informalexample>
</para>

</sect2>

<sect2 id="csv-format">
<title>Formato de valores separados por comas (<acronym>CSV</acronym>)</title>

<para>El formato de valores separados por comas muestra los valores del evento en el mismo orden que en el formato de texto de &konsolekalendar;. La única diferencia es que toda la información está en la misma fila con cada campo separado del siguiente por una coma. Los archivos que resultan de esta importación se pueden importar directamente en programas de hoja de cálculo como &kspread;, <application>OpenOffice.org Calc</application> y <application>&Microsoft; Excel</application>. El formato <acronym>CSV</acronym> también se puede analizar fácilmente con otros scripts.</para>

<para>El formato de valores separados por comas (<acronym>CSV</acronym>) es: <informalexample> <screen>AAAA-MM-DD,HH:MM,AAAA-MM-DD,HH:MM,Resumen,Ubicación,Descripción,UID
</screen>
</informalexample>
</para>

<para>Por ejemplo: <informalexample> <screen>2003-11-01,08:00,2003-11-01,09:00,Reunión del personal,Salón de actos,Reunión en la sala\
de reuniones grande con todo el personal.,&konsolekalendar;-1128954167.1013
</screen>
</informalexample>
</para>

</sect2>

<sect2 id="html-format">
<title>Formato <acronym>HTML</acronym></title>

<para>El formato de exportación <acronym>HTML</acronym> producirá un archivo <acronym>HTML</acronym> válido para que se pueda publicar en la <acronym>WWW</acronym>. Este formato de exportación no es adecuado para analizarlos mediante scripts, pero es muy recomendable para publicar calendarios y hacerlos visibles de forma sencilla.</para>

<para><emphasis>POR HACER:</emphasis> Insertar aquí una captura de pantalla</para>

</sect2>

<sect2 id="html-month-format">
<title>Formato <acronym>HTML mensual</acronym></title>

<para>Este formato produce un archivo <acronym>HTML</acronym> que muestra todas las citas del mes especificado en el rango de fechas. Este formato de exportación no es adecuado para analizarlos mediante guiones, pero es muy recomendable para publicar calendarios y hacerlos visibles de forma sencilla.</para>

<para><emphasis>POR HACER:</emphasis> Insertar aquí una captura de pantalla</para>

</sect2>

</sect1>

<sect1 id="importing">
<title>Importar calendarios</title>

<para>&konsolekalendar; puede importar un archivo de calendario <acronym>ICS</acronym> en un calendario de &kde;. Todos los eventos del calendario que se vayan a importar se insertarán, incluyendo los eventos idénticos. En la próxima versión de &konsolekalendar; no se insertarán los eventos idénticos.</para>

<para>
<informalexample><para>Para importar el archivos de calendario <filename><replaceable>otro.ics</replaceable></filename> en el calendario <filename><replaceable>actual.ics</replaceable></filename>, ejecute:</para>

<para>
<screen><prompt>%</prompt><userinput> <command>konsolekalendar</command> <option>--import <replaceable>otro.ics</replaceable></option> <option>--file <replaceable>actual.ics</replaceable></option></userinput></screen>
</para>
</informalexample>
</para>

</sect1>

</chapter>

<chapter id="features-commandline-options">
<title>Argumentos de la línea del comando</title>

<para>&konsolekalendar; admite las siguientes opciones:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry>Opción</entry>
  <entry>Descripción</entry>
</row>
</thead>
<tbody>
<row>
  <entry><option>--help, --help-all</option></entry>
  <entry>Muestra ayuda acerca de las opciones del programa.</entry>
</row>
<row>
  <entry><option>--author</option></entry>
  <entry>Muestra información sobre el autor del programa.</entry>
</row>
<row>
  <entry><option>-v, --version</option></entry>
  <entry>Muestra información sobre la versión del programa.</entry>
</row>
<row>
  <entry><option>--license</option></entry>
  <entry>Muestra información sobre la licencia del programa.</entry>
</row>
<row>
  <entry><option>--verbose</option></entry>
  <entry>Muestra mensajes útiles en tiempo de ejecución.</entry>
</row>
<row>
  <entry><option>--dry-run</option></entry>
  <entry>Muestra qué se haría, aunque no lo ejecuta. No cambia ningún archivo; ni inserta ni elimina ni modifica ningún archivo existente ni crea ningún archivo nuevo.</entry>
</row>
<row>
  <entry><option>--file</option> <replaceable>&nbsp;archivo-calendario</replaceable></entry>
  <entry>Especifica qué archivo de calendario quiere usar. <para>Si no se indica, se usa su recurso de &korganizer; predefinido.</para></entry>
</row>
<row>
  <entry><emphasis>Principales modos de operación:</emphasis></entry>
</row>
<row>
  <entry><option>--view</option></entry>
  <entry>Muestra los eventos del calendario en el formato de exportación indicado.</entry>
</row>
<row>
  <entry><option>--add</option></entry>
  <entry>Inserta un evento en el calendario.</entry>
</row>
<row>
  <entry><option>--change</option></entry>
  <entry>Modifica un evento en un calendario existente.</entry>
</row>
<row>
  <entry><option>--delete</option></entry>
  <entry>Elimina un evento de un calendario existente.</entry>
</row>
<row>
  <entry><option>--create</option></entry>
  <entry>Crea un nuevo archivo de calendario, si es que no existe uno ya.</entry>
</row>
<row>
  <entry><option>--import</option> <replaceable>&nbsp;archivo-importación</replaceable></entry>
  <entry>Importa este calendario en el calendario principal.</entry>
</row>
<row>
  <entry><emphasis>Modificadores de la operación:</emphasis></entry>
</row>
<row>
  <entry><option>--all</option></entry>
  <entry>Muestra todas las entradas del calendario.</entry>
</row>
<row>
  <entry><option>--next</option></entry>
  <entry>Ve la siguiente actividad del calendario.</entry>
</row>
<row>
  <entry><option>--show-next</option> <replaceable>&nbsp;días</replaceable></entry>
  <entry>Comenzando en la fecha especificada, muestra las actividades en los siguientes # días.</entry>
</row>
<row>
  <entry><option>--uid</option> <replaceable>&nbsp;UID</replaceable></entry>
  <entry>Visualiza, elimina o cambia el evento con esta cadena de identificación única.</entry>
</row>
<row>
  <entry><option>--date</option> <replaceable>&nbsp;fecha</replaceable></entry>
  <entry>Comienzo en este día [AAAA-MM-DD]. La fecha predeterminada es hoy.</entry>
</row>
<row>
  <entry><option>--time</option> <replaceable>&nbsp;hora</replaceable></entry>
  <entry>Comienzo a esta hora [HH:MM]. La hora predefinida para la vista son las 07:00. <para>Para añadir o cambiar un evento flotante, use las opciones <option>--time float</option> o <option>--end-time float</option>.</para></entry>
</row>
<row>
  <entry><option>--end-date</option> <replaceable>&nbsp;fecha-fin</replaceable></entry>
  <entry>Fin en este día [AAAA-MM-DD]. El predefinido se establece con <replaceable>--date</replaceable>.</entry>
</row>
<row>
  <entry><option>--end-time</option> <replaceable>&nbsp;hora-fin</replaceable></entry>
  <entry>Fin a esta hora [HH:MM]. La hora predeterminada de finalización para las vistas son las 17:00. <para>Para añadir o cambiar un evento flotante, use las opciones <option>--time float</option> o <option>--end-time float</option>.</para></entry>
</row>
<row>
  <entry><option>--epoch-start</option> <replaceable>&nbsp;hora-epoch</replaceable></entry>
  <entry>Comienzo a esta hora [segundos desde epoch].</entry>
</row>
<row>
  <entry><option>--epoch-end</option> <replaceable>&nbsp;hora-epoch</replaceable></entry>
  <entry>Fin a esta hora [segundos desde epoch].</entry>
</row>
<row>
  <entry><option>--summary</option> <replaceable>&nbsp;resumen</replaceable></entry>
  <entry>Añade un resumen al evento (funciona con add {añadir} y change {cambiar}).</entry>
</row>
<row>
  <entry><option>--description</option> <replaceable>&nbsp;descripción</replaceable></entry>
  <entry>Añade una descripción al evento (funciona con add {añadir} y change {cambiar}).</entry>
</row>
<row>
  <entry><option>--location</option> <replaceable>&nbsp;ubicación</replaceable></entry>
  <entry>Añade una ubicación al evento (funciona con add {añadir} y change {cambiar}).</entry>
</row>
<row>
  <entry><emphasis>Opciones de exportación:</emphasis></entry>
</row>
<row>
  <entry><option>--export-type</option> <replaceable>&nbsp;tipo-exportación</replaceable></entry>
  <entry>Tipo de archivo para exportar. El tipo de exportación predeterminado es «Text» (texto).</entry>
</row>
<row>
  <entry><option>--export-file</option> <replaceable>&nbsp;archivo-exportación</replaceable></entry>
  <entry>Exporta a un archivo. De forma predeterminada, la salida se escribe en la salida estándar.</entry>
</row>
<row>
  <entry><option>--export-list</option></entry>
  <entry>Muestra la lista con los tipos de exportación admitidos y sale.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</chapter>

<chapter id="faq">
<title>Preguntas y respuestas</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para>¿Qué archivos de configuración usa &konsolekalendar;?</para>
</question>
<answer>
<para>Ninguno.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para>¿Cuál es el nombre de la aplicación &konsolekalendar;?</para>
</question>
<answer>
<para>El nombre de la aplicación &konsolekalendar; es <application>konsolekalendar</application>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Cuál es el formato de especificación de fecha?</para>
</question>
<answer>
<para>&konsolekalendar; rechazará las fechas especificadas en la línea del comando salvo que se especifiquen según los estándares ISO 8601, formalmente: AAAA-MM-DD. Donde AAAA representa un año con 4 dígitos (como 2004), MM representa un mes con dos dígitos (01, 02, ..., 12), y DD representa un día con dos dígitos (01, 02, ..., 31).</para>
<para>&konsolekalendar; siempre exporta las fechas según el formato ISO 8601.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Cuál es el formato de especificación de hora?</para>
</question>
<answer>
<para>&konsolekalendar; rechazará las horas especificadas en la línea del comando salvo que se indiquen según los estándares ISO 8601, formalmente: HH:MM:SS. Donde HH representa una hora con dos dígitos (01, 02, ..., 24), MM representa un minuto con dos dígitos (01, 02, ..., 60) y SS representa un segundo con dos dígitos (01, 02, ..., 60).</para>
<para>&konsolekalendar; siempre exporta las horas según el formato ISO 8601.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Insertará &konsolekalendar; un evento nuevo que sea idéntico a uno que exista ya en el calendario?</para>
</question>
<answer>
<para>No. Vea la siguiente pregunta.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Cómo determina &konsolekalendar; si un evento es idéntico a otro que ya exista en el calendario?</para>
</question>
<answer>
<para>&konsolekalendar; comprueba la fecha y hora de comienzo y fin y el resumen con los de todos los eventos del calendario. Si algún evento coincide con los tres valores, se marca como un evento existente. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Puede un evento flotante cambiar un evento no flotante?</para>
</question>
<answer>
<para>Sí. USe la opción <option>--time float</option> con <option>--change</option>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Por qué se imprimen los <acronym>UIDs</acronym> de eventos en la mayoría de formatos de exportación?</para>
</question>
<answer>
<para>Porque necesita especifica el <acronym>UID</acronym> para eliminar o cambiar los eventos. Si no quiere ver los <acronym>UIDs</acronym> de los eventos, use el tipo de exportación <emphasis>short</emphasis> (<option>--export-type short</option>). </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>¿Cómo puedo añadir mi pregunta a estas <acronym>PUF</acronym>?</para>
</question>
<answer>
<para>Envíe sus preguntas a <email>illuusio@lycos.com</email>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title>Créditor y licencia</title>

<para>&konsolekalendar; Copyright del programa 2002,2003:</para>

<itemizedlist>
<listitem><para>Tuukka Pasanen <email>illuusio@mailcity.com</email></para></listitem>
<listitem><para>Allen Winter <email>awinterz@users.sourceforge.net</email></para></listitem>
</itemizedlist>

<para>Copyright de la documentación 2003:</para>
<itemizedlist>
<listitem><para>Allen Winter <email>awinterz@users.sourceforge.net</email></para></listitem>
<listitem><para>Tuukka Pasanen<email>illuusio@mailcity.com</email></para></listitem>
</itemizedlist>

<para>Traducido por Juan Manuel García Molina <email>juanma@superiodico.net</email></para> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title>Instalación</title>

<sect1 id="obtaining-application">
<title>Cómo obtener &konsolekalendar;</title>
&install.intro.documentation; <para>&konsolekalendar; viene con &kde;3 y no está disponible por separado. </para>

</sect1>

<sect1 id="requirements">
<title>Requisitos</title>

<para>&konsolekalendar; necesita que estén instaladas las bibliotecas estándar de &kde; (el paquete <filename>tdelibs</filename>). Para compilarlo desde los fuentes, también necesitará los paquetes de desarrollo de <filename>tdelibs</filename>.</para>

<para>Puede encontrar una lista de cambios en el archivo <filename>Changelog</filename>.</para>
</sect1>

<sect1 id="compilation">
<title>Compilación e instalación</title>

<para>Esta sección proporciona una revisión rápida del proceso de compilación. Lea <ulink url="http://developer.kde.org/build/compile_kde3_2.html"> Compilar &kde; 3.2.x</ulink> para tener acceso a las instrucciones completas.</para>

<para>Si no puede obtener un paquete binario precompilado que se amolde a sus necesidades, tendrá que compilar &konsolekalendar; usted mismo desde los archivos fuente. Obtenga el archivo con el paquete fuente <filename>tdepim-x.x.tar.bz2</filename>. Desempaquételo en un directorio nuevo usando un comando como <userinput><command>tar</command> <option>xvfj <replaceable>paquete.tar.bz2</replaceable></option></userinput>, y vaya a la carpeta que se ha creado.</para>
&install.compile.documentation; <note><para>Si tiene más de una versión de &kde; instalada (p.ej. &kde;2 y &kde;3), es posible que pueda instalar &konsolekalendar; en la carpeta equivocada de &kde;. Si fuera necesario, puede proporcionar la carpeta de &kde; por parámetro para <userinput><command>./configure</command></userinput>. Por ejemplo, si su &kde; está instalado en <filename>/opt/kde3</filename>: </para>

<para><userinput><command>./configure</command> --prefix=<replaceable>/opt/kde3</replaceable></userinput></para></note>

</sect1>

<sect1 id="configuration">
<title>Configuración</title>

<para>No necesita ninguna configuración especial para configurar &konsolekalendar; para que corra en el escritorio de &kde;.</para>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->