<chapter id="importing-exporting">
<title
>Importar y exportar datos</title>

<para
>&appname; puede importar y exportar una amplia variedad de archivos de datos, además de buscar información en varios sitios de internet. </para>

<sect1 id="internet-search">
<title
>Importar desde internet</title>
<para
>&appname; puede buscar en varios sitios de internet usando el <interface
>Diálogo de búsqueda en internet</interface
>. Las entradas pueden ser importadas directamente y añadidas a su colección actual. Los diversos proveedores se configuran mediante las <link linkend="data-sources-options"
>Opciones de fuentes de datos</link
>. </para>

<para
>Las búsquedas pueden usar cinco criterios distintos: <guilabel
>Título</guilabel
>, <guilabel
>Persona</guilabel
>, <guilabel
>ISBN</guilabel
>, <guilabel
>UPC/EAN</guilabel
>, o <guilabel
>Palabra clave</guilabel
>. No todos los criterios están disponibles para ciertas fuentes de datos.</para>

<para
>Una vez se ha iniciado una búsqueda, el botón <guibutton
>Buscar</guibutton
> se convierte en <guibutton
>Detener</guibutton
>, que finalizará la búsqueda. A medida que se encuentren resultados, se añadirán a la lista directamente bajo la caja de búsqueda, donde seleccionar un elemento mostrará el resultado sin añadirlo a la colección. Hacer click en el botón <guibutton
>Añadir entrada</guibutton
> añadirá los elementos seleccionados a su colección. Si la fuente de datos tiene más resultados de los que se solicitaron inicialmente, el botón <guibutton
>Obtener más resultados</guibutton
> se volverá activo. Hacer click en <guibutton
>Limpiar</guibutton
> eliminará todos los resultados actuales y reiniciará la búsqueda. </para>

<screenshot>
<screeninfo
>El <interface
>Diálogo de búsqueda en internet</interface
> de &appname;</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="fetch-dialog.png"/></imageobject>
<textobject
><phrase
>El <interface
>Diálogo de búsqueda en internet</interface
>de &appname;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Sólo se encontrarán las entradas que coincidan con el tipo de la colección actual. La columna <guilabel
>Descripción</guilabel
> proporciona información adicional acerca de la entrada para diferenciar entre videos en diferentes formatos o libros con distinta encuadernación, por ejemplo. Una vez una entrada se ha añadido con éxito a la colección, se añadirá una marca de verificación a la primera columna de la lista. </para>

<para
>Se pueden añadir entradas múltiples usando el método estándar de &kde; para la selección múltiple, que normalmente incluye mantener pulsada la tecla &Shift; o &Ctrl; cuando se hace click en un elemento. </para>

<para
>Para facilitar el uso de los escáneres de código de barras, las búsquedas pueden incluir múltiples valores de ISBN/UPC. Seleccionar la casilla de verificación <guilabel
>Búsqueda ISBN/UPC múltiple</guilabel
> deshabilitará la caja de búsqueda y habilitará el botón <guibutton
>Editar valores ISBN/UPC...</guibutton
>, que abrirá una caja de entrada de texto de varias líneas. tras cerrar la caja, cada ISBN será validado para un formato correcto. La validación ISBN puede convertir los valores EAN de 13 dígitos, además de códigos <acronym
>UPC</acronym
> completos al formato apropiado. La lista de ISBN también se puede leer desde un archivo de texto. </para>

</sect1>

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

<para
>&appname; ofrece tres acciones diferentes cuando se importan datos. <guilabel
>Reemplazar la colección actual</guilabel
> cerrará la colección actual y creará una nueva con los datos del archivo importado. <guilabel
>Adjuntar a la colección actual</guilabel
> le dice a &appname; que añada todas las entradas de la colección importada a la actual, y añadir también cualquier campo que no exista actualmente. La acción <guilabel
>Refundir colección</guilabel
> es lo mismo que adjuntar, excepto que cada entrada importada se compara con las actuales, y los valores idénticos se omiten. Planes futuros incluyen una mejora heurística para identificar entradas coincidentes pero, actualmente, excepto para las colecciones de música, deben ser idénticas en todos los campos. Las colecciones de música comparan sólo el artista y el álbum, y las pistas son refundidas para las entradas coincidentes. El <link linkend="importing-audio-files"
>importador de archivos de audio</link
> puede construir listas de pistas correctamente refundiendo las entradas. </para>

<sect2 id="importing-tellico">
<title
>Importar datos de &appname;</title>

<para
>Se pueden importar otros archivos de datos de &appname;. Reemplazar la colección actual importando otro archivo de &appname; es lo mismo que abrir el propio archivo. El valor de importar los datos de &appname; es poder añadir o refundir dos colecciones. </para>
</sect2>

<sect2 id="importing-csv">
<title
>Importar datos CSV</title>

<para
>Los valores separados por comas (<acronym
>CSV</acronym
>) son una forma común de importar y exportar datos tabulares. El valor de cada campo se separa por una coma, con una entrada por línea. Los títulos de los campos se pueden incluir en la primera línea. El importador CSV no se limita a usar una coma como separador. Se puede utilizar cualquier carácter o cadena de caracteres. </para>

<screenshot>
<screeninfo
>El diálogo de importación de CSV</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="csv-dialog.png"/></imageobject>
<textobject
><phrase
>El diálogo de importación de CSV</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Primero, seleccione el tipo de colección que está importando. Si la está añadiendo o refundiendo con su colección abierta, el tipo está limitado al tipo de su colección actual. Si la primera línea del archivo CSV contiene los títulos de los campos, haga click en la casilla de verificación y el importador comparará automáticamente los títulos con los de los campos en la colección actual. Si el título de un campo coincide, la cabecera para esa columna cambiará para mostrar que la columna se ha asignado a ese campo. Si el archivo usa un separador distinto a la coma, asegúrese de cambiar esa opción de acuerdo con él. </para>

<para
>Para que &appname; importe el archivo correctamente, debe saber qué campo corresponde a cada columna. <emphasis
>Si la columna sólo tiene un número en la cabecera, los datos de esa columna no serán importados</emphasis
>. Debería asignar campos a cada columna seleccionando una columna haciendo click en ella o cambiando el número de columna, y después seleccionando el campo que asignarle de la caja desplegable y haciendo click en el botón <guibutton
>Asignar campo</guibutton
>. Si necesita añadir un nuevo campo a la colección, el último elemento en la caja desplegable abrirá el <link linkend="fields-dialog"
><interface
>Diálogo de campos de la colección</interface
></link
>. </para>

<para
>Sólo se muestran en el diálogo las primeras cinco líneas del archivo CSV importado. </para>

</sect2>

<sect2 id="importing-audio">
<title
>Importar datos de un &CD; de audio</title>

<para
>&appname; puede usar el servicio <ulink url="http://freedb.org"
>freedb.org</ulink
> para buscar información sobre un &CD;, incluyendo el listado de pistas. Dependiendo de su distribución, los ajustes para acceder al servicio se podrán configurar en el Centro de Control de &kde;. Se añadirán el &CD;, artista, título, género, año y listado de pistas. </para>

<para
>Además, si el disco contiene texto de &CD;, se leerá esa información y se añadirá a la entrada importada. </para>
</sect2>

<sect2 id="importing-audio-files">
<title
>Importar metadatos de archivos de audio</title>

<para
>&appname; puede explorar una carpeta y leer las etiquetas de los formatos de audio más comunes, como <literal role="extension"
>mp3</literal
> y <literal role="extension"
>ogg</literal
>. Las canciones se introducen en una colección de música, donde cada entrada es un álbum. Si los archivos de la canción contienen el número de pista, el nombre de la canción se inserta en el lugar correcto del listado de pistas. La información del artista y del género también se añaden a la entrada. Si las etiquetas de la canción incluyen comentarios, se añaden al campo de comentarios de la entrada, precedidos por el nombre del archivo. </para>

<para
>Además, si una carpeta contiene un archivo <filename
>.directory</filename
> y el nombre de la carpeta coincide con el título de un álbum, la entrada de <literal
>Icono</literal
> en el archivo de escritorio se utiliza como imagen de portada para ese álbum. </para>

<para
>El importador de metadatos de archivos de audio puede explorar recursivamente una carpeta para encontrar todos los archivos de audio en cualquier subcarpeta, aunque no se siguen los enlaces simbólicos. &appname; usa la <ulink url="http://developer.kde.org/~wheeler/taglib.html"
>librería TagLib</ulink
> para leer los metadatos de archivos de audio, y así puede importar datos desde cualquier tipo de archivo que entienda TagLib. </para>

</sect2>

<sect2 id="importing-alexandria">
<title
>Importar bibliotecas Alexandria</title>

<para
><application
><ulink url="http://alexandria.rubyforge.org"
>Alexandria</ulink
></application
> es un gestor alternativo de colecciones de libros para el entorno de escritorio <ulink url="http://www.gnome.org"
>GNOME</ulink
>. El importador ofrece la opción de importar cualquiera de las bibliotecas encontradas en <filename class="directory"
>$<envar
>HOME</envar
>/.alexandria/</filename
>. </para>

</sect2>

<sect2 id="importing-amc">
<title
>Importar datos de Ant Movie Catalog</title>

<para
><application
><ulink url="http://www.antp.be/software/moviecatalog/"
>Ant Movie Catalog</ulink
></application
> es un gestor alternativo de colecciones de películas. </para>

</sect2>

<sect2 id="importing-bibtex">
<title
>Importar datos de Bibtex</title>

<para
><ulink url="http://en.wikipedia.org/wiki/Bibtex"
>Bibtex</ulink
> es un formato de bibliografía usado con el sistema de preparación de documentos LaTeX. Se pueden incluir varios tipos de referencias bibliográficas en el archivo. &appname; importa archivos bibtex como una colección bibliográfica. </para>

<para
>Si el importador bibtex encuentra campos en el archivo que no están en la colección de bibliografía predeterminada, se añadirán como campos de <link linkend="line"
>texto sencillo</link
>, con dos excepciones. Si el valor del campo contiene más de 100 caracteres, se convierte en un campo de <link linkend="para"
>Párrafo</link
>. Si el valor del campo parece contener una &URL; o una referencia de archivo, entonces se crea un campo <link linkend="url"
>&URL;</link
>. &appname; usa una copia interna de la <ulink url="http://www.gerg.ca/software/btOOL/"
>librería btparse</ulink
> para analizar sintácticamente los archivos bibtex. </para>
</sect2>

<sect2 id="importing-bibtexml">
<title
>Importar datos de Bibtexml</title>

<para
><ulink url="http://bibtexml.sf.net"
>Bibtexml</ulink
> es una representación &XML; de datos de bibtex, y los datos de los archivos bibtexml importados se tratan de la misma forma que los datos de bigbtex. </para>
</sect2>

<sect2 id="importing-delicious-library">
<title
>Importar datos de Delicious Library</title>

<para
><application
><ulink url="http://www.delicious-monster.com/"
>Delicious Library</ulink
></application
> es un gestor alternativo de colecciones para el escritorio de &Mac; OS X. &appname; importa un subconjunto de los datos utilizados por Delicious Library. </para>
</sect2>

<sect2 id="importing-gcstar">
<title
>Importar datos de GCstar</title>

<para
><application
><ulink url="http://www.gcstar.org"
>GCstar</ulink
></application
> es un gestor alternativo de colecciones. Actualmente admite colecciones de libros, películas, música, monedas, juegos, juegos de tablero y vinos. </para>

<para
>&appname; también puede importar archivos de datos de <application
>GCfilms</application
>. <application
><ulink url="http://home.gna.org/gcfilms/"
>GCfilms</ulink
></application
> es el predecesor de <application
>GCstar</application
>, y era un gestor alternativo de colecciones de películas. Normalmente, los archivos de datos de <application
>GCfilms</application
> se encuentran en <filename class="directory"
>$<envar
>HOME</envar
>/.local/share/gcfilms/</filename
>. </para>

</sect2>

<sect2 id="importing-griffith">
<title
>Importar datos de Griffith</title>

<para
><application
><ulink url="http://griffith.berlios.de/"
>Griffith</ulink
></application
> es un gestor alternativo de colecciones de vídeo. &appname; puede importar la mayoría de datos desde una base de datos Griffith. </para>
</sect2>

<sect2 id="importing-mods">
<title
>Importar datos MODS</title>

<para
><acronym
><ulink url="http://www.loc.gov/standards/mods/"
>MODS</ulink
></acronym
> es un formato para representar varios tipos de colecciones. actualmente, &appname; sólo importa libros como colección de bibliografía. </para>

</sect2>

<sect2 id="importing-pdf">
<title
>Importar datos PDF</title>
<para
>Si &appname; se ha compilado con <emphasis
>exempi</emphasis
> o <emphasis
>poppler</emphasis
>, se podrán importar los metadatos de los archivos PDF. Los metadatos pueden incluir información del título, el autor y la fecha, además de identificadores bibliográficos que se utilizarán para actualizar otra información. </para>
</sect2>

<sect2 id="importing-ris">
<title
>Importar datos RIS</title>
<para
>El formato <ulink url="http://www.adeptscience.co.uk/kb/article/A626"
> <acronym
>RIS</acronym
></ulink
> es un formato de archivo bibliográfico usado por la aplicación <application
>Reference Manager</application
> y por otras. &appname; importa archivos RIS como colección bibliográfica. </para>
</sect2>

<sect2 id="importing-referencer">
<title
>Importar datos de Referencer</title>
<para
><application
><ulink url="http://icculus.org/referencer/"
>Referencer</ulink
></application
> es un organizador de documentos y gestor de bibliografía para el escritorio GNOME. &appname; importa la mayoría de los datos encontrados en una base de datos de Referencer. </para>
</sect2>

<sect2 id="importing-file-listing">
<title
>Importar listados de archivos</title>

<para
>La mejor manera de crear un <link linkend="file-catalog"
>Catálogo de archivos</link
> es importar los contenidos de una carpeta. La carpeta puede examinarse recursivamente para añadir todos los archivos encontrados dentro. El importador es más útil para listados de copias de respaldo y para catalogar archivos de medios, como listados de &CD; o <acronym
>DVD</acronym
>. Además, se puede generar las vistas previas de los contenidos del archivo, aunque puede llevar algún tiempo leer un gran número de archivos. Las vistas previas son las mismas que las que se muestran en el gestor de archivos de &kde;. </para>
</sect2>

<sect2 id="importing-xslt">
<title
>Importar datos &XML; vía XSLT</title>

<para
>Cualquier archivo &XML; se puede importar a &appname;, siempre que la hoja de estilo &XML; esté dispuesta a convertir el archivo al formato de &appname;. &appname; carga automáticamente la hoja de estilo y ejecuta el procesamiento &xslt; necesario para cargar el archivo. </para>
</sect2>

</sect1>

<sect1 id="drag-n-drop">
<title
>Arrastrar y soltar</title>

<para
>Arrastrar archivos de datos a la ventana principal de &appname; y soltarlos importará los archivos, de la misma forma que si se hubiera seleccionado la <link linkend="importing"
>orden de importar</link
> desde un menú. Arrastrar y soltar funciona para los siguientes tipos de archivos: Tellico, Bibtex, RIS, and PDF. También se admite la importación de múltiples archivos a la vez.</para>

<para
>Así que, por ejemplo, si desea catalogar varios <link linkend="importing-pdf"
>archivos PDF</link
>, selecciónelos en el gestor de archivos y arrástrelos a la ventana de &appname;. &appname; importará tantos metadatos de los archivos como pueda, y después buscará información adicional de varias fuentes configuradas de internet.</para>

</sect1>

<sect1 id="exporting">
<title
>Exportar datos</title>

<para
>Cuando se exporten los datos de la colección, los valores de entrada pueden exportarse como se han introducido, o con el <link linkend="field-formatting"
>formato  automático</link
> proporcionado por &appname;. Además, la exportación puede estar limitada a las entradas seleccionadas actualmente en la colección, donde la <link linkend="status-bar"
>barra de estado</link
> muestra el número de entradas seleccionadas. </para>

<para
>Los archivos de texto exportados, como Bibtex o CSV, pueden usar la codificación de caracteres Unicode (UTF-8), o la codificación local del sistema operativo. </para>

<screenshot>
<screeninfo
>Opciones generales de exportación</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-options.png"/></imageobject>
<textobject
><phrase
>Opciones generales de exportación</phrase
></textobject>
</mediaobject>
</screenshot>

<sect2 id="exporting-xml">
<title
>Exportar &XML;</title>

<para
>El formato de archivo para los datos de &appname; es un archivo &XML; comprimido. Exportar a &XML; simplemente crea el archivo &XML; sin comprimirlo. Las imágenes se pueden incluir en el archivo &XML; como datos codificados en base 64 en un elemento de imagen, pero hacerlo así puede crear archivos de texto muy grandes. </para>
</sect2>

<sect2 id="exporting-zip">
<title
>Exportar zip</title>

<para
>El formato de archivo estándar para &appname; es un archivo comprimido, que contiene el archivo &XML; de la colección y, opcionalmente, todas las imágenes a las que se hace referencia en la misma. Si las imágenes, por el contrario,  se están almacenando en la carpeta de la aplicación, exportarlas a un archivo Zip creará un archivo de datos autocontenido, que incluirá todas las imágenes de la colección. </para>
</sect2>

<sect2 id="exporting-html">
<title
>Exportar &HTML;</title>

<para
>La exportación &HTML; usa la misma hoja de estilo <filename
>tellico2html.xsl</filename
>. Las imágenes se exportan a una carpeta con el mismo nombre que el archivo &HTML; exportado, con <emphasis
><filename
>_files</filename
></emphasis
> adjuntado. </para>

<para
>El formato por defecto es similar a la salida impresa, y permite varias opciones para modificar el &HTML;. Las cabeceras de los campos pueden ser impresas en la parte superior de cada columna, pero por desgracia &kde; no permite aún que las cabeceras de tabla se repitan en cada página. Las entradas pueden también ser agrupadas como en la <interface
>Vista de grupo</interface
>. </para>

<para
>Adicionalmente, se pueden crear archivos individuales para cada entrada de la colección, con enlaces creados en el archivo &HTML; de nivel superior. Los archivos de entrada se crearán en la misma carpeta que las imágenes. Los archivos &HTML; de entrada usarán la plantilla de hoja de estilo actual, como se muestra en la <interface
>Vista de entrada</interface
>. </para>

<screenshot>
<screeninfo
>Opciones de exportación de &HTML;</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-html.png"/></imageobject>
<textobject
><phrase
>Opciones de exportación de &HTML;</phrase
></textobject>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="exporting-csv">
<title
>Exportar CSV</title>

<para
>Los valores separados por comas (CSV) son una manera común de importar y exportar datos tabulares. El valor de cada campo está separado por una coma, con una o dos entradas por línea. Los títulos de campo pueden incluirse como cabeceras en la primera línea. Cualquier otro carácter o cadena de caracteres diferente a una coma se puede usar para delimitar los campos. </para>

<screenshot>
<screeninfo
>Opciones de exportación de CSV</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-csv.png"/></imageobject>
<textobject
><phrase
>Opciones de exportación de CSV</phrase
></textobject>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="exporting-pilotdb">
<title
>Exportar Pilot-DB</title>

<para
><ulink url="http://pilot-db.sourceforge.net"
>Pilot-DB</ulink
> es un formato de base de datos para &PalmOS; Varias aplicaciones de escritorio pueden leer y escribir archivos Pilot-DB. Los archivos <literal role="extension"
>.pdb</literal
> exportados se pueden transferir a una PDA y ser usados directamente. Por el momento, &appname; no puede importar archivos Pilot-DB. </para>

<screenshot>
<screeninfo
>Opciones de exportación de Pilot-DB</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-pdb.png"/></imageobject>
<textobject
><phrase
>Opciones de exportación de Pilot-DB</phrase
></textobject>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="exporting-alexandria">
<title
>Exportar Alexandria</title>

<para
><application
><ulink url="http://alexandria.rubyforge.net"
>Alexandria</ulink
></application
> es un gestor de colecciones de libros para el entorno de escritorio <ulink url="http://www.gnome.org"
>GNOME</ulink
>. &appname; puede exportar un subconjunto limitado de campos de las colecciones de libros a la localización por defecto de los datos de Alexandria. </para>

</sect2>

<sect2 id="exporting-onix">
<title
>Exportar ONIX</title>

<para
><ulink url="http://www.editeur.org/onix.html"
>ONIX</ulink
> es un formato &XML; para representar y comunicar información sobre productos de la industria del libro, principalmente para vendedores de libros. &appname; puede exportar colecciones de libros usando un pequeño subconjunto de ONIX. </para>

</sect2>

<sect2 id="exporting-bibtex">
<title
>Exportar Bibtex</title>

<para
>Cuando se exporta a <ulink url="http://en.wikipedia.org/wiki/Bibtex"
>Bibtex</ulink
>, los valores de los campos pueden escaparse con paréntesis o comillas. Si se están utilizando macros de cadena en esta colección, opcionalmente pueden exportarse como macros o expandirse. Para los campos de &URL;, &appname; puede incluir los valores del campo con la etiqueta <literal
>\url{...}</literal
>. Finalmente, las entradas sin clave de cita pueden ser obviadas, más que hacer que &appname; autogenere la clave. </para>

<screenshot>
<screeninfo
>Opciones de exportación de Bibtex</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-bibtex.png"/></imageobject>
<textobject
><phrase
>Opciones de exportación de Bibtex</phrase
></textobject>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="exporting-bibtexml">
<title
>Exportar Bibtexml</title>

<para
><ulink url="http://bibtexml.sourceforge.net"
>Bibtexml</ulink
> es un formato para representar datos de bibtex vía &XML;. </para>

</sect2>

<sect2 id="exporting-gcfilms">
<title
>Exportar GCfilms</title>

<para
><application
><ulink url="http://home.gna.org/gcfilms/"
>GCfilms</ulink
></application
> es otro gestor de colecciones de películas. &appname; puede exportar un subconjunto limitado de campos de colecciones de video a un archivo de datos de GCfilms. </para>

</sect2>

<sect2 id="exporting-xslt">
<title
>Exportar &XML; vía &xslt;</title>

<para
>Finalmente, &appname; puede procesar su representación interna en &XML; de los datos de la colección a través de una hoja de estilo &XML; externa antes de exportarlos. Este tipo de exportación puede ser útil para generar informes de texto u otros tipos de archivo. </para>
</sect2>

</sect1>

<sect1 id="citations">
<title
>Trabajar con citas</title>
<para
>Cuando trabaje con una <link linkend="bibliography"
>bibliografía</link
>, se pueden generar citas a partir de las entradas actualmente seleccionadas y usarse en otras aplicaciones. Una cita en formato bibtex puede copiarse al portapapeles, y después pegarse en un archivo latex. las citas de Bibtex también pueden incluirse en una aplicación externa como <application
>LyX</application
> o <application
>Kile</application
>, utilizando el llamado <emphasis
><link linkend="hidden-bibtex-options"
>lyxpipe</link
></emphasis
>. </para>

</sect1>

</chapter>