home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F278192_directivedict.xml.es < prev    next >
Extensible Markup Language  |  2004-07-12  |  13KB  |  299 lines
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
  3. <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
  4. <!-- English Revision: 1.2.2.5 (outdated: 1.2.2.6) -->
  5.  
  6. <!--
  7.  Copyright 2004 The Apache Software Foundation
  8.  
  9.  Licensed under the Apache License, Version 2.0 (the "License");
  10.  you may not use this file except in compliance with the License.
  11.  You may obtain a copy of the License at
  12.  
  13.      http://www.apache.org/licenses/LICENSE-2.0
  14.  
  15.  Unless required by applicable law or agreed to in writing, software
  16.  distributed under the License is distributed on an "AS IS" BASIS,
  17.  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18.  See the License for the specific language governing permissions and
  19.  limitations under the License.
  20. -->
  21.  
  22. <manualpage metafile="directive-dict.xml.meta">
  23.  
  24.   <title>Términos usados en las descripciones de las
  25.   Directivas</title>
  26.  
  27. <summary>
  28.     <p>Este documento define los términos que se usan para describir
  29.     las <a href="directives.html">directivas de configuración</a> de
  30.     Apache.</p>
  31. </summary>
  32. <seealso><a href="../configuring.html">Fichero de
  33. Configuración</a></seealso>
  34.  
  35. <section id="Description"><title>Descripción</title>
  36.  
  37. <p>Descripción resumida de para qué sirve la directiva.</p>
  38. </section>
  39.  
  40. <section id="Syntax"><title>Sintaxis</title>
  41.  
  42.     <p>Explica el formato de la directiva en la manera en que
  43.     aparecería en un fichero de configuración. La sintaxis es
  44.     específica para cada directiva, y se decribe en detalle en la
  45.     definición de cada una de ellas. Generalmente, es el nombre de la
  46.     directiva seguido del argumento o argumentos que correspondan
  47.     separados por espacios. Si un argumento contiene un espacio,
  48.     entonces debe escribirse entre comillas. Los argumentos opcionales
  49.     van entre corchetes ([]). Si cada argumento puede tomar más de un
  50.     valor, los valores posibles van separados por barras verticales
  51.     "|".  Los textos literales (los que no hay que sustituir) están en
  52.     el tipo de letra por defecto del resto del texto, mientras que los
  53.     que hay que sustituir están <em>resaltados</em>. Las directivas
  54.     que pueden tomar un número variable de argumentos terminan con
  55.     puntos suspensivos ("...").</p>
  56.  
  57.     <p>Las directivas usan una gran variedad de tipos de
  58.     argumentos. Algunos de los más comunes son:</p>
  59.  
  60.     <dl>
  61.       <dt><em>URL</em></dt>
  62.  
  63.       <dd>Un Localizador de Recursos Uniforme (Uniform Resource
  64.       Locator) que consiste en un esquema (www), un nombre de host
  65.       (example.com), y opcionalmente, una ruta; por ejemplo
  66.       <code>http://www.example.com/path/to/file.html</code></dd>
  67.  
  68.       <dt><em>URL-path</em></dt>
  69.  
  70.       <dd>La parte de una <em>url</em> que va a continuación del
  71.       esquema y del nombre de host, por ejemplo
  72.       <code>/path/to/file.html</code>. El <em>url-path</em> representa
  73.       al fichero visto desde el servidor web, en contraposición a
  74.       verlo tomando el sistema de ficheros como punto de
  75.       referencia.</dd>
  76.  
  77.       <dt><em>file-path</em></dt>
  78.  
  79.       <dd>La ubicación de un fichero en el sistema de archivos local
  80.       que empieza con el directorio raiz, por ejemplo,
  81.       <code>/usr/local/apache/htdocs/path/to/file.html</code>.  A
  82.       menos que se especifique otra cosa, un <em>file-path</em> que no
  83.       empieza con una barra será tratado como relativo a <a
  84.       href="core.html#serverroot">ServerRoot</a>.</dd>
  85.  
  86.       <dt><em>directory-path</em></dt>
  87.  
  88.       <dd>La ubicación de un directorio en el sistema de archivos
  89.       local que empieza en el directorio raiz, por ejemplo
  90.       <code>/usr/local/apache/htdocs/path/to/</code>.</dd>
  91.  
  92.       <dt><em>filename</em></dt>
  93.  
  94.       <dd>El nombre de un fichero sin información adicional sobre su
  95.       ubicación, por ejemplo <code>file.html</code>.</dd>
  96.  
  97.       <dt><em>regex</em></dt>
  98.  
  99.       <dd>Una expresión regular, que es una forma de describir un
  100.       patrón para encontrar sus equivalencias en un texto. La
  101.       definición de la directiva especificará con qué se comparará
  102.       <em>regex</em> para encontrar equivalencias.</dd>
  103.  
  104.       <dt><em>extension</em></dt>
  105.  
  106.       <dd>En general, es la parte del <em>filename</em> que va después
  107.       del último punto. Apache reconoce muchas de estas extensiones,
  108.       de manera que si un <em>filename</em> contiene mas de un punto,
  109.       cada parte separada por uno de esos puntos después del primero
  110.       se trata como una <em>extensión</em>.  Por ejemplo, el
  111.       <em>filename</em> <code>file.html.en</code> contiene dos
  112.       extensiones: <code>.html</code> y <code>.en</code>. Para las
  113.       directivas de Apache, puede especificar <em>extensiones</em> con
  114.       o sin punto delante. Las <em>extensiones</em> no distinguen
  115.       mayúsculas de minúsculas.</dd>
  116.  
  117.       <dt><em>MIME Type</em></dt>
  118.  
  119.       <dd>Es una forma de describir el formato de un fichero, que
  120.       consiste en un tipo de formato principal y un tipo de formato
  121.       secundario, separados por una barra, por ejemplo
  122.       <code>text/html</code>.</dd>
  123.  
  124.       <dt><em>env-variable</em></dt>
  125.  
  126.       <dd>El nombre de una <a href="../env.html">variable de
  127.       entorno</a> definida en el proceso de configuración de Apache.
  128.       Tenga en cuenta que esto no es necesariamente exactamente lo
  129.       mismo que una variable de entorno del sistema
  130.       operativo. Consulte la <a href="../env.html">documentación sobre
  131.       variables de entorno</a> si quiere obtener más información.</dd>
  132.     </dl>
  133. </section>
  134.  
  135. <section id="Default"><title>Valor por defecto</title>
  136.  
  137.     <p>Si una directiva tiene un valor por defecto (esto significa
  138.     que, si no especifica un valor explicitamente en la
  139.     configuración, el servidor Apache se comportará como si hubiera
  140.     especificado ese valor por defecto). Si no existe un valor por
  141.     defecto, en este apartado aparecerá "<em>None</em>". Tenga en
  142.     cuenta que el valor por defecto que se especifica aquí puede no
  143.     ser el mismo que el que viene especificado para la directiva en el
  144.     fichero de configuración httpd.conf que viene por defecto.</p>
  145. </section>
  146.  
  147. <section id="Context"><title>Contexto</title>
  148.  
  149.     <p>Indica en qué parte de los ficheros de configuración del
  150.     servidor se puede usar la directiva. Es una lista de elementos
  151.     separados por comas. Los valores permitidos son los
  152.     siguientes:</p>
  153.  
  154.     <dl>
  155.       <dt>server config</dt>
  156.  
  157.       <dd>Significa que la directiva puede ser usada en los ficheros
  158.       de configuración del servidor (<em>por ejemplo</em>,
  159.       <code>httpd.conf</code>), pero <strong>no</strong> dentro de las
  160.       secciones <directive module="core"
  161.       type="section">VirtualHost</directive> ni <directive
  162.       module="core" type="section">Directory</directive>. También
  163.       significa que la directiva no puede usarse en los ficheros
  164.       <code>.htaccess</code>.</dd>
  165.  
  166.       <dt>virtual host</dt>
  167.  
  168.       <dd>Este contexto significa que la directiva puede aparecer
  169.       dentro de las secciones <directive module="core"
  170.       type="section">VirtualHost</directive> de los ficheros de
  171.       configuración del servidor.</dd>
  172.  
  173.       <dt>directory</dt>
  174.  
  175.       <dd>Una directiva marcada como válida en este contexto puede
  176.       usarse en las secciones <directive module="core"
  177.       type="section">Directory</directive>, <directive type="section"
  178.       module="core">Location</directive>, y <directive module="core"
  179.       type="section">Files</directive> en los ficheros de
  180.       configuración del servidor, ateniéndose en todo caso a las
  181.       restricciones especificadas en el documento <a
  182.       href="../sections.html">Modo de funcionamiento de las secciones
  183.       Directory, Location y Files</a>.</dd>
  184.  
  185.       <dt>.htaccess</dt>
  186.  
  187.       <dd>Si una directiva es válida en este contexto, eso significa
  188.       que puede aparecer en los ficheros <code>.htaccess</code>. El
  189.       valor de la directiva puede no ser procesada si hay sobre ella
  190.       una orden de <a href="#Override" >sobreescritura</a> activa en
  191.       ese momento.</dd>
  192.     </dl>
  193.  
  194.     <p>Una directiva puede usarse <em>solo</em> en el contexto
  195.     especificado, si la usa en otro sitio, se producirá en error de
  196.     configuración que hará que el servidor no pueda servir peticiones
  197.     en el contexto correctamente, o que el servidor no pueda
  198.     funcionar en absoluto -- <em>por ejemplo</em>, puede que el
  199.     servidor no se inicie.</p>
  200.  
  201.     <p>Las ubicaciones válidas para una directiva son el resultado de
  202.     la operación booleana OR de todos los contextos listados más
  203.     arriba en que esté perimitido su uso. En otras palabras, una
  204.     directiva que esté marcada como válida en "<code>server config,
  205.     .htaccess</code>" puede usarse tanto en el fichero
  206.     <code>httpd.conf</code> como en los ficheros
  207.     <code>.htaccess</code>, pero no dentro de las secciones
  208.     <directive module="core" type="section">Directory</directive> o
  209.     <directive module="core"
  210.     type="section">VirtualHost</directive>.</p>
  211. </section>
  212.  
  213. <section id="Override"><title>Override</title>
  214.  
  215.     <p>Este atributo indica qué configuración de las especificadas
  216.     para una directiva es la que prevalece cuando la directiva aparece
  217.     en un fichero <code>.htaccess</code>. Si el <a href="#Context"
  218.     >contexto</a> de una directiva no permite que aparezca en ficheros
  219.     <code>.htaccess</code>, entonces no aparecerá ningún contexto en
  220.     este campo.</p>
  221.  
  222.     <p>Para que se aplique el valor especificado en este campo se usa
  223.     la directiva <directive module="core">AllowOverride</directive>, y
  224.     se aplica a un entorno en particular (por ejemplo un directorio)
  225.     y todo lo que haya por debajo de él, a menos que haya alguna
  226.     modificación posterior por directivas <directive
  227.     module="core">AllowOverride</directive> a niveles más bajos. La
  228.     documentación de esta directiva también especifica los valores que
  229.     puede tomar override.</p>
  230. </section>
  231.  
  232. <section id="Status"><title>Estado</title>
  233.  
  234.     <p>Indica el grado de integración con el el servidor web Apache
  235.     que presenta la directiva; en otras palabras, puede que tenga que
  236.     recompilar el servidor con un conjunto mejorado de módulos para
  237.     tener acceso a algunas directivas y a sus funcionalidades. Los
  238.     valores posibles de este campo son:</p>
  239.  
  240.     <dl>
  241.       <dt>Core</dt>
  242.  
  243.       <dd>Si una directiva tiene estado "Core", esto significa que su
  244.       grado de integración con el servidor Apache es muy alto, y que
  245.       está disponible siempre.</dd>
  246.  
  247.       <dt>MPM</dt>
  248.  
  249.       <dd>Una directiva etiquetada con el estado "MPM" pertenece a un
  250.       <a href="../mpm.html">Módulo de MultiProcesamiento</a>. Este
  251.       tipo de directiva estará disponible solamente si está usando uno
  252.       de los MPMs listados en la línea <a href="#Module">Módulo</a> de
  253.       la deficinición de la directiva.</dd>
  254.  
  255.       <dt>Base</dt>
  256.  
  257.       <dd>Una directiva etiquetada con el estado "Base" está soportada
  258.       por uno de los módulos estándar de Apache, que está compilado en
  259.       el servidor por defecto, y está siempre disponible a no ser que
  260.       haya eliminado ese módulo específicamente.</dd>
  261.  
  262.       <dt>Extension</dt>
  263.  
  264.       <dd>Una directiva con el estado "Extension" pertenece a un
  265.       módulo incluido en el kit del servidor Apache, pero que no está
  266.       normalmente compilado en el servidor. Para activar la directiva
  267.       y sus funcionalidades, tendrá que recompilar Apache.</dd>
  268.  
  269.       <dt>Experimental</dt>
  270.  
  271.       <dd>El estado "Experimental" indica que la directiva está
  272.       disponible como parte de la distribución Apache, pero que su correcto
  273.       funcionamiento no está todavía probado. Puede que la directiva
  274.       esté siendo documentada para completarla, o puede que no se
  275.       ofrezca soporte. El módulo que ofrece la directiva puede o no
  276.       estar compilado por defecto; compruebe la parte superior de la
  277.       página que describe la directiva y sus módulos para ver si hay
  278.       alguna indicación sobre su disponibilidad.</dd>
  279.     </dl>
  280. </section>
  281.  
  282. <section id="Module"><title>Módulo</title>
  283.  
  284.     <p>Indica el módulo en el cual se define la directiva.</p>
  285. </section>
  286.  
  287. <section id="Compatibility"><title>Compatibilidad</title>
  288.  
  289.     <p>Si una directiva no era originalmente parte de la versión 2.0
  290.     de la distribución de Apache, la versión en la que fue introducida
  291.     debe aparecer aquí. Además, si la directiva está disponible solo
  292.     en algunas plataformas, también debe figurar aquí.</p>
  293. </section>
  294.  
  295. </manualpage>
  296.  
  297.  
  298.  
  299.