calibre - en to es translation catalogue (36 entries)

en: Snippets
es: Fragmentos

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
es: El editor de libros electrónicos de calibre admite *fragmentos*. Un fragmento es una porción de texto que se reutiliza a menudo o contiene gran cantidad de texto redundante. El editor le permite insertar un fragmento con unas pocas pulsaciones de tecla. Por ejemplo, supongamos inserta a menudo etiquetas de enlace cuando modifica archivos HTML, entonces podrá escribir simplemente ``<a`` en el editor y pulsar |ct|. El editor lo expandirá a::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
es: No sólo eso, la palabra ``filename`` estará seleccionada, con el cursor sobre ella, para que pueda teclear el nombre de archivo real usando la función :ref:`editor_auto_complete` del editor. Y una vez que haya terminado de escribir el nombre de archivo, pulse |ct| de nuevo y el cursor saltará a la posición entre las etiquetas ``<a>`` para que pueda teclear directamente el texto par el enlace.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
es: El sistema de fragmentos del editor es muy sofisticado, hay algunos fragmentos predefinidos y puede crear otros adecuados para su estilo de modificación.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
es: La siguiente discusión sobre los fragmentos predefinidos debería ayudar a ilustrar la potencia del sistema de fragmentos.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
es: También puede usar fragmentos en los campos de entrada de texto del panel :guilabel: `Buscar y sustituir`, pero los marcadores de posición (para pasar por ellos usando |ct|) no funcionarán.

en: The built-in snippets
es: Los fragmentos predefinidos

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
es: Los fragmentos predefinidos se definen a continuación. Tenga en cuenta que puede reemplazarlos creando fragmentos propios con el mismo texto de activación.

en: Inserting filler text [Lorem]
es: Insertar texto de relleno [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
es: El primer fragmento predefinido y el más simple, se usa para insertar texto de relleno en un documento. El texto de relleno se toma de `De finibus bonorum et malorum <https://es.wikipedia.org/wiki/De_finibus>`_, una obra filosófica de Cicerón (traducida al inglés). Para usarlo, simplemente teclee ``Lorem`` en un archivo HTML y pulse |ct|. Se sustituirá por un par de párrafos de relleno.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
es: La definición de este fragmento es muy simple, el texto de activación se define como ``Lorem`` y la plantilla no es más que el texto literal que se inserta. Es muy sencillo personalizarlo par usar el texto de relleno que prefiera.

en: Inserting a self-closing HTML tag [<>]
es: Insertar una etiqueta HTML con cierre incorporado [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
es: Veamos un ejemplo sencillo del potente concepto de *marcadores de lugar*. Digamos que quiere insertar la etiqueta con cierre incorporado ``<hr/>``. Únicamente teclee ``<>`` y pulse |ct|, el editor expandirá el fragmento a::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
es: Aquí, el símbolo ``|`` representa la posición actual del cursor. Ahora puede teclear ``hr`` y pulsar |ct| para mover el cursor al final de la etiqueta. Este fragmento está definido como::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
es: Los marcadores de posición son simplemente el símbolo de dólar ($) seguido de un número. Cuando el fragmento se expande al pulsar |ct| el cursor se coloca en el primer marcador de posición (el que tenga el número más bajo). Cuando pulsa |ct| otra vez el cursor se desplaza al siguiente marcador de posición (el que tenga el siguiente número más bajo).

en: Inserting an HTML link tag [<a]
es: Insertar un enlace HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
es: Todas las etiquetas de enlace HTML tienen una estructura común. Tienen un atributo ``href`` y algún texto entre las etiquetas de apertura y cierre. Vamos a ver otras características de los marcadores de posición con un fragmento que hará más eficiente teclear estas etiquetas. Para usar este fragmento, simplemente teclee ``<a`` y pulse |ct|. El editor lo expandirá a::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
es: No sólo eso, la palabra ``filename`` estará seleccionada, con el cursor sobre ella, para que pueda teclear el nombre de archivo real usando la función :ref:`editor_auto_complete` del editor. Y una vez que haya terminado de escribir el nombre de archivo, pulse |ct| de nuevo y el cursor saltará a la posición entre las etiquetas ``<a>`` para que pueda teclear directamente el texto par el enlace. Cuando termine de escribir el texto, pulse |ct| otra vez para saltar a la derecha de la etiqueta de cierre. Este fragmento está definido como::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
es: Hay un par de nuevas características. Primero, el marcador ``$1`` se ha vuelto más complejo. Ahora incluye un *texto predeterminado* (la palabra ``filename``). Si un marcador de posición contiene un texto predeterminado, el marcador se sustituye por el texto al expandir el fragmento. Además, al saltar a un marcador con texto predeterminado usando |ct|, el texto se selecciona. De esta manera, puede usar el texto predeterminado como un recordatorio para rellenar las partes importantes de la plantilla. Puede especificar un texto predeterminado para un marcador de posición usando la sintaxis: ``${<número>:texto predeterminado}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
es: La otra nueva característica es que el segundo marcador de posición tiene un asterisco al final (``${2*}``). Esto significa que cualquier texto que estuviera seleccionado antes de expandir la plantilla sustituirá al marcador. Para verlo en acción, seleccione algún texto en el editor, pulse |ct|, teclee ``<a`` y pulse |ct| otra vez, la plantilla se expandirá a::

en: Inserting a HTML image tag [<i]
es: Insertar una etiqueta de imagen HTML [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
es: Esto es muy parecido a insertar un enlace HTML, como hemos visto anteriormente. Le permite introducir rápidamente ``<img src="filename" alt="description" />`` y saltar entre los atributos ``src`` y ``alt``::

en: Insert an arbitrary HTML tag [<<]
es: Insertar una etiqueta HTML arbitraria [<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. If you want to wrap selected text, first select the text, press |ct| then type ``<<`` and press |ct| again. The editor will expand it to::
es: Esto le permite insertar una etiqueta completa HTML arbitraria (o incluir un texto previamente seleccionado en la etiqueta). Para usarlo, teclee ``<<`` y pulse |ct|. Si desea rodear el texto seleccionado, primero seleccione el texto, pulse |ct|, teclee ``<<`` y pulse |ct| de nuevo. El editor lo expandirá a::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
es: Teclee el nombre de la etiqueta, por ejemplo ``span``, y pulse |ct|, el resultado será::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
es: Verá que la etiqueta de cierre se ha rellenado automáticamente con ``span``. Esto se obtiene gracias a otra característica de los marcadores de posición, la *duplicación*. Duplicación significa simplemente que si especifica el mismo marcador más de una vez en una plantilla, la segunda posición y las posteriores se rellenarán automáticamente, al pulsar |ct|, con lo que haya tecleado en la primera posición. La definición para este fragmento es::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
es: Como puede ver, el primer marcador de posición (``$1``) se ha especificado dos veces, la segunda en la etiqueta de cierre, lo que sencillamente copiará lo que sea que haya introducido en la etiqueta de apertura.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
es: Insertar una etiqueta HTML arbitraria con un atributo de clase [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
es: Esto es muy parecido al ejemplo anterior de inserción de una etiqueta arbitraria, excepto que supone que querrá especificar una clase para la etiqueta::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
es: Esto le permitirá teclear primero el nombre de la etiqueta, pulsar |ct|, teclear el nombre de clase, pulsar |ct|, teclear el contenido de la etiqueta y pulsar |ct| una última vez para saltar fuera de la etiqueta. La etiqueta de cierre se rellenará automáticamente.

en: Creating your own snippets
es: Crear fragmentos propios

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
es: Lo mejor de los fragmentos es que puede crear los suyos propios que mejor se adapten a su estilo. Para crear fragmentos propios vaya a :guilabel:`Editar > Preferencias > Configuración del editor > Administrar fragmentos` en el editor. Esto mostrará un cuadro de diálog fácil de usar que le ayudará a crear fragmentos. Pulse en el botón :guilabel:`Añadir fragmento` y verá un cuadro de diálogo parecido a:

en: The create your own snippets tool
es: La herramienta de creación de fragmentos

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
es: Primero asigne un nombre al fragmento, algo descriptivo, para ayudarle a identificar el fragmento en el futuro. Luego especifique el *activador*. Un activador no es más que el texto que debe teclear en el editor antes de pulsar |ct| para expandir el fragmento.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
es: Después especifique la plantilla del fragmento. Es recomendable que empiece con alguno de los ejemplos anteriores y lo modifique según sus necesidades. Finalmente, especifique en qué tipos de archivo quiere que esté disponible el fragmento. De esta forma puede tener varios fragmentos con el mismo texto activador que funcionan de manera distinta en distintos tipos de archivo.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
es: El siguiente paso es probar el fragmento recién creado. Use el cuadro :guilabel:`Prueba` en la parte inferior. Teclee el texto activador y pulse |ct| para expandir el fragmento y para saltar entre los marcadores de posición.
