<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE page [
<!ENTITY % balsa SYSTEM "balsa.entities">
<!ENTITY mdash "--">
<!-- replace with actual app  version number--><!ENTITY version "2.5">
<!ENTITY Balsa '<app xmlns="http://projectmallard.org/1.0/">Balsa</app>'>
<!ENTITY Mutt '<app xmlns="http://projectmallard.org/1.0/">Mutt</app>'>
<!ENTITY GnomeCard '<app xmlns="http://projectmallard.org/1.0/">GnomeCard</app>'>
<!ENTITY Pine '<app xmlns="http://projectmallard.org/1.0/">pine</app>'>
<!ENTITY procmail '<app xmlns="http://projectmallard.org/1.0/">procmail</app>'>
<!ENTITY GnuPG '<app xmlns="http://projectmallard.org/1.0/">GnuPG</app>'>
<!ENTITY balsalist "http://mail.gnome.org/mailman/listinfo/balsa-list">
<!ENTITY IMAP '<link xmlns="http://projectmallard.org/1.0/"
           xref ="glossary#imap">IMAP</link>'>
<!ENTITY LDAP '<link xmlns="http://projectmallard.org/1.0/"
           xref ="glossary#ldap">LDAP</link>'>
<!ENTITY POP3 '<link xmlns="http://projectmallard.org/1.0/"
           xref ="glossary#pop">POP3</link>'>
<!ENTITY SMTP '<link xmlns="http://projectmallard.org/1.0/"
           xref ="glossary#smtp">SMTP</link>'>
<!ENTITY VCARD '<link xmlns="http://projectmallard.org/1.0/"
           xref ="glossary#vcard">VCARD</link>'>
]>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="win-filters" xml:lang="es">
  <info>
    <link type="guide" xref="index"/>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Daniel Mustieles</mal:name>
      <mal:email>daniel.mustieles@gmail.com</mal:email>
      <mal:years>2011 - 2019</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Juan Matías Olmos</mal:name>
      <mal:email>colonizare@yahoo.com.ar</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Joaquín Ignacio Aramendía</mal:name>
      <mal:email>samsagax@gmail.com</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jorge González</mal:name>
      <mal:email>jorgegonz@svn.gnome.org</mal:email>
      <mal:years>2008</mal:years>
    </mal:credit>
  </info>
  <title>La ventana de filtros</title>
  <p>This window is divided in two parts: the left part is the list
  of all filters. When you select one of them, the right part
  displays its properties. The right part is a two-page notebook
  (the
  <link xref="win-filters#wf-match-page">match page</link>, and the
  <link xref="win-filters#wf-action-page">action page</link>); their
  descriptions follow.</p>
  <p>There are two buttons under the filters list:</p>
  <list>
    <item>
      <p>El botón <gui>Nuevo</gui>: al pulsarlo se crea un filtro nuevo; inicialmente, el filtro se llama «Nuevo filtro» y no contiene condiciones. Luego complete los diferentes campos de las páginas (en particular, recuerde cambiar el nombre del filtro), añada las condiciones que describen cómo encuentra un mensaje estos filtros y, para confirmar las modificaciones, presione el botón <gui>Aplicar</gui> del lado derecho de la ventana de «Filtros».</p>
    </item>
    <item>
      <p>El botón <gui>Quitar</gui>: quita el filtro seleccionado actualmente.</p>
    </item>
  </list>
  <section id="wf-match-page">
    <title>The Match Page</title>
    <p>Cada filtro se compone de una o varias condiciones; cada condición representa una prueba que se aplicará a los mensajes. El resultado de estas pruebas se combina luego siguiendo el tipo de operación indicado:</p>
    <list>
      <item>
        <p>AND: todas las condiciones deben ser ciertas para que coincida.</p>
      </item>
      <item>
        <p>OR: una condición debe ser cierta para que coincida.</p>
      </item>
    </list>
    <p>Then the page displays the name of the filter and the
    conditions that describes how the filters matches a message.
    The list displays the type of the conditions (the conditions
    will be described later):</p>
    <list>
      <item>
        <p><gui>Simple</gui>: la coincidencia se hace por una prueba de subcadena simple.</p>
      </item>
      <item>
        <p><gui>Expresión regular</gui>: la comparación utiliza expresiones regulares en las cabeceras de los mensajes.</p>
      </item>
      <item>
        <p><gui>Intervalo de fechas</gui>: la comparación se realiza comprobando si la fecha del mensaje se encuentra dentro de ciertos límites.</p>
      </item>
      <item>
        <p><gui>Marca de condición</gui>: la comparación se realiza comprobando las marcas del mensaje: «No leído», «Respondido», «Eliminado» y «Marcado».</p>
      </item>
    </list>
    <p>The three buttons under the list allows you to edit the
    selected condition, add a new one, or remove one. Editing or
    creating a condition is done in the
    <link xref="win-condition">condition window</link>, which
    pops up when you click on the
    <gui>Edit</gui> or the
    <gui>New</gui> button.</p>
    <p>The two buttons under the notebook at the right hand side of
    the window lets you manipulate the currently selected filter.
    The
    <gui>Apply</gui> button is used to confirm the modifications you
    have made on any field. If you make changes and select another
    filter without first clicking on the
    <gui>Apply</gui> button, all your changes will be lost.</p>
    <p>El botón <gui>Revertir</gui> cancela todos los cambios previos: el filtro actual se restablece a su estado justo antes de la última vez que se utilizó el botón <gui>Aplicar</gui>.</p>
  </section>
  <section id="wf-action-page">
    <title>The Action Page</title>
    <p>This page describes the actions to take in case the filter
    matches. First you specify the notification to inform you that
    the one or several messages has matched the filter in the
    <gui>Notification</gui> frame. Then in the
    <gui>Action</gui> frame you tell what to do with the matching
    messages. You can ask <app>Balsa</app> to copy or move them to any
    mailbox, or to send them to the trash can. The other actions
    are not yet implemented.</p>
  </section>
  <section id="win-condition">
    <title>The Condition Window</title>
    <p>This window is used to edit an existing condition or to
    create a new one. It displays all the information needed to
    describe the condition, it is launched when you click on the
    <gui>Edit</gui> or
    <gui>New</gui> buttons under the conditions list in the match
    page of the notebook in the right part of the
    <link xref="win-filters">filters window</link>.</p>
    <p>This window is made of three frames:</p>
    <list>
      <item>
        <p>El cuadro <gui>Coincide con los campos</gui>: es un conjunto de casillas de verificación, una para cada campo de coincidencia. Por ejemplo, si quiere concordar todos los mensajes enviados por usuarios de hotmail, tendrá que marcar la casilla <gui>De</gui>, o si quiere concordar todos los mensajes sobre <app>Balsa</app>, marque la casilla <gui>Asunto</gui>.</p>
        <note style="warning">
          <p>Be careful with
          <gui>Body</gui> match, this can take time for large
          messages.</p>
        </note>
        <p>For advanced use you can also specify directly the name
        of the header to match on. A standard example the
        “X-Mailer” is a header added to your message by the MUAs
        with their name and versions.</p>
        <p>El botón <gui>Todos</gui> marcará todas las casillas, mientras que el botón <gui>Limpiar</gui> las desmarcará (como habrá adivinado).</p>
        <p>If you specify several headers, a message will match
        this condition if one of the header matches. For example if
        you want to filter all messages talking about <app>Balsa</app>,
        you should check the
        <gui>Body</gui> and the
        <gui>Subject</gui> boxes, so that all mails with the word
        “Balsa” in its subject or its body will match.
        You can also, if you're fed up with <app>Balsa</app> ;-), match
        all mails that do NOT contain the word
        “Balsa” in their subject and in their body
        neither. See the description of the search types to see how
        to do this.</p>
      </item>
      <item>
        <p>The
        <gui>Search Type</gui> frame: it's a list of the different
        condition types. You choose
        <gui>Simple</gui>,
        <gui>Regular expression</gui>,
        <gui>Date interval</gui>, or
        <gui>flag condition</gui>. Your choice will change the
        third frame so that it displays the fields needed by the
        type of match chosen.</p>
      </item>
      <item>
        <p>This part depends on the search type you've chosen:</p>
        <list>
          <item>
            <p>
            <gui>Simple</gui> type: a text entry lets you input the
            string to look for (case does not matter, the search is
            case-insensitive). The button lets you specify if a
            message matches when the string is or is NOT a
            substring of the specified headers, the sentence above
            the text entry will be updated accordingly.</p>
          </item>
          <item>
            <p><gui>Expresión regular</gui>: se puede ingresar una lista de expresiones regulares. Se escribe la expresión regular en el cuadro de texto, luego se pulsa el botón <gui>Añadir</gui> para ingresarla a la lista. Obviamente, el botón <gui>Eliminar</gui> destruye la expresión regular seleccionada en la lista. El último botón <gui>Una coincidencia/Ninguna coincidencia</gui> permite indicar cuando un mensaje coincide con la condición: cuando coincide una de las expresiones regulares o cuando no coincide ninguna. La sentencia sobre la lista se actualizará adecuadamente.</p>
          </item>
          <item>
            <p><gui>Intervalo de fechas</gui>: puede introducir el intervalo utilizando los dos cuadros de texto. Un campo en blanco significa que no hay límite. El botón indica concordar cuando la fecha del mensaje está dentro de los límites o no. La frase sobre el cuadro de texto se actualizará adecuadamente.</p>
          </item>
          <item>
            <p><gui>Marca de condición</gui>: las cuatro casillas de verificación permiten seleccionar los mensajes que coincidirán con esta condición. Si quiere concordar todos los mensajes respondidos o no leídos, marque las casillas correspondientes. El botón permite indicar que la coincidencia se hará cuando ninguna de las marcas especificadas estén activas, la frase debajo de las casillas de verificación se actualizará adecuadamente. Por ejemplo, si quiere filtrar todos los mensajes no leídos y respondidos, marque las casillas <gui>No leído</gui> y <gui>Respondido</gui>, y pulse el botón.</p>
          </item>
        </list>
      </item>
    </list>
  </section>
</page>
