diff options
Diffstat (limited to 'tde-i18n-es/docs/kdeutils/kedit/index.docbook')
-rw-r--r-- | tde-i18n-es/docs/kdeutils/kedit/index.docbook | 1918 |
1 files changed, 1918 insertions, 0 deletions
diff --git a/tde-i18n-es/docs/kdeutils/kedit/index.docbook b/tde-i18n-es/docs/kdeutils/kedit/index.docbook new file mode 100644 index 00000000000..e193592f10b --- /dev/null +++ b/tde-i18n-es/docs/kdeutils/kedit/index.docbook @@ -0,0 +1,1918 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&kedit;"> + <!ENTITY package "kdeutils"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % Spanish "INCLUDE"> +]> + +<book lang="&language;"> +<bookinfo> +<title +>El manual de &kedit;</title> +<authorgroup> + +<author +><firstname +>Thad</firstname +><surname +>McGinnis</surname +> <affiliation +> <address +><email +>ctmcginnis@compuserve.com</email +></address> +</affiliation> +</author> + +<othercredit role="reviewer" +><firstname +>Lauri</firstname +> <surname +>Watts</surname +> <affiliation +><address +><email +>lauri@kde.org</email +></address +></affiliation> +<contrib +>Revisor</contrib> +</othercredit> +</authorgroup> + +<date +>2003-09-16</date> +<releaseinfo +>1.3</releaseinfo> + +<legalnotice +>&FDLNotice;</legalnotice> + +<abstract +><para +>Este manual describe &kedit;, un editor de texto sencillo para &kde;.</para +> </abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>KEdit</keyword> +<keyword +>editor de texto</keyword> +</keywordset> + +<copyright> +<year +>2000</year> +<holder +>Thad McGinnis</holder> +</copyright> + +</bookinfo> + +<chapter id="introduction"> +<title +>Introducción</title> + +<para +>&kedit; es un editor de texto para el escritorio &kde;. Es un pequeño editor que puede ser usado con &konqueror; para navegar por archivos de texto y de configuración. &kedit; también sirve para crear pequeños documentos de texto plano. No está pensado para ser un editor de programadores, y en particular no está pensado para reemplazar a ningún editor más potente, como &kate;, <application +>XEmacs</application +> o <application +>Emacs</application +>. La funcionalidad de &kedit; está limitada intencionadamente para asegurar un comienzo razonablemente rápido.</para> + +</chapter> + +<chapter id="on-screen-fundamentals" +> +<title +>Opciones elementales</title +> + +<para +>&kedit; es muy sencillo de usar. Cualquiera que haya usado un editor de texto no debería de tener problemas. </para> + +<sect1 id="drag-and-drop"> +<title +>Arrastrar y soltar</title +> + +<para +>&kedit; usa el protocolo arrastrar y soltar de &kde;. Se puede arrastrar y soltar archivos sobre &kedit; desde el escritorio, &konqueror;, o desde un sitio &FTP; remoto abierto en una ventana de &konqueror;. </para> + +</sect1 +> + +<sect1 id="command-line-options" +> +<title +>Línea de comando</title +> + +<para +>Aunque &kedit;, será lanzado más frecuentemente desde el menú de programas de &kde; o desde un icono del escritorio, también puede ser lanzado desde la línea de comando de una ventana de terminal. En este caso, se dispone de algunas opciones útiles.</para> + +<sect2 id="specify-a-file" +> +<title +>Especificar un archivo</title +> + +<para +>Al especificar la ruta y el nombre de un archivo particular, el usuario puede hacer que &kedit; lo abra (o lo cree) inmediatamente tras ser iniciado. Esta opción se asemeja a lo siguiente:</para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kedit</command +> <replaceable +>/home/myhome/docs/myfile.txt</replaceable +></userinput +></screen> +</informalexample +> + +</sect2 +> + +<sect2 id="editing-files-on-the-internet" +> +<title +>Especificar un archivo de Internet</title +> + +<para +>El método arriba mencionado también puede ser usado para abrir archivos de Internet (si el usuario tiene una conexión activa en ese momento). Un ejemplo de esto sería:</para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kedit</command +> <replaceable +>ftp://ftp.kde.org/pub/kde/Welcome.msg</replaceable +></userinput +></screen> +</informalexample +> + +</sect2 +> + +<sect2 +> +<title +>Otras opciones de la línea de comando</title +> + +<para +>Se dispone de las siguientes opciones de ayuda en la línea de comando:</para +> + +<variablelist +> +<varlistentry +> +<term +><command +>kedit</command +> <option +>--help</option +></term +> +<listitem> +<para +>Lista las opciones más básicas disponibles en la línea de comando.</para> +</listitem +> +</varlistentry +> + +<varlistentry +> +<term +><command +>kedit</command +> <option +>--help-qt</option +></term +> +<listitem> +<para +>Lista las opciones disponibles para modificar la forma en que &kedit; interacciona con &Qt;.</para> +</listitem +> +</varlistentry +> + +<varlistentry +> +<term +><command +>kedit</command +> <option +>--help-kde</option +></term +> +<listitem> +<para +>Lista las opciones disponibles para modificar la forma en que &kedit; interacciona con &kde;.</para> +</listitem +> +</varlistentry +> + +<varlistentry +> +<term +><command +>kedit</command +> <option +>--help-all</option +></term +> +<listitem> +<para +>Lista todas las opciones de la línea de comando.</para> +</listitem> +</varlistentry +> + +<varlistentry +> +<term +><command +>kedit</command +> <option +>--author</option +></term +> +<listitem> +<para +>Muestra los autores de &kedit; en la ventana del terminal.</para> +</listitem +> +</varlistentry +> + +<varlistentry +> +<term +><command +>kedit</command +> <option +>--version</option +></term +> +<listitem> +<para +>Muestra información sobre las versiones de &Qt;, &kde; y &kedit;. También está disponible mediante <command +>kedit</command +> <option +>-V</option +></para> +</listitem +> +</varlistentry +> +</variablelist +> + +</sect2 +> + +</sect1 +> + +<sect1 id="keybindings"> +<title +>Accesos rápidos de teclado</title> + +<para +>Muchos de los accesos rápidos de teclado se pueden configurar desde el menú <link linkend="settings" +>Preferencias</link +>. por omisión, &kedit; dispone de los siguientes accesos rápidos de teclado:</para +> + +<informaltable> +<tgroup cols="2"> +<thead> +<row> +<entry +>Acceso rápido</entry> +<entry +>Acción</entry> +</row> +</thead> +<tbody> +<!-- Insert mode appears to have disappeared again +<row> +<entry +><keycap +>Insert</keycap +></entry> +<entry +><action +>Toggle between Insert and Overwrite mode.</action +></entry> +</row> +--> +<row> +<entry +><keycap +>Izquierda</keycap +></entry> +<entry +><action +>Mueve el cursor un carácter hacia la izquierda</action +></entry> +</row> + +<row> +<entry +><keycap +>Derecha</keycap +></entry> +<entry +><action +>Mueve el cursor un carácter hacia la derecha</action +></entry> +</row> + +<row> +<entry +><keycap +>Arriba</keycap +></entry> +<entry +><action +>Mueve el cursor una línea hacia arriba</action +></entry> +</row> + +<row> +<entry +><keycap +>Abajo</keycap +></entry> +<entry +><action +>Mueve el cursor una línea hacia abajo</action +></entry> +</row> + +<row> +<entry +><keycap +>Re Pág</keycap +></entry> +<entry +><action +>Mueve el cursor una página hacia atrás</action +></entry> +</row> + +<row> +<entry +><keycap +>Av Pág</keycap +></entry> +<entry +><action +>Mueve el cursor una página hacia adelante</action +></entry> +</row> + +<row> +<entry +><keycap +>Retroceso</keycap +></entry> +<entry +><action +>Borra el carácter a la izquierda del cursor</action +></entry> +</row> + +<row> +<entry +><keycap +>Inicio</keycap +></entry> +<entry +><action +>Mueve el cursor al principio de la línea</action +></entry> +</row> + +<row> +<entry +><keycap +>Fin</keycap +></entry> +<entry +><action +>Mueve el cursor al final de la línea</action +></entry> +</row> + +<row> +<entry +><keycap +>Supr</keycap +></entry> +<entry +><action +>Borra el carácter a la derecha del cursor</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Shift;<keycap +>Izquierda</keycap +></keycombo +></entry> +<entry +><action +>Extiende la selección de texto un carácter hacia la izquierda</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Shift;<keycap +>Derecha</keycap +></keycombo +></entry> +<entry +><action +>Extiende la selección de texto un carácter hacia la derecha</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>A</keycap +></keycombo +></entry> +<entry +><action +>Selecciona todo el texto del documento</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></entry> +<entry +><action +>Mueve el cursor un carácter hacia la izquierda</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></entry> +<entry +><action +>Copia el texto seleccionado en el portapapeles</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Ctrl; <keycap +>D</keycap +></keycombo +></entry> +<entry +><action +>Borra el carácter a la derecha del cursor</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>E</keycap +></keycombo +></entry> +<entry +><action +>Mueve el cursor al final de la línea</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></entry> +<entry +><action +>Busca un texto en el documento</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>L</keycap +></keycombo +></entry> +<entry +><action +>Ir a línea.</action +></entry> +</row> + + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>H</keycap +></keycombo +></entry> +<entry +><action +>Borra el carácter a la izquierda del cursor</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +></entry> +<entry +><action +>Crea un documento nuevo</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +><keycap +>Abajo</keycap +></keycombo +></entry> +<entry +><action +>Mueve el cursor una línea hacia abajo</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Ctrl; <keycap +>P</keycap +></keycombo +></entry> +<entry +><action +>Imprime el documento.</action +></entry> +</row> + +<row> +<entry +><keycombo +action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></entry> +<entry +><action +>Pega el texto del portapapeles en la posición del cursor en el documento</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></entry> +<entry +><action +>Corta el texto seleccionado, copiándolo al portapapeles</action +></entry> +</row> + +<row> +<entry +><keycombo action="simul" +>&Ctrl; <keycap +>G</keycap +></keycombo +></entry> +<entry +><action +>Va a un número de línea determinado en el documento</action +></entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</sect1> + +</chapter> + +<chapter id="the-menu-entries"> +<title +>Las entradas del menú</title> + +<sect1 id="file"> +<title +>El menú <guimenu +>Archivo</guimenu +></title> + +<variablelist> +<varlistentry> +<term +><anchor id="new"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +></shortcut +> <guimenu +>Archivo</guimenu +><guimenuitem +>Nuevo</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Comienza un nuevo documento en una nueva ventana del editor.</action +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="open"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>O</keycap +></keycombo +></shortcut +> <guimenu +>Archivo</guimenu +><guimenuitem +>Abrir...</guimenuitem +> </menuchoice +></term +> +<listitem> +<para +><action +>Este comando abre un archivo.</action +> Para hacer esto, muestra un diálogo que permite al usuario navegar por el sistema de archivos.</para> + +<para +>El diálogo funciona como un pequeño administrador de archivos. Haciendo clic en las carpetas mostradas en la ventana central, se entra en ellas y se muestra su contenido. Existe un campo de texto desplegable que puede ser usado para escribir directamente la ubicación y el nombre del archivo, o bien se puede hacer clic en la flecha lateral para elegir de entre una lista de archivos usados recientemente.</para> + +<para +>Debajo de esto hay un filtro en el que, del mismo modo, puede introducir datos directamente o elegirlos de una lista desplegable de tipos de filtro recientes. Los filtros permiten que solo se muestren en la ventana central los archivos que cumplan sus requisitos. Si el filtro contiene un texto como <literal role="extension" +> *.txt</literal +>, solo los archivos con la extensión txt serán visibles en la ventana de selección.</para> + +<para +>La barra de herramientas, entre otros, tiene dos botones de flecha izquierda y flecha derecha que permiten al usuario mover hacia atrás y hacia adelante a través de las carpetas previamente seleccionadas, así como un botón de flecha arriba para moverse hacia arriba en el árbol de carpetas. El botón con la casita lleva al usuario a su carpeta personal, y el que tiene las dos flechas curvadas sobre sí mismas actualiza la vista de la carpeta actual. El botón con el marcador permite al usuario poner una marca en la carpeta actual o ir a una previamente marcada. El botón de la carpeta con un destello le permite crear una nueva carpeta. Finalmente, existe una caja desplegable en la barra de herramientas con una lista de algunas carpetas comúnmente frecuentadas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="open-recent"/><menuchoice +><guimenu +>Archivo</guimenu +><guimenuitem +>Abrir reciente</guimenuitem +></menuchoice +> +</term> + +<listitem> +<para +><action +>Esto es un acceso rápido para abrir documentos guardados recientemente.</action +> Al hacer clic en este elemento se abre una lista al lado del menú con una lista de algunos de los archivos guardados más recientemente. Si se selecciona uno de ellos, se abrirá en &kedit; (si el archivo todavía está situado en la misma ubicación). </para> +</listitem +> +</varlistentry> + +<varlistentry +> +<term +><anchor id="save"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +></shortcut +> <guimenu +>Archivo</guimenu +><guimenuitem +>Guardar</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Guarda el documento actual.</action +> Si ya se había guardado antes, se sobreescribirá el archivo previamente guardado sin pedir permiso al usuario.</para> + +<note> +<para +>El editor se puede configurar para que haga <link linkend="backuppref" +>copias de respaldo</link +>.</para> +</note> + +<para +>Si es la primera vez que se guarda un documento nuevo, se mostrará un diálogo para guardar archivo (como el descrito anteriormente).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="save-as"/><menuchoice +><guimenu +>Archivo</guimenu +><guimenuitem +>Guardar como...</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Permite que un documento sea guardado con un nuevo nombre de archivo.</action +> Esto se realiza por medio del diálogo de archivo descrito en la sección <link linkend="open" +>Abrir</link +> de este manual.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="print"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +></shortcut +> <guimenu +>Archivo</guimenu +><guimenuitem +>Imprimir...</guimenuitem +></menuchoice +></term +> +<listitem> +<para +><action +>Abre un diálogo sencillo para imprimir, permitiendo al usuario especificar qué, dónde, y cómo imprimir.</action +> El usuario puede elegir entre el comando estándar <command +>lpr</command +> o entre otro personalizado, así como entre imprimir el documento entero o un trozo seleccionado.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="mail"/><menuchoice +><guimenu +>Archivo</guimenu +><guimenuitem +>Correo...</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Esto se usa para enviar el documento actual por correo electrónico.</action +> Llama a un diálogo de correo donde el usuario puede introducir el destinatario y el asunto del mensaje.</para> + +<para +>Debe seleccionar su cliente de correo electrónico favorito en &kcontrol;.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="close"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>W</keycap +> </keycombo +></shortcut +> <guimenu +>Archivo</guimenu +><guimenuitem +>Cerrar</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Cierra la ventana del editor.</action +> Si tiene más de una instancia de &kedit; abiertas, sus ventanas no serán cerradas.</para +> +</listitem +> +</varlistentry> + +<varlistentry> +<term +><anchor id="quit"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +> </keycombo +></shortcut +> <guimenu +>Archivo</guimenu +> <guimenuitem +>Salir</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Cierra el editor.</action +></para> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="edit"> +<title +>El menú <guimenu +>Editar</guimenu +></title> + +<variablelist> +<varlistentry> +<term +><anchor id="undo"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Deshacer</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Se usa para dar marcha atrás o eliminar la última operación o acción del usuario.</action +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="redo"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Rehacer</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Esto invertirá el cambio más reciente</action +> (si hay alguno) hecho usando <guimenuitem +>Deshacer</guimenuitem +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="cut"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Cortar</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Este comando borra la selección actual y la pone en el portapapeles.</action +> El portapapeles es una característica de &kde; que trabaja de modo transparente y proporciona un método de transferir datos entre aplicaciones.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="copy"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Copiar</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Esto copia el texto actualmente seleccionado en el portapapeles para que pueda ser pegado en cualquier otro lugar.</action +> El portapapeles es una característica de &kde; que trabaja de modo transparente y proporciona un método de transferir datos entre aplicaciones.</para +> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="paste"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Pegar</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Esto insertará el contenido del portapapeles en la posición del cursor.</action +> El portapapeles es una característica de &kde; que trabaja de modo transparente y proporciona un método de transferir datos entre aplicaciones.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="select-all"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Seleccionar todo</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Esto seleccionará el documento entero.</action +> Esto puede resultar útil para copiar el archivo completo a otra aplicación.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="find"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Buscar...</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Abre de diálogo de búsqueda</action +> que se usa para especificar el texto que se quiere <guilabel +>buscar</guilabel +> en el documento. En él hay un campo de texto para introducir el patrón de búsqueda. Se incluyen otras dos opciones para hacer la búsqueda más eficiente. Si se selecciona <guilabel +>Distinguir mayúsculas/minúsculas</guilabel +> sólo se encontrarán entradas que coincidan exactamente con el texto introducido, teniendo en cuenta las letras mayúsculas y las minúsculas. <guilabel +>Buscar hacia atrás</guilabel +> hace que se realice la búsqueda en sentido ascendente dentro del documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="find-again"/><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Buscar siguiente</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Repite la última operación de búsqueda, si se definió alguna, sin llamar al diálogo de búsqueda.</action +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="replace"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Editar</guimenu +><guimenuitem +>Reemplazar...</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Este comando abre el diálogo de sustitución.</action +> Este diálogo es similar al de búsqueda, excepto que dispone de un campo de texto <guilabel +>Reemplazar con:</guilabel +>. En este diálogo el usuario puede especificar el texto a encontrar y el texto con el que será sustituido. Este diálogo también contiene dos botones adicionales. El botón <guilabel +>Reemplazar</guilabel +>, que permite al usuario hacer una sustitución cada vez, lo que resulta útil cuando no se deban sustituir todas las concordancias con el texto buscado. El botón <guilabel +>Reemplazar todo</guilabel +> debe ser usado con precaución, ya que sustituirá de modo inmediato todas las concordancias con texto especificado.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="insertfile"/> +<menuchoice +><guimenu +>Editar</guimenu +><guimenuitem +>Insertar archivo...</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Muestra el diálogo <link linkend="open" +><guimenuitem +>Abrir</guimenuitem +></link +> <guimenu +>archivo</guimenu +> para que el usuario pueda <action +>insertar un archivo completo en el documento abierto.</action +> El archivo se insertará en la posición actual del cursor.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="insertdate"/> +<menuchoice +><guimenu +>Editar</guimenu +><guimenuitem +>Insertar fecha</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Esto pondrá la fecha actual en la posición del cursor.</action +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="cleanspaces"/> +<menuchoice +><guimenu +>Editar</guimenu +><guimenuitem +>Borrar espacios</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Al elegir esta opción se borrará cualquier espacio extra y todos los saltos de línea (el código para el final de un párrafo proporcionado cada vez que se pulsa la tecla <keycap +>Intro</keycap +>) en el <emphasis +>texto seleccionado</emphasis +>. <action +>En otras palabras, cualquier sucesión de dos o más espacios será reducida a un único espacio; y todos los párrafos y líneas en blanco serán reducidos a un único párrafo.</action +></para +></listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="Go"> +<title +>El menú <guimenu +>Ir</guimenu +></title> + +<variablelist> +<varlistentry> +<term +><anchor id="go-to-line"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>L</keycap +></keycombo +></shortcut +> <guimenu +>Ir</guimenu +><guimenuitem +>Ir a línea...</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Muestra un diálogo para ir a una línea, que se usa para hacer que el cursor vaya a una línea concreta (especificada por su número) del documento.</action +> El número de línea puede ser introducido directamente en el campo de texto, o gráficamente, haciendo clic en los botones de las flechas que hay al lado del campo de texto. La flecha arriba incrementará el número de línea, y la flecha abajo lo decrementará.</para> +</listitem> +</varlistentry> +</variablelist> +</sect1> + +<sect1 id="tools"> +<title +>El menú <guimenu +>Herramientas</guimenu +></title> + +<variablelist> +<varlistentry> +<term +><anchor id="Spelling..."/><menuchoice +><guimenu +>Herramientas</guimenu +><guimenuitem +>Ortografía...</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Inicia el programa de comprobación ortográfica, designado para ayudar al usuario a descubrir y corregir cualquier error ortográfico.</action +> Al hacer clic en esta en esta opción, se comenzará la comprobación y se mostrará un diálogo mediante el cual el usuario puede controlar el proceso. En él hay tres campos de texto alineados verticalmente:</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Palabra mal escrita:</guilabel +></term> +<listitem> +<para +>Aquí, el corrector ortográfico muestra la palabra que se está considerando actualmente. Se mostrará una palabra cuando el corrector no la encuentre en su diccionario (un archivo que contiene una lista de palabras ortográficamente correctas con las que se compara cada palabra del editor).</para +> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Reemplazo:</guilabel +></term> +<listitem> +<para +>Si el corrector tiene palabras similares en su diccionario, la primera de ellas se mostrará aquí. El usuario puede aceptar la sugerencia, escribir su propia palabra corregida, o escoger otra sugerencia distinta del siguiente campo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sugerencias:</guilabel +></term> +<listitem> +<para +>El corrector puede listar aquí varias alternativas posibles para reemplazar la palabra que se está considerando. Al hacer clic sobre cualquiera de las sugerencias, la palabra seleccionada se copiará en el anterior campo <guilabel +>Reemplazo:</guilabel +>.</para> +</listitem> +</varlistentry> +</variablelist> + +<para +>En el diálogo también hay 8 botones que permiten al usuario controlar el proceso de corrección ortográfica:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Reemplazar</guibutton +></term> +<listitem> +<para +>Este botón hace que el corrector sustituya la palabra considerada en el documento con la palabra del campo <guilabel +>Reemplazo:</guilabel +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Reemplazar todo</guibutton +></term> +<listitem> +<para +>Este botón hace que el corrector sustituya no solo la actual <guilabel +>Palabra mal escrita:</guilabel +>, sino que haga automáticamente la misma sustitución en todas las apariciones de esta <guilabel +>Palabra mal escrita:</guilabel +> en el documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Ignorar</guibutton +></term> +<listitem> +<para +>Al pulsar este botón, el corrector ignorará la actual <guilabel +>Palabra mal escrita:</guilabel +> y no hará ningún cambio.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Ignorar todo</guibutton +></term> +<listitem> +<para +>Este botón hace que el corrector no haga nada con la actual <guilabel +>Palabra mal escrita:</guilabel +> y que la ignore en el resto del documento.</para> + +<note> +<para +>Esto se aplica únicamente al proceso de corrección actual. Si el corrector se vuelve a ejecutar de nuevo más tarde, se detendrá en esta misma palabra.</para> +</note> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Añadir</guibutton +></term> +<listitem> +<para +>Al pulsar este botón se añade la palabra que hay en el campo <guilabel +>Palabra mal escrita:</guilabel +> al diccionario del corrector. Esto significa que en el futuro el corrector siempre considerará que esta palabra es ortográficamente correcta.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Ayuda</guibutton +></term> +<listitem> +<para +>Esto invoca al sistema de ayuda de &kde; para que muestre el manual de &kedit; (este documento).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Detener</guibutton +></term> +<listitem> +<para +>Este botón detiene el proceso de comprobación ortográfica.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Cancelar</guibutton +></term> +<listitem> +<para +>Este botón cancela el proceso de comprobación ortográfica.</para> +</listitem> +</varlistentry> +</variablelist> + +<para +>Situada horizontalmente a lo largo de la parte inferior del diálogo de comprobación ortográfica hay una barra de progreso. A medida que el proceso de comprobación avanza, esta barra se irá rellenando desde la izquierda hacia la derecha, proporcionando una representación gráfica de la porción del documento que ya se ha comprobado.</para> + +<note> +<para +>Al mismo tiempo, también se muestra en la barra de estado del editor una indicación numérica del proceso del comprobación ortográfica. La <link linkend="show-statusbar" +>barra de estado</link +> es la tira horizontal en la parte inferior del editor que hay fuera del área del texto.</para> +</note> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="settings"> +<title +>El menú <guimenu +>Preferencias</guimenu +></title> + +<variablelist> +<varlistentry> +<term +><anchor id="show-toolbar"/><menuchoice +><guimenu +>Preferencias</guimenu +><guimenuitem +>Mostrar barra de herramientas</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Cuando esta opción está marcada, se muestra una barra de herramientas que se puede mover y que contiene botones que se usan para iniciar algunos comandos frecuentemente usados. La barra de herramientas suele estar situada en la parte superior del editor, debajo del menú. Cuando esta opción no está marcada, la barra de herramientas está oculta.</action +> Al hacer clic sobre el icono estriado en el extremo de la barra se causará que ésta se muestre o se oculte. Al hacer clic y arrastrar este mismo icono se permite al usuario mover la barra.</para +> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="show-statusbar"/><menuchoice +><guimenu +>Preferencias</guimenu +><guimenuitem +>Mostrar barra de estado</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Cuando esta opción está marcada, se muestra una pequeña barra en la parte inferior del editor que contiene información sobre el estado del documento actual. Cuando no está marcada, la barra de estado está oculta.</action +> </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="save-options"/><menuchoice +><guimenu +>Preferencias</guimenu +><guimenuitem +>Guardar preferencias</guimenuitem +></menuchoice +></term> +<listitem> +<para +><action +>Guarda las preferencias actuales del editor para que también sean usadas en futuros documentos.</action +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="configure-keybindings"/><menuchoice +><guimenu +>Preferencias</guimenu +><guimenuitem +>Configurar accesos rápidos...</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Este comando abre un diálogo mediante el que se pueden modificar los <link linkend="keybindings" +>accesos rápidos de teclado</link +>. Una ventana en la parte superior del diálogo muestra una lista de los comandos disponibles. Debajo de ella hay tres botones de radio. El usuario puede escoger un acceso rápido entre <guilabel +>Ninguno</guilabel +>, <guilabel +>Predeterminado</guilabel +> y <guilabel +>Personalizar</guilabel +>.</para> + +<note> +<para +>Tenga en cuenta que un conjunto de botones de radio sólo permite la selección de uno de los elementos disponibles, del mismo modo que los botones de una radio solo permiten la selección de una única emisora. Además, la selección <guilabel +>Predeterminado</guilabel +> solo está disponible para los comandos que actualmente posean un acceso <quote +>por omisión</quote +>.</para> +</note> + +<para +>Al seleccionar la opción <guilabel +>Personalizar</guilabel +> se muestra un nuevo diálogo en el que el usuario puede especificar un método <guilabel +>Primario</guilabel +> y un método <guilabel +>Alternativo</guilabel +> para el acceso rápido de teclado. El usuario puede pulsar una combinación de teclas para el comando en cuestión, que será mostrada en el cuadro que contiene la combinación de teclas actualmente activa para ese comando (y el diálogo se cerrará en este momento si está marcada la opción <guilabel +>Auto-cierre</guilabel +>). Se dispone de la opción <guilabel +>Tecla múltiple</guilabel +>, que permite seleccionar como acceso rápido una combinación de varias teclas, como &Ctrl;+<keycap +>Z</keycap +>, <keycap +>A</keycap +>. </para> +</listitem> +</varlistentry> +<varlistentry> + +<term +><anchor id="configure-toolbars"/><menuchoice +><guimenu +>Preferencias</guimenu +><guimenuitem +>Configurar barras de herramientas...</guimenuitem +></menuchoice +></term> + +<listitem> +<para +><action +>Abre un diálogo donde se puede modificar la configuración de la barra de herramientas.</action +> El usuario puede escoger qué botones deben aparecer en la barra de herramientas. En la parte de la izquierda hay una ventana con una lista de los botones disponibles, y en la parte de la derecha hay otra lista con los botones que existen actualmente en la barra de herramientas. Un conjunto de cuatro botones con flechas entre las dos listas permite manipular la selección. La flecha hacia la derecha pone el comando seleccionado en la lista de la izquierda en la lista de la derecha, es decir, lo añade a la barra de herramientas. La flecha hacia la izquierda hace exactamente lo contrario, eliminando la selección de la lista de la derecha de la barra de herramientas. Las flechas hacia arriba y hacia abajo cambian la posición de la acción seleccionada en la lista de la derecha, lo que cambia la posición del correspondiente botón en la barra de herramientas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="preferences"/><menuchoice +><guimenu +>Preferencias</guimenu +><guimenuitem +>Configurar KEdit...</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Abre un diálogo donde se pueden ajustar algunas <link linkend="pref-dialog" +>preferencias</link +>.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="help"> +<title +>El menú <guimenuitem +>Ayuda</guimenuitem +></title> +&help.menu.documentation; </sect1> +</chapter> + +<chapter id="pref-dialog"> +<title +>El diálogo de preferencias</title> + +<para +>Al seleccionar <menuchoice +><guimenu +>Preferencias</guimenu +> <guimenuitem +>Configurar KEdit</guimenuitem +></menuchoice +> en el menú se muestra el diálogo de preferencias. Este diálogo se puede usar para alterar varias preferencias. Las preferencias disponibles variarán según qué categoría seleccione el usuario en la lista vertical que hay a la izquierda del diálogo. El usuario puede controlar el proceso por medio de los cinco botones que hay en la parte inferior del diálogo. Con ellos se puede llamar al sistema de <guilabel +>Ayuda</guilabel +>, establecer las opciones a sus valores por <guilabel +>Defecto</guilabel +>, <guilabel +>Aceptar</guilabel +> las preferencias actuales y cerrar el diálogo, <guibutton +>Aplicar</guibutton +> las preferencias actuales al documento sin cerrar el diálogo, o <guibutton +>Cancelar</guibutton +> el proceso. Las categorías <guilabel +>Fuente</guilabel +>, <guilabel +>Colores</guilabel +>, <guilabel +>Ortografía</guilabel +>, y <guilabel +>Varios</guilabel +> se detallan a continuación.</para> + +<sect1 id="preffont"> +<title +>Fuente</title> + +<para +>El diálogo de preferencias se abre en esta categoría. Aquí, el usuario puede modificar cuatro preferencias y ver los efectos de cualquier cambio en el texto de muestra visualizado en el rectángulo que hay en la parte inferior del diálogo. Las preferencias son:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Fuente:</guilabel +></term> +<listitem> +<para +>Esta lista permite al usuario seleccionar una fuente de caracteres por su nombre de entre todas las disponibles. El aspecto de la fuente seleccionada se puede comprobar en el texto de muestra visible en la parte inferior del diálogo.</para +> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Estilo de la fuente:</guilabel +></term> +<listitem> +<para +>En esta lista, el usuario puede elegir entre cuatro estilos básicos para la fuente de caracteres: normal, cursiva, negrita y negrita cursiva. El aspecto del estilo seleccionado se puede comprobar en el texto de muestra visible en la parte inferior del diálogo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Tamaño:</guilabel +></term> +<listitem +> +<para +>La lista de selección que está a la derecha del diálogo permite modificar el tamaño de la fuente de caracteres. Cuanto mayor sea el número elegido, más grande será el tamaño de la fuente. El texto de muestra visible en la parte inferior del diálogo reflejará el tamaño seleccionado.</para +> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="prefcolors"> +<title +>Color</title> + +<para +>Esta sección proporciona acceso a <link linkend="pref-color-settings" +>dos preferencias de color diferentes</link +> descritas más abajo. Cada una de ellas puede ser modificada pulsando en su botón correspondiente. Estos son unos botones especiales que muestran el color seleccionado actualmente. Al hacer clic sobre ellos se muestra un diálogo especial para seleccionar un color.</para> + +<para +>El diálogo de color proporciona un modo gráfico conveniente para seleccionar un determinado color. En la parte superior izquierda hay un cuadro rectangular que muestra un espectro de colores. A su derecha hay una barra vertical que muestra un rango de intensidades que van desde el grado más oscuro (abajo) hasta el más luminoso (arriba). El usuario puede seleccionar y ajustar un color usando estos dos rectángulos. Al hacer clic en el cuadro de espectro se selecciona una mezcla particular de tonos rojo, verde y azul, y su nivel de intensidad se puede seleccionar haciendo clic en la barra vertical. Los distintos atributos de color se muestran en formato numérico en los pequeños campos de texto situados directamente debajo del cuadro de espectro. Estos atributos incluyen la mezcla de los componentes de color básicos (rojo, verde y azul), así como los niveles de tinte y saturación. De modo alternativo, el usuario puede introducir números directamente en estos campos de texto. También hay un cuadro en la parte inferior central del diálogo donde se muestra el color seleccionado en todo momento. A su derecha hay otro campo de texto etiquetado <guilabel +>HTML</guilabel +>, donde se muestra el código de color que se usaría para especificar el color seleccionado en código <acronym +>HTML</acronym +>, ampliamente usado en las páginas web.</para> + +<para +>Además de lo explicado, el diálogo de color permite la captura de cualquier color actualmente visible en el escritorio o en otro programa. Al hacer clic en el botón con el icono del cuentagotas (situado a la derecha del diálogo), la forma del cursor del ratón cambia a una cruz. Al hacer clic de nuevo en alguna parte, se tomarán los atributos de color del punto situado bajo la cruz.</para> + +<para +>Además, el usuario dispone de la opción de añadir cualquier color a una paleta de <guilabel +>Colores personales</guilabel +> al hacer clic en el botón etiquetado <guibutton +>Añadir a colores personales</guibutton +>. Esta paleta y el resto de paletas disponibles pueden ser mostradas usando la lista de selección desplegable situada directamente encima del cuadro de visualización de la paleta, en la parte superior derecha del diálogo. Junto a los colores personales, el usuario puede acceder a varias paletas predefinidas.</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Utilizar colores personalizados</guilabel +></term> +<listitem> +<para +>por omisión, &kedit; usará el esquema de colores de su sistema. Si se activa esta opción, podrá seleccionar el color de los caracteres y del fondo.</para> +</listitem> +</varlistentry> + +<varlistentry id="pref-color-settings"> +<term +><guilabel +>Color de los caracteres:</guilabel +></term> +<listitem> +<para +>Aquí, el usuario puede especificar un color para el texto usado en &kedit;.</para> +</listitem +> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Color del fondo:</guilabel +></term> +<listitem> +<para +>Aquí, el usuario puede especificar un color para el fondo de &kedit;.</para> +</listitem +> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="prefspellchecker"> +<title +>Ortografía</title +> + +<para +>Un corrector ortográfico es un programa destinado a ayudar al usuario a identificar y corregir cualquier error de ortografía. Esta sección del diálogo de preferencias permite ajustar ciertos parámetros clave relacionados con este aspecto.</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Crear combinaciones raíz/postfijo que no están en el diccionario</guilabel +></term> +<listitem> +<para +>Al seleccionar esta opción se permite al corrector ortográfico registrar como <quote +>correctas</quote +> combinaciones de raíces de palabras con sufijos o prefijos, incluso si una combinación particular no está listada en la base de datos de palabras de su diccionario. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Considerar palabras juntas como errores de ortografía</guilabel +></term> +<listitem> +<para +>Seleccionando esta opción el corrector ortográfico registrará como <quote +>incorrectas</quote +> dos o más palabras ortográficamente correctas que estén <quote +>juntas</quote +>, es decir, sin ningún espacio de separación entre ellas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Diccionario:</guilabel +></term +> +<listitem> +<para +>Dependiendo de la instalación del sistema del usuario, uno o más diccionarios ortográficos de distintas lenguas pueden estar disponibles. Esta lista desplegable permite al usuario escoger qué lenguaje usará el corrector ortográfico.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Codificación:</guilabel +></term +> +<listitem> +<para +>Existen diferentes sistemas de codificación que se usan para asociar códigos concretos con caracteres y símbolos particulares. Si el usuario sabe qué código está usando, se puede especificar mediante el uso de esta lista desplegable de modo que el corrector ortográfico pueda hacer su trabajo de forma correcta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Cliente:</guilabel +></term +> +<listitem> +<para +>Debido a que &kedit; no contiene su propio corrector ortográfico, se debe seleccionar uno externo. Aquí es donde el usuario puede especificar qué programa de corrección de ortografía se va a usar.</para +> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="prefmisc"> +<title +>Varios</title> + +<para +>Esta categoría trata de tres propiedades distintas que se detallan a continuación:</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Ajustar línea:</guilabel +></term> +<listitem> +<para +>El ajuste de líneas es una característica que causa que el editor comience una nueva línea de texto de forma automática y mueva el cursor al inicio de esta nueva línea. La lista desplegable de la parte superior del diálogo permite las tres formas siguientes de ajuste:</para> + +<variablelist> +<varlistentry> +<term +>Desactivar el ajuste de línea</term> +<listitem> +<para +>Al escoger esta opción no se permitirá al editor hacer ningún ajuste de línea. El usuario tendrá que comenzar las nuevas líneas manualmente (mediante el uso de la tecla <keycap +>Intro</keycap +>).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Ajuste suave</term> +<listitem> +<para +>Esta elección permite que el editor ajuste automáticamente la longitud de las líneas para que quepan en la anchura de su ventana. En otras palabras, cuanto mayor sea la ventana del editor, más largas serán las líneas de texto; y cuanto menor sea la ventana, más cortas serán las líneas. Estos finales de línea no se guardan en el archivo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>A la columna especificada</term> +<listitem> +<para +>Al seleccionar esto se activa un campo de texto inmediatamente debajo, con la etiqueta <guilabel +>Ajustar columna:</guilabel +>. Aquí, el usuario puede especificar el número máximo de caracteres en una línea de texto. </para +> + +<note> +<para +>Cada carácter, incluídos los espacios, se contabiliza como una columna.</para> +</note> +</listitem> + +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term id="backuppref" +><guilabel +>Hacer copia de seguridad al guardar el archivo</guilabel +></term> +<listitem> +<para +>Marcando esta opción el editor renombrará la última versión guardada del documento actual antes de llevar a cabo la orden de <command +>guardar</command +>. El editor hace esto añadiendo una tilde (<keycap +>~</keycap +>) al final del nombre del archivo original. De este modo, el usuario tiene la oportunidad de recuperar un documento si ha guardado por error alguna otra cosa sobre él.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect1> + +</chapter> + +<chapter id="credits"> +<title +>Créditos y licencias</title> + +<para +>Copyright de &kedit; 2000 por Bernd Johannes Wuebben <email +>wuebben@math.cornell.edu</email +></para> + +<para +>Copyright de la documentación 2000 por Thad McGinnis <email +>ctmcginnis@compuserve.com</email +>.</para> + +<para +>Esta versión del manual de &kedit; está basada en la original por: Bernd Johannes Wuebben <email +>wuebben@math.cornell.edu</email +></para> + +<para +>Traducido por Eloy Cuadra <email +>ecuadra@eloihr.net</email +></para +> +&underFDL; &underGPL; </chapter> + +<appendix id="installation"> +<title +>Instalación</title +> + +&install.intro.documentation; +&install.compile.documentation; + +</appendix> + +</book> + +<!-- +Local Variables: +mode: sgml +sgml-minimize-attributes:nil +sgml-general-insert-case:lower +sgml-indent-step:0 +sgml-indent-data:nil +End: + +// vim:ts=2:sw=2:tw=78:noet +--> |