]> granicus.if.org Git - apache/commitdiff
added all the missing documentation from trunk, and added the style correctly
authorLuis Gil <lgilbernabe@apache.org>
Sat, 1 Apr 2017 17:18:50 +0000 (17:18 +0000)
committerLuis Gil <lgilbernabe@apache.org>
Sat, 1 Apr 2017 17:18:50 +0000 (17:18 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1789827 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/filter.html.es
docs/manual/filter.xml.es

index 74a58406710c8466d1bd4805c87e5487b7bf033e..30b6f3e410691decbb049934d7be91c5f385fb59 100644 (file)
@@ -15,7 +15,7 @@
 </script>
 
 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
-<body id="manual-page" class="no-sidebar"><div id="page-header">
+<body id="manual-page"><div id="page-header">
 <p class="menu"><a href="./mod/">M&#243;dulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
 <p class="apache">Versi&#243;n 2.4 del Servidor HTTP Apache</p>
 <img alt="" src="./images/feather.png" /></div>
 <a href="./tr/filter.html" hreflang="tr" rel="alternate" title="T&#252;rk&#231;e">&nbsp;tr&nbsp;</a></p>
 </div>
 
-    <p>Este documento describe c&#243;mo usar filtros en Apache.</p>
-  </div>
+      <p>Este documento describe c&#243;mo usar filtros en Apache.</p>
+    </div>
+<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#intro">Filtros en Apache 2</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#smart">Filtrado Inteligente</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#service">Filtros expuestos como un servicio HTTP</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#using">Usando los Filtros</a></li>
+</ul><h3>Consulte tambi&#233;n</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
-<h2><a name="filters" id="filters">Filtros</a></h2>
+<h2><a name="intro" id="intro">Filtros en Apache 2</a></h2>
+      
+      <table class="related"><tr><th>M&#243;dulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code></li><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></li><li><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></li><li><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></li><li><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></li><li><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></li><li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code></li><li><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></li><li><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></li><li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code></li><li><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></li><li><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></li><li><code class="module"><a href="./mod/mod_policy.html">mod_policy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprotocol">FilterProtocol</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_reflector.html#reflectorheader">ReflectorHeader</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
+
+        <p>La cadena de filtrado est&#225; 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&#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&#237;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&#243;n est&#225;ndar de Apache son:</p>
+      <ul>
+      <li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, implementa  server-side includes (SSI).</li>
+      <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, implementa cifrado SSL (https).</li>
+      <li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>, implementa compresi&#243;n y descompresi&#243;n en el acto.</li>
+      <li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, transcodificaci&#243;n entre diferentes juegos de caracteres.</li>
+      <li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, 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&#225;s, los m&#243;dulos contienen filtros que se
+        pueden seleccionar usando directivas de configuraci&#243;n al
+        iniciar el servidor.</p>
+
+        <p>Una mayor amplitud de aplicaciones son implementadas con m&#243;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&#243;n de carga de archivos y decodificaci&#243;n de los 
+        formularios HTML.</li>
+      <li>Procesamiento de im&#225;genes.</li>
+      <li>Protecci&#243;n de aplicaciones vulnerables, tales como scripts PHP</li>
+      <li>Edici&#243;n de texto de b&#250;squeda y remplazo.</li>
+      </ul>
+    </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="smart" id="smart">Filtrado Inteligente</a></h2>
+      
+        <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><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, incluido en Apache 2.1 y posterior,
+        habilita la cadena de filtrado para ser configurada din&#225;micamente en
+        tiempo de ejecuci&#243;n. As&#237;, por ejemplo, usted puede configurar un 
+        proxy para que reescriba HTML con un filtro de HTML y im&#225;genes JPEG
+        con filtros completos por separado, a pesar de que el proxy no tiene 
+        informaci&#243;n previa sobre lo que enviar&#225; al servidor de origen.
+        Esto funciona usando un engranaje filtros, que env&#237;a a diferentes 
+        proveedores dependiendo del contenido en tiempo de ejecuci&#243;n.
+        Cualquier filtro puede ser, ya sea insertado directamente en la
+        cadena y ejecutado incondicionalmente, o usado como proveedor y
+        a&#241;adido din&#225;micamente
+        Por ejemplo:</p>
+        <ul>
+        <li>Un filtro de procesamiento de HTML s&#243;lo se ejecuta si el 
+          contenido es text/html o application/xhtml + xml.</li>
+        <li>Un filtro de compresi&#243;n s&#243;lo se ejecuta si la entrada es un tipo 
+          compresible y no est&#225; ya comprimida.</li>
+        <li>Se insertar&#225; un filtro de conversi&#243;n de juego de caracteres,
+          si un documento de texto no est&#225; ya en el juego de caracteres 
+          deseado.</li>
+      </ul>
+    </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="service" id="service">Filtros expuestos como un servicio HTTP</a></h2>
+
     
-    <table class="related"><tr><th>M&#243;dulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
+    <p>Los filtros pueden ser usados para procesar contenido originado 
+    desde el cliente adem&#225;s de usarse para procesar el contenido originado
+    desde el propio servidor usando el m&#243;dulo <code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code>.</p>
+
+    <p><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> acepta peticiones POST de los clientes, y
+    refleja el cuerpo de la petici&#243;n POST recibida, dentro del contenido de la 
+    respuesta de la petici&#243;n, pasa a trav&#233;s de la pila del filtro de salida en 
+    el camino de vuelta al cliente.</p>
 
-    <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&#237;citamente.</p>
+    <p>Esta t&#233;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&#243;n requerida en el
+    cuerpo de la petici&#243;n. Por ejemplo, el m&#243;dulo <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>
+    puede ser usado para proporcionar un servicio de compresi&#243;n general,
+    o un filtro de transformaci&#243;n de imagen, puede ser convertido en un
+    servicio de conversi&#243;n de im&#225;genes.
+    </p>
 
-    <p>Los filtros se usan internamente por Apache para llevar a cabo
-    funciones tales como chunking y servir peticiones de
-    byte-range. Adem&#225;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 <code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>, <code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, <code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, <code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>, y <code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p>
+    </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="using" id="using">Usando los Filtros</a></h2>
+    
+    <p>Hay dos formas de usar el filtrado: de forma Simple y Din&#225;mica.
+    Generalmente, deber&#225; 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&#225;mico).</p>
+    <p>La forma m&#225;s sencilla es la &#250;nica manera de configurar filtros de 
+    Entrada, y es suficiente para filtros de Salida donde se necesita una
+    cadena de filtros est&#225;tica.
+    Las directivas m&#225;s relevantes son:
+        <code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
+        <code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
+        <code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>,
+        <code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>,
+        <code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>, and
+        <code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p>
 
-    <p>Actualmente, vienen con la distribuci&#243;n de Apache los
-    siguientes filtros seleccionables por el usuario.</p>
+    <p>La forma Din&#225;mica habilita ambas configuraciones est&#225;tica, y din&#225;mica, para los filtros de Salida, como se plantea en la p&#225;gina <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>.
+    Las directivas m&#225;s relevantes son:
+        <code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code>,
+        <code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>, and
+        <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p>
 
-    <dl>
-      <dt>INCLUDES</dt> 
-      <dd>Server-Side Includes procesado por
-      <code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dd> 
-      <dt>DEFLATE</dt> 
-      <dd>Comprime los datos de salida antes de enviarlos al cliente
-      usando el m&#243;dulo
-      <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>
-      </dd>
-    </dl>
+    <p>Una directiva m&#225;s como es <code class="directive"><a href="./mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> sigue siendo 
+    soportada pero esta obsoleta. Usa en cambio la configuraci&#243;n din&#225;mica.</p>
 
-    <p>Adem&#225;s, el m&#243;dulo <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>
-    permite definir programas externos como filtros.</p>
-  </div></div>
+    </div></div>
 <div class="bottomlang">
 <p><span>Idiomas disponibles: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="./es/filter.html" title="Espa&#241;ol">&nbsp;es&nbsp;</a> |
index 35f1c781fdd3acfa1aac34489c7abb02b6c26ac5..d23fffb352671d8c943630095609bc127c4a545a 100644 (file)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
-<?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
+<?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?>
 <!-- English Revision: 1562488 -->
 <!-- Updated by Luis Gil de BernabĂ© Pfeiffer lgilbernabe[AT]apache.org -->
 <!-- Reviewed by Sergio Ramos-->