Guía del usuario Cancelar

Inserción de server-side includes en Dreamweaver

Buscar

Última actualización el 3 may 2021

Nota:

la interfaz de usuario se ha simplificado en Dreamweaver CC y versiones posteriores. Como resultado, es posible que no encuentre algunas de las opciones que se describen en este artículo en Dreamweaver CC y versiones posteriores. Para obtener más información, consulte este artículo.

Acerca de 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 de 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.

Inserción de server-side includes

Puede utilizar Dreamweaver para insertar server-side includes en la página.

Inserción de un server-side include

Seleccione Insertar > Server-Side Include.
En el cuadro de diálogo que aparece, localice y seleccione un archivo.

De forma predeterminada, se inserta un include de tipo Archivo.
Para cambiar el tipo del include, seleccione el server-side include en la ventana de documento y cambie el tipo en el inspector de propiedades (Ventana > Propiedades) tal como se indica a continuación:
- 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 determinados).
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.

Cambio del archivo incluido

Seleccione el server-side include en la ventana de documento.
Abra el inspector de propiedades (Ventana > Propiedades).
Siga uno de estos procedimientos:
- Haga clic en el icono de carpeta para localizar y seleccionar un nuevo archivo para incluir.
- En el cuadro, escriba la ruta y el nombre del nuevo archivo para incluir.

Edición del contenido de server-side includes

Puede utilizar Dreamweaver para editar server-side includes. Para editar el contenido asociado al archivo incluido, deberá abrir el archivo.

Seleccione el server-side include en la vista de Diseño o la vista de Código y haga clic en Editar en el inspector de propiedades.

El archivo incluido se abrirá en una nueva ventana de documento.
Edite el archivo y, a continuación, guárdelo.

Los cambios se reflejarán inmediatamente en el documento actual y en los documentos que abra posteriormente que contengan el archivo.
Cargue el archivo include en el sitio remoto, si es necesario.