<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.formats">
<chapterinfo>
  <authorgroup>
    <author
><firstname
>Thomas</firstname
> <surname
>Baumgart</surname
> <affiliation
> <address
><email
>ipwizard@users.sourceforge.net</email
></address>
      </affiliation>
    </author>
</authorgroup
> <date
>2010-03-07</date
> <releaseinfo
>3.97</releaseinfo
> </chapterinfo>

<title
>Formatos de archivo</title>

<para
>Este capítulo describe los formatos con los que &kappname; almacena sus datos de manera permanente en dispositivos de almacenamiento. En general, &kappname; almacena la información en un documento &XML;. Según el formato actual, este documento &XML; se escribirá <itemizedlist>
  <listitem
><para
>como un <link linkend="details.formats.plain"
>archivo de texto plano</link
> codificado en UTF-8,</para
></listitem>

  <listitem
><para
>como un <link linkend="details.formats.compressed"
>archivo comprimido</link
> mediante compresión GZIP,</para
></listitem>

  <listitem
><para
>como un <link linkend="details.formats.encrypted"
>archivo cifrado</link
> mediante cifrado GPG, o</para
></listitem>

  <listitem
><para
>como un <link linkend="details.formats.anonymous"
>archivo anónimo de texto plano</link
> codificado en UTF-8 pero sin ninguno de sus datos personales.</para
></listitem>
</itemizedlist>
</para>

<sect1 id="details.formats.plain">
<title
>Archivo de texto plano</title>
<para
>Este es el formato que más espacio consume, pues no se realiza ninguna compresión. No está enfocado a un uso habitual, y se proporciona para facilitar la depuración y para brindar la posibilidad de modificarlo a mano. Si termina el nombre de un archivo en <literal role="extension"
>.xml</literal
>, se almacenará en este formato. <caution
> <para
>No se recomienda a los usuarios típicos que modifiquen a mano el archivo, solo debería hacerse si se comprende totalmente el funcionamiento interno de &kappname; o si los desarrolladores le han dado instrucciones para ello. No culpe a los desarrolladores de &kappname; si estropea sus datos: ¡ya ha sido advertido! </para>
</caution>
</para>
</sect1>

<sect1 id="details.formats.compressed">
<title
>Archivo comprimido con GZIP</title>
<para
>Este es el formato que se suele utilizar en &kappname; cuando almacena un archivo con la extensión <literal role="extension"
>.kmy</literal
>. </para>

<note>
  <para
>Si ha seleccionado que se <link linkend="details.formats.encrypted"
>cifre</link
>, el archivo se guardará de dicha manera. </para>
</note>

<para
>Si quiere explorar el contenido de un archivo comprimido con GZIP, renómbrelo con otro nombre terminado en <literal role="extension"
>.gz</literal
> (&eg;, renombre <filename
>misfinanzas.kmy</filename
> a <filename
>misfinanzas.kmy.gz</filename
>), y use <command
>gunzip</command
> para descomprimirlo y explorarlo. No hace falta que lo recomprima antes de volver a cargarlo en &kappname;, porque &kappname; también puede leer los datos descomprimidos. Sin embargo, si posteriormente lo guarda, volverá a estar comprimido. Utilice la extensión <link linkend="details.formats.plain"
>.xml</link
> para guardarlo en un formato sin compresión. </para>
</sect1>

<sect1 id="details.formats.encrypted">
<title
>Archivo cifrado con GPG</title>
<para
>El uso de archivos cifrados con GPG es una manera muy segura de almacenar sus datos financieros en dispositivos de almacenamiento. Si en el diálogo de preferencias indicó a &kappname; que cifrase sus datos, lo hará mediante GPG y la clave que haya facilitado antes del guardado. Al abrir un archivo cifrado, deberá indicar la frase de acceso a su anillo de claves. El archivo en sí se almacenará en el formato <emphasis
>armadura ASCII</emphasis
> de GPG. <note
> <para
>Al usar el cifrado GPG, el archivo también se comprime, por lo que no necesita realizar ninguna compresión adicional. </para>
  </note>
</para>

<sect2 id="details.formats.encrypted.gpgkeys">
<title
>Claves GPG</title>
<para
>Si no lo ha hecho ya para el cifrado de correo, debe generar un par de claves para usar el cifrado GPC de &kappname;. También debe haber instalado <application
>GPG</application
> en su equipo. </para>

<para
>Los detalles sobre cómo generar un par de claves y gestionar queda fuera del ámbito de este documento. Puede encontrar un mini-tutorial en <ulink url="http://www.gnupg.org/documentation/howtos.en.html"
>http://www.gnupg.org/documentation/howtos.en.html</ulink
>. </para>
</sect2>

<sect2 id="details.formats.encrypted.keysettings">
<title
>Establecer las claves en &kappname;</title>
<para
>En la página sobre cifrado del cuadro de diálogo de preferencias, hay una lista desplegable donde puede seleccionar qué clave usar para cifrar y descifrar. Además encontrará un campo donde introducir el ID de una clave que no esté en la lista. Puede utilizar el ID de la clave, la dirección de correo electrónico asociada a ella, o cualquier otra identificación válida de GPG como valor para este campo. Cuando introduzca el ID de la clave, &kappname; comprobará su validez y mostrará un icono de LED verde en el diálogo si encuentra la clave. <caution
> <para
>Asegúrese de tener las claves pública y privada para este ID. SI no es el propietario de la clave privada del ID introducido, no podrá volver a abrir el archivo. </para>
  </caution>
</para>
</sect2>

<sect2 id="details.formats.encrypted.recoverkey">
<title
>La clave de recuperación de &kappname;</title>
<para
>Also on this page of the settings dialog you have the choice of selecting supplemental encryption with the &kappname; recover key. This option is available to you if that key is stored in your <application
>GPG</application
> keyring. Selecting this option will allow you to recover your data even in the case you lose your own private key. This is possible because the data is not only encrypted for your own key, but also for the &kappname; recover key. This key is only available to selected &kappname; developers (at the time of writing only to the author). </para>

<para
>En circunstancias normales, abrirá/guardará/cerrará los archivos de manera normal. En el caso de que hubiese perdido su clave, puede contactar con uno de los desarrolladores que tenga acceso a la clave de recuperación de &kappname; y pedir ayuda para recuperar sus datos. Puede contactar con ellos por correo electrónico en la lista de desarrolladores de &kappname;, &devlist;. </para>
</sect2>
</sect1>

<sect1 id="details.formats.anonymous">
<title
>Archivo anónimo</title>
<para
>This format is not intended to be used for normal data storage. It is supported in case of a problem as a method of supplying the &kappname; development team with your file without disclosing any of your financial data. If instructed by the developers, use the <guimenuitem
>Save as...</guimenuitem
> menu item to store your data in anonymous format by selecting <literal role="extension"
>.anon.xml</literal
> as the file extension. To verify that your problem still exists, reload this anonymized file and try to duplicate your problem. If the problem is still present, send the file to the developer mailing list at &devlist; for further investigation. If the problem does not show ... well, I don't want to think about this scenario right now. </para>
</sect1>
</chapter>