]> granicus.if.org Git - apache/blobdiff - docs/manual/filter.xml.es
Help doc writer to spot places where:
[apache] / docs / manual / filter.xml.es
index 26f1f894eb76c91d40d89b352cb62a3ddeb3a0ef..e4ab73178f5e4b7b785444ce11211e3089c70f73 100644 (file)
@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
-<!-- English Revision: 151408:1133582 (outdated) -->
-
+<!-- English Revision: 1221670 -->
+<!-- Updated by Luis Gil de Bernabé Pfeiffer lgilbernabe[AT]apache.org -->
+<!-- Reviewed by Sergio Ramos-->
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
 
   <title>Filtros</title>
 
-  <summary>
-    <p>Este documento describe c&#243;mo usar filtros en Apache.</p>
-  </summary>
-
-  <section id="filters">
-    <title>Filtros</title>
-    <related>
-      <modulelist>
-        <module>mod_deflate</module>
-        <module>mod_ext_filter</module>
-        <module>mod_include</module>
-      </modulelist>
-      <directivelist>
-        <directive module="mod_mime">AddInputFilter</directive>
-        <directive module="mod_mime">AddOutputFilter</directive>
-        <directive module="mod_mime">RemoveInputFilter</directive>
-        <directive module="mod_mime">RemoveOutputFilter</directive>
-        <directive module="mod_ext_filter">ExtFilterDefine</directive>
-        <directive module="mod_ext_filter">ExtFilterOptions</directive>
-        <directive module="core">SetInputFilter</directive>
-        <directive module="core">SetOutputFilter</directive>
-      </directivelist>
-    </related>
-
-    <p>Un <em>filtro</em> es un proceso que se aplica a los datos que
-    se reciben o se env&#237;an por el servidor. Los datos enviados
-    por los clientes al servidor son procesados por <em>filtros de
-    entrada</em> mientras que los datos enviados por el servidor se
-    procesan por los <em>filtros de salida</em>. A los datos se les
-    pueden aplicar varios filtros, y el orden en que se aplica cada
-    filtro puede especificarse explícitamente.</p>
-
-    <p>Los filtros se usan internamente por Apache para llevar a cabo
-    funciones tales como chunking y servir peticiones de
-    byte-range. Además, los m&#243;dulos contienen filtros que se
-    pueden seleccionar usando directivas de configuraci&#243;n al
-    iniciar el servidor. El conjunto de filtros que se aplica a los
-    datos puede manipularse con las directivas <directive
-    module="core">SetInputFilter</directive>, <directive
-    module="core">SetOutputFilter</directive>, <directive
-    module="mod_mime">AddInputFilter</directive>, <directive
-    module="mod_mime">AddOutputFilter</directive>, <directive
-    module="mod_mime">RemoveInputFilter</directive>, y <directive
-    module="mod_mime">RemoveOutputFilter</directive>.</p>
-
-    <p>Actualmente, vienen con la distribuci&#243;n de Apache los
-    siguientes filtros seleccionables por el usuario.</p>
-
-    <dl>
-      <dt>INCLUDES</dt> 
-      <dd>Server-Side Includes procesado por
-      <module>mod_include</module></dd> 
-      <dt>DEFLATE</dt> 
-      <dd>Comprime los datos de salida antes de enviarlos al cliente
-      usando el m&#243;dulo
-      <module>mod_deflate</module>
-      </dd>
-    </dl>
-
-    <p>Adem&#225;s, el m&#243;dulo <module>mod_ext_filter</module>
-    permite definir programas externos como filtros.</p>
-  </section>
-</manualpage>
+         <summary>
+           <p>Este documento describe cómo usar filtros en Apache.</p>
+         </summary>
+
+         <section id="intro">
+           <title>Filtros en Apache 2</title>
+           <related>
+             <modulelist>
+               <module>mod_filter</module>
+               <module>mod_deflate</module>
+               <module>mod_ext_filter</module>
+               <module>mod_include</module>
+               <module>mod_charset_lite</module>
+               <module>mod_reflector</module>
+               <module>mod_buffer</module>
+               <module>mod_data</module>
+               <module>mod_ratelimit</module>
+               <module>mod_reqtimeout</module>
+               <module>mod_request</module>
+               <module>mod_sed</module>
+               <module>mod_substitute</module>
+               <module>mod_xml2enc</module>
+               <module>mod_proxy_html</module>
+               <module>mod_policy</module>
+             </modulelist>
+             <directivelist>
+                <directive module="mod_filter">FilterChain</directive>
+               <directive module="mod_filter">FilterDeclare</directive>
+               <directive module="mod_filter">FilterProtocol</directive>
+               <directive module="mod_filter">FilterProvider</directive>
+               <directive module="mod_mime">AddInputFilter</directive>
+               <directive module="mod_mime">AddOutputFilter</directive>
+               <directive module="mod_mime">RemoveInputFilter</directive>
+               <directive module="mod_mime">RemoveOutputFilter</directive>
+               <directive module="mod_reflector">ReflectorHeader</directive>
+               <directive module="mod_ext_filter">ExtFilterDefine</directive>
+               <directive module="mod_ext_filter">ExtFilterOptions</directive>
+               <directive module="core">SetInputFilter</directive>
+               <directive module="core">SetOutputFilter</directive>
+             </directivelist>
+           </related>
+
+                   <p>La cadena de filtrado está disponible en Apache 2.0 y superiores.
+                   Un <em>filtro</em> es un proceso que se aplica a los datos que
+                   se reciben o se envían por el servidor. Los datos enviados
+                   por los clientes al servidor son procesados por <em>filtros de
+                   entrada</em> mientras que los datos enviados por el servidor se
+                   procesan por los <em>filtros de salida</em>. A los datos se les
+                   pueden aplicar varios filtros, y el orden en que se aplica cada
+                   filtro puede especificarse explícitamente.
+                   Todo este proceso es independiente de las tradicionales fase de
+                   peticiones</p>
+                   <p class="figure">
+                       <img src="images/filter_arch.png" width="569" height="392" alt=
+                       "Filters can be chained, in a Data Axis orthogonal to request processing"/>
+                       </p>
+                       <p>Algunos ejemplos de filtrado en la distribución estándar de Apache son:</p>
+                       <ul>
+                       <li><module>mod_include</module>, implementa  server-side includes (SSI).</li>
+                       <li><module>mod_ssl</module>, implementa cifrado SSL (https).</li>
+                       <li><module>mod_deflate</module>, implementa compresión y descompresión en el acto.</li>
+                       <li><module>mod_charset_lite</module>, transcodificación entre diferentes juegos de caracteres.</li>
+                       <li><module>mod_ext_filter</module>, ejecuta un programa externo como filtro.</li>
+                       </ul>
+                   <p>Los filtros se usan internamente por Apache para llevar a cabo
+                   funciones tales como chunking y servir peticiones de
+                   byte-range. Además, los módulos contienen filtros que se
+                   pueden seleccionar usando directivas de configuración al
+                   iniciar el servidor.</p>
+
+                   <p>Una mayor amplitud de aplicaciones son implementadas con módulos de 
+                   filtros de terceros que estan disponibles en <a
+                   href="http://modules.apache.org/">modules.apache.org</a> y en otros lados.
+                   algunos de ellos son:</p>
+
+                   <ul>
+                       <li>Procesamiento y reescritura de HTML y XML.</li>
+                       <li>Transformaciones de XSLT y XIncludes.</li>
+                       <li>Soporte de espacios de nombres en XML.</li>
+                       <li>Manipulación de carga de archivos y decodificación de los 
+                               formularios HTML.</li>
+                       <li>Procesamiento de imágenes.</li>
+                       <li>Protección de aplicaciones vulnerables, tales como scripts PHP</li>
+                       <li>Edición de texto de búsqueda y remplazo.</li>
+                       </ul>
+               </section>
+               <section id="smart">
+                       <title>Filtrado Inteligente</title>
+                               <p class="figure">
+                               <img src="images/mod_filter_new.png" width="423" height="331"
+                               alt="Smart filtering applies different filter providers according to the state of request processing"/>
+                               </p>
+                               <p><module>mod_filter</module>, incluido en Apache 2.1 y posterior,
+                               habilita la cadena de filtrado para ser configurada dinámicamente en
+                               tiempo de ejecución. Así, por ejemplo, usted puede configurar un 
+                               proxy para que reescriba HTML con un filtro de HTML y imágenes JPEG
+                               con filtros completos por separado, a pesar de que el proxy no tiene 
+                               información previa sobre lo que enviará al servidor de origen.
+                               Esto funciona usando un engranaje filtros, que envía a diferentes 
+                               proveedores dependiendo del contenido en tiempo de ejecución.
+                               Cualquier filtro puede ser, ya sea insertado directamente en la
+                               cadena y ejecutado incondicionalmente, o usado como proveedor y
+                               añadido dinámicamente
+                               Por ejemplo:</p>
+                               <ul>
+                               <li>Un filtro de procesamiento de HTML sólo se ejecuta si el 
+                                       contenido es text/html o application/xhtml + xml.</li>
+                               <li>Un filtro de compresión sólo se ejecuta si la entrada es un tipo 
+                                       compresible y no está ya comprimida.</li>
+                               <li>Se insertará un filtro de conversión de juego de caracteres,
+                                       si un documento de texto no está ya en el juego de caracteres 
+                                       deseado.</li>
+                       </ul>
+               </section>
+
+               <section id="service">
+
+               <title>Filtros expuestos como un servicio HTTP</title>
+               <p>Los filtros pueden ser usados para procesar contenido originado 
+               desde el cliente además de usarse para procesar el contenido originado
+               desde el propio servidor usando el módulo <module>mod_reflector</module>.</p>
+
+               <p><module>mod_reflector</module> acepta peticiones POST de los clientes, y
+               refleja el cuerpo de la petición POST recibida, dentro del contenido de la 
+               respuesta de la petición, pasa a través de la pila del filtro de salida en 
+               el camino de vuelta al cliente.</p>
+
+               <p>Esta técnica se puede utilizar como una alternativa a un servicio web
+               que se ejecuta en una pila de de aplicaciones dentro del servidor,
+               en donde el filtro de salida proporciona la transformación requerida en el
+               cuerpo de la petición. Por ejemplo, el módulo <module>mod_deflate</module>
+               puede ser usado para proporcionar un servicio de compresión general,
+               o un filtro de transformación de imagen, puede ser convertido en un
+               servicio de conversión de imágenes.
+               </p>
+
+               </section>
+
+               <section id="using">
+               <title>Usando los Filtros</title>
+               <p>Hay dos formas de usar el filtrado: de forma Simple y Dinámica.
+               Generalmente, deberá usar una forma u otra; ya que mezclarlas puede
+               causar consecuencias inesperadas (a pesar de que reglas de Entrada de 
+               tipo simple pueden ser combinadas libremente con reglas de filtrado 
+               de Salidas de tipo simple o dinámico).</p>
+               <p>La forma más sencilla es la única manera de configurar filtros de 
+               Entrada, y es suficiente para filtros de Salida donde se necesita una
+               cadena de filtros estática.
+               Las directivas más relevantes son:
+                   <directive module="core">SetInputFilter</directive>,
+                   <directive module="core">SetOutputFilter</directive>,
+                   <directive module="mod_mime">AddInputFilter</directive>,
+                   <directive module="mod_mime">AddOutputFilter</directive>,
+                   <directive module="mod_mime">RemoveInputFilter</directive>, and
+                   <directive module="mod_mime">RemoveOutputFilter</directive>.</p>
+
+               <p>La forma Dinámica habilita ambas configuraciones estática, y dinámica, para los filtros de Salida, como se plantea en la página <module>mod_filter</module>.
+               Las directivas más relevantes son:
+                   <directive module="mod_filter">FilterChain</directive>,
+                   <directive module="mod_filter">FilterDeclare</directive>, and
+                   <directive module="mod_filter">FilterProvider</directive>.</p>
+
+               <p>Una directiva más como es <directive
+               module="mod_filter">AddOutputFilterByType</directive> sigue siendo 
+               soportada pero esta obsoleta. Usa en cambio la configuración dinámica.</p>
 
+         </section>
+</manualpage>
\ No newline at end of file