Commit 791f9288 authored by Andre Malo's avatar Andre Malo
Browse files

update Spanish translation: 

 * manual/bind.xml.es, manual/custom-error.xml.es: New translations
 * manual/style/lang/es.xml: text snippet updates

Submitted by: Jesus Blanco <blanco bitrock.com>
Reviewed by: Daniel Lopez


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x@125663 13f79535-47bb-0310-9956-ffa450edef68
parent f9aa9ab6

docs/manual/bind.xml.es

0 → 100644
+189 −0
Changes for docs/manual/bind.xml.es: 189 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?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: 106849 -->



<!--

 Copyright 2005 The Apache Software Foundation or its licensors,

                as applicable



 Licensed under the Apache License, Version 2.0 (the "License");

 you may not use this file except in compliance with the License.

 You may obtain a copy of the License at



     http://www.apache.org/licenses/LICENSE-2.0



 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 See the License for the specific language governing permissions and

 limitations under the License.

-->



<manualpage metafile="bind.xml.meta">



  <title>Direcciones IP y puertos de escucha</title>



  <summary>

    <p>C&#243;mo configurar Apache para que escuche en direcciones IP

    y puertos espec&#237;ficos.</p>

  </summary>



  <seealso><a href="vhosts/">Hosts virtuales</a></seealso>

  <seealso><a href="dns-caveats.html">Asuntos relacionados con DNS</a></seealso>



  <section id="overview">

    <title>Introducci&#243;n</title>



    <related>

      <modulelist>

        <module>core</module>

        <module>mpm_common</module>

      </modulelist>

      <directivelist>

        <directive module="core" type="section">VirtualHost</directive>

        <directive module="mpm_common">Listen</directive>

      </directivelist>

    </related>





    <p>Cuando Apache se inicia, comienza a esperar peticiones

    entrantes en determinados puertos y direcciones de la m&#225;quina

    en la que se est&#225; ejecutando. Sin embargo, si quiere que

    Apache escuche solamente en determinados puertos espec&#237;ficos,

    o solamente en determinadas direcciones, o en una combinaci&#243;n

    de ambos, debe especificarlo adecuadamente. Esto puede adem&#225;s

    combinarlo con la posibilidad de usar hosts virtuales,

    funcionalidad con la que un servidor Apache puede responder a

    peticiones en diferentes direcciones IP, diferentes nombres de

    hosts y diferentes puertos.</p>



    <p>La directiva <directive module="mpm_common">Listen</directive>

    le indica al servidor que acepte peticiones entrantes solamente en

    los puertos y en las combinaciones de puertos y direcciones que se

    especifiquen. Si solo se especifica un n&#250;mero de puerto en la

    directiva <directive module="mpm_common">Listen</directive> el

    servidor escuchar&#225; en ese puerto, en todas las interfaces de

    red de la m&#225;quina. Si se especifica una direcci&#243;n IP y

    un puerto, el servidor escuchar&#225; solamente en la interfaz de

    red a la que pertenezca esa direcci&#243;n IP y solamente en el

    puerto indicado. Se pueden usar varias directivas <directive

    module="mpm_common">Listen</directive> para

    especificar varias direcciones IP y puertos de escucha. El

    servidor responder&#225; a las peticiones de todas las direcciones

    y puertos que se incluyan.</p>



    <p>Por ejemplo, para hacer que el servidor acepte conexiones tanto

    en el puerto 80 como en el puerto 8000, puede usar:</p>



    <example>

      Listen 80<br />

      Listen 8000

    </example>



    <p>Para hacer que el servidor acepte conexiones en dos interfaces

    de red y puertos espec&#237;ficos, use</p>



    <example>

      Listen 192.170.2.1:80<br />

      Listen 192.170.2.5:8000

    </example>



    <p>Las direcciones IPv6 deben escribirse entre corchetes, como en el siguiente ejemplo:</p>



    <example>

      Listen [fe80::a00:20ff:fea7:ccea]:80

    </example>

  </section>



  <section id="ipv6">

    <title>Consideraciones especiales para IPv6</title>



    <p>Cada vez m&#225;s plataformas implementan IPv6, y APR soporta

    IPv6 en la mayor parte de esas plataformas, permitiendo que Apache

    use sockets IPv6 y pueda tratar las peticiones que se env&#237;an

    con IPv6.</p>



    <p>Un factor de complejidad para los administradores de Apache es

    si un socket IPv6 puede tratar tanto conexiones IPv4 como

    IPv6. Para tratar conexiones IPv4 con sockets IPv6 se utiliza un

    traductor de direcciones IPv4-IPv6, cuyo uso est&#225; permitido

    por defecto en la mayor parte de las plataformas, pero que

    est&#225; desactivado por defecto en FreeBSD, NetBSD, y OpenBSD

    para cumplir con la pol&#237;tica system-wide en esas

    palaformas. Pero incluso en los sistemas en los que no est&#225;

    permitido su uso por defecto, un par&#225;metro especial de

    <program>configure</program> puede modificar ese

    comportamiento.</p>



    <p>Si quiere que Apache trate conexiones IPv4 y IPv6 con un

    m&#237;nimo de sockets, lo que requiere traducir direcciones IPv4

    a IPv6, especifique la opci&#243;n de <program>configure</program>

    <code>--enable-v4-mapped</code> y use directivas <directive

    module="mpm_common">Listen</directive> gen&#233;ricas de la

    siguiente forma:</p>



    <example>

      Listen 80

    </example>



    <p>Con <code>--enable-v4-mapped</code>, las directivas Listen en

    el fichero de configuraci&#243;n por defecto creado por Apache

    usar&#225;n ese formato. <code>--enable-v4-mapped</code> es el

    valor por defecto en todas las plataformas excepto en FreeBSD,

    NetBSD, y OpenBSD, de modo que esa es probablemente la manera en

    que su servidor Apache fue construido.</p>



    <p>Si quiere que Apache solo procese conexiones IPv4, sin tener en

    cuenta cu&#225;l es su plataforma o qu&#233; soporta APR, especifique

    una direcci&#243;n IPv4 en todas las directivas <directive

    module="mpm_common">Listen</directive>, como en

    estos ejemplos:</p>



    <example>

      Listen 0.0.0.0:80<br />

      Listen 192.170.2.1:80

    </example>



    <p>Si quiere que Apache procese conexiones IPv4 y IPv6 en sockets

    diferentes (es decir, deshabilitar la conversi&#243;n de

    direcciones IPv4 a IPv6), especifique la opci&#243;n de

    <program>configure</program> <code>--disable-v4-mapped</code> y

    use directivas Listen espec&#237;ficas como en el siguiente ejemplo:</p>



    <example>

      Listen [::]:80<br />

      Listen 0.0.0.0:80

    </example>



    <p>Con <code>--disable-v4-mapped</code>, las directivas Listen en

    el fichero de configuraci&#243;n que Apache crea por defecto

    usar&#225;n ese formato. <code>--disable-v4-mapped</code> se usa

    por defecto en FreeBSD, NetBSD, y OpenBSD.</p>



  </section>



  <section id="virtualhost">

    <title>C&#243;mo funciona este mecanismo en hosts virtuales</title>



    <p><directive module="mpm_common">Listen</directive> no implementa

    hosts virtuales. Solo le dice al servidor

    principal en qu&#233; direcciones y puertos tiene que escuchar. Si no

    se usan directivas <directive module="core"

    type="section">VirtualHost</directive>, el servidor se comporta de

    la misma manera con todas las peticiones que se acepten. Sin

    embargo, <directive module="core"

    type="section">VirtualHost</directive> puede usarse para

    especificar un comportamiento diferente en una o varias

    direcciones y puertos. Para implementar un host virtual, hay que

    indicarle primero al servidor que escuche en aquellas direcciones y

    puertos a usar. Entonces se debe crear un una secci&#243;n

    <directive module="core" type="section">VirtualHost</directive>

    en una direcci&#243;n y puerto espec&#237;ficos para determinar

    el comportamiento de ese host virtual. Tenga en cuenta que si se

    especifica en una secci&#243;n <directive module="core"

    type="section">VirtualHost</directive> una direcci&#243;n y puerto

    en los que el servidor no est&#225; escuchando, ese host virtual no

    podr&#225; ser accedido.</p>

  </section>

</manualpage>

docs/manual/custom-error.xml.es

0 → 100644
+209 −0
Changes for docs/manual/custom-error.xml.es: 209 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?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: 106090 -->



<!--

 Copyright 2005 The Apache Software Foundation or its licensors,

                as applicable



 Licensed under the Apache License, Version 2.0 (the "License");

 you may not use this file except in compliance with the License.

 You may obtain a copy of the License at



     http://www.apache.org/licenses/LICENSE-2.0



 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or

 implied.  See the License for the specific language governing

 permissions and limitations under the License.  -->



<manualpage metafile="custom-error.xml.meta">



  <title>Respuestas de error personalizadas</title>



  <summary>

    <p>Apache ofrece la posibilidad de que los webmasters puedan

    configurar las respuestas que muestra el servidor Apache cuando se

    producen algunos errores o problemas.</p>



    <p>Las respuestas personalizadas pueden definirse para activarse

    en caso de que el servidor detecte un error o problema.</p>



    <p>Si un script termina de forma anormal y se produce una respuesta

    "500 Server Error", esta respuesta puede ser sustituida por otro

    texto de su elecci&#243;n o por una redirecci&#243;n a otra URL

    (local o externa).</p>

  </summary>



  <section id="behavior">

    <title>Comportamiento</title>



    <section>

      <title>Comportamiento anterior</title>



      <p>NCSA httpd 1.3 devolv&#237;a mensajes antiguos del error o

      problema encontrado que con frecuencia no ten&#237;an

      significado alguno para el usuario, y que no inclu&#237;an en

      los logs informaci&#243;n que diera pistas sobre las causas de

      lo sucedido.</p>

    </section>



    <section>

      <title>Comportamiento actual</title>



      <p>Se puede hacer que el servidor siga uno de los siguientes

      comportamientos:</p>



      <ol>

        <li>Desplegar un texto diferente, en lugar de los mensajes de

        la NCSA, o</li>



        <li>redireccionar la petici&#243;n a una URL local, o</li>



        <li>redireccionar la petici&#243;n a una URL externa.</li>

      </ol>



      <p>Redireccionar a otra URL puede resultar de utilidad, pero

      solo si con ello se puede tambi&#233;n pasar alguna

      informaci&#243;n que pueda explicar el error o problema y/o

      registrarlo en el log correspondiente m&#225;s claramente.</p>



      <p>Para conseguir esto, Apache define ahora variables de entorno

      similares a las de los CGI:</p>



      <example>

        REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, 

            image/jpeg<br />

        REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05 

            9000/712)<br />

        REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />

        REDIRECT_QUERY_STRING=<br />

        REDIRECT_REMOTE_ADDR=121.345.78.123<br />

        REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />

        REDIRECT_SERVER_NAME=crash.bang.edu<br />

        REDIRECT_SERVER_PORT=80<br />

        REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />

        REDIRECT_URL=/cgi-bin/buggy.pl

      </example>



      <p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p>



      <p>Al menos <code>REDIRECT_URL</code> y

      <code>REDIRECT_QUERY_STRING</code> se pasar&#225;n a la nueva

      URL (asumiendo que es un cgi-script o un cgi-include). Las otras

      variables existir&#225;n solo si exist&#237;an antes de aparecer

      el error o problema. <strong>Ninguna</strong> de estas variables

      se crear&#225; si en la directiva <directive

      module="core">ErrorDocument</directive> ha especificado una

      redirecci&#243;n <em>externa</em> (cualquier cosa que empiece

      por un nombre de esquema del tipo <code>http:</code>, incluso si

      se refiere al mismo servidor).</p>

    </section>

  </section>



  <section id="configuration">

    <title>Configuraci&#243;n</title>



    <p>El uso de <directive module="core">ErrorDocument</directive>

    est&#225; activado para los ficheros .htaccess cuando <directive

    module="core">AllowOverride</directive> tiene el valor

    adecuado.</p>



    <p>Aqu&#237; hay algunos ejemplos m&#225;s...</p>



    <example>

      ErrorDocument 500 /cgi-bin/crash-recover <br />

      ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />

      ErrorDocument 500 http://xxx/ <br />

      ErrorDocument 404 /Lame_excuses/not_found.html <br />

      ErrorDocument 401 /Subscription/how_to_subscribe.html

    </example>



    <p>La sintaxis es,</p>



    <example>

      ErrorDocument &lt;3-digit-code&gt; &lt;action&gt;

    </example>



    <p>donde action puede ser,</p>



    <ol>

      <li>Texto a mostrar. Ponga antes del texto que quiere que se

      muestre unas comillas ("). Lo que sea que siga a las comillas se

      mostrar&#225;. <em>Nota: las comillas (") no se

      muestran.</em></li>



      <li>Una URL local a la que se redireccionar&#225; la

      petici&#243;n.</li>



      <li>Una URL externa a la que se redireccionar&#225; la

      petici&#243;n.</li>

    </ol>

  </section>



  <section id="custom">

    <title>Mesajes de error personalizados y redirecciones</title>



    <p>El comportamiento de Apache en cuanto a las redirecciones ha

    cambiado para que puedan usarse m&#225;s variables de entorno con

    los script/server-include.</p>



    <section>

      <title>Antiguo comportamiento</title>



      <p>Las variables CGI est&#225;ndar estaban disponibles para el

      script al que se hac&#237;a la redirecci&#243;n. No se inclu&#237;a

      ninguna indicaci&#243;n sobre la precedencia de la

      redirecci&#243;n.</p>

    </section>



    <section>

      <title>Nuevo comportamiento</title>



      <p>Un nuevo grupo de variables de entorno se inicializa para que

      las use el script al que ha sido redireccionado. Cada

      nueva variable tendr&#225; el prefijo <code>REDIRECT_</code>.

      Las variables de entorno <code>REDIRECT_</code> se crean a

      partir de de las variables de entorno CGI que existen antes de

      la redirecci&#243;n, se les cambia el nombre

      a&#241;adi&#233;ndoles el prefijo <code>REDIRECT_</code>, por

      ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser

      <code>REDIRECT_HTTP_USER_AGENT</code>. Adem&#225;s, para esas

      nuevas variables, Apache definir&#225; <code>REDIRECT_URL</code>

      y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su

      origen. Tanto la URL original como la URL a la que es redirigida

      la petici&#243;n pueden almacenarse en los logs de acceso.</p>



      <p>Si ErrorDocument especifica una redirecci&#243;n local a un

      script CGI, el script debe incluir una campo de cabeceraa

      "<code>Status:</code>" en el resultado final para asegurar que

      es posible hacer llegar al cliente de vuelta la condici&#243;n

      de error que lo provoc&#243;. Por ejemplo, un script en Perl

      para usar con ErrorDocument podr&#237;a incluir lo

      siguiente:</p>



      <example>

        ... <br />

        print  "Content-type: text/html\n"; <br />

        printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />

        ...

      </example>



      <p>Si el script tiene como fin tratar una determinada

      condici&#243;n de error, por ejemplo

      <code>404 Not Found</code>, se pueden usar los

      c&#243;digos de error y textos espec&#237;ficos en su lugar.</p>



      <p>Tenga en cuenta que el script <em>debe</em> incluir un campo

      de cabecera <code>Status:</code> apropiado (como

      <code>302 Found</code>), si la respuesta contiene un campo de

      cabecera <code>Location:</code> (para poder enviar una

      redirecci&#243;n que se interprete en el cliente). De otra

      manera, la cabecera

      <code>Location:</code> puede que no tenga efecto.</p>

    </section>

  </section>

</manualpage>

docs/manual/style/lang/es.xml

+2 −2
Changes for docs/manual/style/lang/es.xml: 2 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -68,7 +68,7 @@ 
        <message id="syntax">Sintaxis</message>

        <message id="default">Valor por defecto</message>

        <message id="context">Contexto</message>

        <message id="override">Sustituye a</message>

        <message id="override">Prevalece sobre</message>

        <message id="status">Estado</message>

        <message id="module">M&#243;dulo</message>
@@ -92,7 +92,7 @@ 
        <message id="summary">Resumen de contenidos</message>



        <!-- Used for glossary link titles -->

        <message id="glossarylink">see glossary</message>

        <message id="glossarylink">ver glosario</message>





        <!-- Used in headers and footers -->