PDF (adobe.com)

Server-side includes

Puede utilizar Dreamweaver para insertar server-side includes en sus páginas, editar los includes u obtener una vista previa de páginas que contengan includes.

Un server-side include es un archivo que el servidor incorpora en el documento cuando un navegador solicita el documento del servidor.

Cuando el navegador de un visitante solicita el documento que contiene la instrucción del include, el servidor la procesa y crea un documento nuevo en el que la instrucción del include se sustituye por el contenido del archivo incluido. A continuación, el servidor envía este nuevo documento al navegador del visitante. Sin embargo, al abrir un documento local directamente en un navegador, no hay ningún servidor que procese las instrucciones del include en dicho documento, por lo que el navegador abre el documento sin procesar esas instrucciones y el archivo que supuestamente debería incluirse no aparece en el navegador. Por eso, si no se usa Dreamweaver, puede resultar difícil mirar archivos locales y verlos tal como los verán los visitantes una vez que se hayan colocado en el servidor.

Con Dreamweaver se puede obtener una vista previa de los documentos tal como aparecerán en el servidor, tanto en la vista Diseño como al utilizar la función Vista previa en el navegador.. No obstante, para ello es necesario asegurarse de que se obtiene una vista previa del archivo que contiene la include como archivo temporal. (Seleccione Edición > Preferencias, elija la categoría Vista previa en el navegador y asegúrese de que está seleccionada la opción Vista previa utilizando el archivo temporal.)

Nota: Si utiliza un servidor de prueba, como Apache o Microsoft IIS, al obtener una vista previa de los archivos en la unidad local, no será necesario que obtenga una vista previa del archivo como archivo temporal, ya que el servidor realiza el proceso automáticamente.

Al colocar un server-side include en un documento se inserta una referencia a un archivo externo y no se inserta el contenido del archivo especificado en el documento actual. El archivo especificado sólo debe tener el contenido que desee incluir. Es decir, el archivo de include no debe contener ninguna etiqueta head, body o html (es decir, la etiqueta <html>; las etiquetas HTML de formato, como p, div, etc., no plantean ningún problema). Si las contiene, estas etiquetas provocarán conflictos con las etiquetas del documento original y Dreamweaver no mostrará la página correctamente.

No puede editar el archivo incluido directamente en un documento. Para editar el contenido de un server-side include, deberá editar directamente el archivo que desea incluir. Los cambios realizados en el archivo externo se reflejarán automáticamente en todos los documentos que lo incluyan.

Hay dos tipos de server-side include: Virtual y Archivo. Dreamweaver inserta includes de tipo Archivo de manera predeterminada, aunque puede utilizar el inspector de propiedades para seleccionar uno que resulte adecuado para el tipo de servidor Web que utilice:

  • Si se trata de un servidor Web Apache, elija el tipo Virtual. En Apache, Virtual funciona en todos los casos, mientras que Archivo sólo funciona en algunos casos.

  • Si su servidor es Microsoft Internet Information Server (IIS), elija Archivo. (Virtual funciona con IIS sólo en ciertos casos.)

    Nota: Lamentablemente, IIS no le permitirá incluir un archivo en una carpeta de una jerarquía superior a la de la carpeta actual, salvo en el caso de que se haya instalado un software especial en el servidor. Si es necesario incluir un archivo desde una carpeta de una jerarquía superior en un servidor IIS, pregunte al administrador del sistema si está instalado el software necesario.

  • Para otros tipos de servidores, o si desconoce el tipo de servidor que está usando, pregunte al administrador del sistema la opción que debe emplear.

    Algunos servidores están configurados de manera que examinan todos los archivos para ver si contienen server-side includes; otros servidores están configurados para examinar solamente los archivos con una extensión determinada, como .shtml, .shtm o .inc. Si un server-side include no le funciona, pregunte al administrador del sistema si es necesario utilizar una extensión concreta en el nombre del archivo que usa el server-side include. (Por ejemplo, si el archivo se llama canoe.html, puede ser necesario cambiarle el nombre por canoe.shtml.) Si desea que los archivos conserven las extensiones .html o .htm, solicite al administrador del sistema que configure el servidor para examinar todos los archivos (no sólo los archivos con extensiones determinadas) para comprobar si contienen server-side includes. Sin embargo, el análisis de un archivo para comprobar si contiene server-side includes implica un poco más de tiempo de proceso, por lo que las páginas que el servidor analiza tardan un poco más en estar disponibles que las otras; por ello, algunos administradores de sistemas no proporcionarán la opción de analizar todos los archivos.