docs/manual/getting-started.xml.es

<?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: 1690343 $ -->
<!-- Spanish translation : Daniel Ferradal Márquez -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You 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="getting-started.xml.meta">

  <title>Primeros Pasos</title>

<summary>
<p>Si es tu primera vez con el servidor Apache HTTTP, o incluso para llevar 
un sitio web, puede que no sepas por dónde empezar, o qué preguntas hacer.
hacer. Este documento le guiará a través de los conceptos básicos.</p>
</summary>

<section id="clientserver">
<title>Clientes, Servidores y URLs</title>

<p>
Las direcciones en la Web se expresan con URLs - Uniform Resource Locators
- que especifican un protocolo (p.ej. <code>http</code>), un nombre de servidor (e.g.
<code>www.apache.org</code>), una URL-path (p.ej.
<code>/docs/current/getting-started.html</code>), y posiblemente una query
string (p.ej. <code>?arg=value</code>) utilizada para pasar parámetros adicionales
al servidor.
</p>

<p>Un cliente (p.ej., un navegador web) conecta al servidor (p.ej., tu Servidor Apache HTTP),
con el protocolo especificado, y hace una <strong>petición</strong> de un recurso utilizando 
una URL-path.</p>

<p>La URL-path puede representar varias cosas en el servidor. Podría ser un fichero 
(como <code>getting-started.html</code>) un handler (como <a
href="mod/mod_status.html">server-status</a>) or algún tipo de fichero de programa
(como <code>index.php</code>). Revisaremos esto más adelante en la sección 
<a href="#content">Contenido de Sitio Web</a>.</p>

<p>
El servidor enviará una <strong>respuesta</strong> que consiste en un código de estado
y, opcionalmente, un cuerpo del mensaje.
El código de estado indica si una petición tuvo éxito, y si no, qué tipo de condición
de error se ha dado. Esto le dice al cliente qué debe hacer con la respuesta. Puedes
leer sobre los códigos de respuesta posibles en
<a href="https://cwiki.apache.org/confluence/display/httpd/CommonHTTPStatusCodes">La Wiki del Seridor
Apache</a>.</p>

<p>Detalles de la transacción, y cualquier condición de error, se escriben en los ficheros
de log. Esto se comenta en mayor detalle más abajo en la sección <a
href="#logs">Ficheros de Log y Solución de Problemas</a>.</p>

</section>

<section id="dns">
<title>Nombres de Host y DNS</title>

<p>Para conectar con un servidor, el cliente debe primero resolver
el nombre del servidor a una dirección IP - la ubicación en Internet donde reside el
servidor. Así, para que tu servidor sea accesible, es necesario que el nombre del
servidor está en DNS.</p>

<p>Si no sabes cómo hacer esto, necesitarás contactar con el administrador de tu red,
o proveedor de Internet, para realizar este paso por tí.</p>

<p>Más de un nombre de host puede apuntar a la misma dirección IP, y más de una
dirección IP puede apuntar al mismo servidor físico. Así puedes gestionar más
de un sitio web en el mismo servidor físico, usando una característica llamada
<a href="vhosts/">hosts virtuales</a>.</p>

<p>Si está haciendo pruebas con un servidor que no está accesible desde Internet,
puedes usar nombres de host en tu fichero hosts para hacer resolución de nombres
local. Por ejemplo, podrías querer poner en tu registro en tu fichero de hosts
para apuntar una petición hacia <code>www.example.com</code> en tu sistema local, 
para hacer pruebas. Esta entrada sería parecida a esto:</p>

<example>
127.0.0.1 www.example.com
</example>

<p>Un fichero de hosts probablemente esté ubicado en <code>/etc/hosts</code> or
<code>C:\Windows\system32\drivers\etc\hosts</code>.</p>

<p>Puedes leer más sobre ficheros de hosts en <a
href="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>, 
y más sobre DNS en <a
href="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
</section>

<section id="configuration">
<title>Ficheros de Configuración y Directivas</title>

<p>El Servidor Apache HTTP se configura con ficheros de texto.
Estos ficheros pueden estar ubicados en distintos sitios, dependiendo de 
cómo se haya instalado exactamente tu servidor. Las ubicaciones comunes
para estos ficheros pueden encontrarse en <a href="https://cwiki.apache.org/confluence/display/httpd/DistrosDefaultLayout">
la wiki de httpd</a>. Is instalaste httpd desde el código fuente, la
ubicación por defecto para estos ficheros se encuentra en
<code>/usr/local/apache2/conf</code>. El fichero de configuración por
defecto se llama generalmente <code>httpd.conf</code>. Esto también, puede
variar en distribuciones de terceros del servidor.</p>

<p>La configuración a menudo se separa en distintos ficheros más pequeños
para facilitar la gestión. Estos ficheros se cargan con la directiva <directive
module="core">Include</directive>. Los nombres o las ubicaciones de estos
sub-ficheros no es mágica, puede variar en gran manera de una instalación
a otra. Ordena y subdivide estos ficheros de la manera que tenga más sentido
para <strong>tí</strong>. Si la organicación de los ficheros por defecto
no tiene sentido para tí, siéntete libre de reorganizarla.</p>

<p>El servidor se configura colocando <a
href="mod/quickreference.html">directivas de configuración</a> en estos
ficheros de configuración. Una directiva es una palabra clave seguida de
uno o más parámetros para definir su valor.</p>

<p>La pregunta "<em>¿Dónde debo poner esta directiva?</em>" se contesta 
generalmente considerando dónde una directiva es efectiva. Si es una configuración
global, debería aparecer en el fichero de configuración, fuera de cualquier
sección <directive
type="section" module="core">Directory</directive>, <directive
type="section" module="core">Location</directive>, <directive
type="section" module="core">VirtualHost</directive>, u otra sección. Si es para
aplicar una configuración a un directorio en particular, debería ir dentro
de una sección 
<directive type="section" module="core">Directory</directive> haciendo referencia
a ese directorio, y así con todas. Vea el documento de <a href="sections.html">Secciones 
de Configuración</a> para obtener más detalle sobre estas secciones.</p>

<p>Además de los ficheros de configuración principales, ciertas directivas podría 
information en ficheros <code>.htaccess</code> ubicados en directorios de contenido.
Los ficheros <code>.htaccess</code> son principalmente para personas que no tienen
acceso a lo fichero(s) de configuración del servidor. Puedes leer más sobre los
ficheros <code>.htaccess</code> en el <a
href="howto/htaccess.html"><code>.htaccess</code> howto</a>.</p>

</section>

<section id="content">
<title>Contenido del Sitio Web</title>

<p>El contenido del sitio web puede tener distintas formas, pero puede dividirse
generalmente entre contenido estático y dinámico.</p>

<p>Contenido estático son cosas como ficheros HTML, ficheros de imágenes, ficheros CSS,
y otros ficheros que residen en el sistema de ficheros. La directiva <directive
module="core">DocumentRoot</directive> especifica dónde en el filesystem deberías
ubicar estos ficheros. Esta directiva está o bien configurada globalmente, o por
host virtual. Mira en tus ficheros de configuración para determinar como está esto
configurado en tu servidor.</p>

<p>Típicamente, un documento llamado <code>index.html</code> será servidor cuando
se solicita un directorio sin especificar un fichero. Por ejemplo si 
<code>DocumentRoot</code> se especifica con
<code>/var/www/html</code> y se hace una petición a 
<code>http://www.example.com/work/</code>, el fichero
<code>/var/www/html/work/index.html</code> será servido al cliente.</p>

<p>El contenido dinámico es cualquier cosa que se genera en tiempo de petición,
y puede cambiar de una petición a otra. Hay muchas formas de generar contenido
podría generarse. Varios <a
href="handler.html">handlers</a> están disponibles para generar contenido. <a
href="howto/cgi.html">programas CGI</a> podrían escribirse para generar contenido
para su sitio web.</p>

<p>Módulos de terceros como mod_php podrían usarse para escribir este código
que puede hacer variedad de cosas. Muchas aplicaciones de terceros, escritas
usanndo distintos lenguajes y herramientas, están disponibles para descarga e
instalación en su Servidor Apache HTTP. El soporte para estos elementos de
terceros está fuera el ámbito de esta documentación, y deberías encontrarse
su documentación en otros foros de soporte para responder a preguntas sobre
ellas.</p>
</section>

<section id="logs">
<title>Ficheros de Log y Solución de Problemas</title>
<p>Como administrador de un Servidor Apache HTTP, tus activos más valiosos
son los ficheros de log, y en el particular, el log de errores. Intentar hacer
Solución de Problemas sin el log de errores es como conducir con los ojos
cerrados.</p>

<p>La ubicación del log de errores se define con la directiva <directive
module="core">ErrorLog</directive>, que puede configurarse 
globalmnente o por host virtual. Entradas en el log de errores te indican
qué fue mal, y cuándo. A menudo también te indican cómo corregirlo. Cada 
mensaje de error contiene un código de error, que puedes buscar en línea
para obtener descripciones aún más detalladas sobre cómo resolver el 
problema. También puedes configurar el log de errores para que incluya
un id de LOG que luego puedes correlacionar a una entrada en el 
log de accesos, y así poder determinar qué petición causó la condición 
de error.</p>

<p>Puedes leer más sobre el registro de logs en la <a href="logs.html">
documentación de logs</a>.</p>
</section>

<section id="other">
<title>¿Qué viene a continuación?</title>

<p>Una vez que cumples los pre-requisitos es hora de avanzar.</p>

<p>Esto documento sólo cubre el mínimo básico. Esperamos que esto
te ayude a comenzar, pero hay muchas otras cosas que puede que necesites
aprender.</p>

<ul>
<li><a href="http://httpd.apache.org/download.cgi">Descargar</a></li>
<li><a href="install.html">Instalar</a></li>
<li><a href="configuring.html">Configurar</a></li>
<li><a href="invoking.html">Arrancar</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Preguntas Realizadas a menudo</a></li>
</ul>

</section>

</manualpage>