Inserción de server-side includes en Dreamweaver

Última actualización el 25 abr 2024

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

Nota

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

Acerca de server-side includes

Puedes usar Dreamweaver para insertar inclusiones del lado del servidor en tus páginas, editarlas o previsualizar páginas que contengan inclusiones.

Un include del lado del servidor es un archivo que el servidor incorpora a tu documento cuando un explorador solicita tu documento del servidor.

Cuando el explorador de un visitante solicita el documento que contiene la instrucción de inclusión, el servidor procesa la instrucción de inclusión y crea un nuevo documento en el que la instrucción de inclusión se reemplaza por el contenido del archivo incluido.El servidor envía entonces este nuevo documento al explorador del visitante.Sin embargo, cuando abres un documento local directamente en un navegador, no hay ningún servidor que procese las instrucciones include en ese documento, así que el navegador abre el documento sin procesar esas instrucciones, y el archivo que debe ser incluido no aparece en el navegador.Por tanto, puede ser difícil, sin usar Dreamweaver, visualizar archivos locales y verlos como aparecerán a los visitantes después de haberlos puesto en el servidor.

Con Dreamweaver puedes obtener una vista previa de los documentos tal como aparecerán una vez que estén en el servidor, tanto en la vista de Diseño como cuando uses la función Vista previa en explorador.Para hacerlo, sin embargo, debes asegurarte de que estás previsualizando el archivo que contiene el include como un archivo temporal.(Selecciona Editar > Preferencias, selecciona la categoría Vista previa en explorador y asegúrate de que la opción Vista previa usando archivo temporal esté seleccionada.)

Nota

Si estás usando un servidor de prueba, como Apache o Microsoft IIS, para previsualizar tus archivos en tu unidad local, no necesitas previsualizar el archivo como un archivo temporal porque el servidor realiza el procesamiento por ti.

Colocar un include del lado del servidor en un documento inserta una referencia a un archivo externo; no inserta el contenido del archivo especificado en el documento actual.El contenido del archivo especificado debe contener solo el contenido que quieres incluir.Es decir, el archivo include no debe contener ninguna etiqueta head, etiquetas body, o etiquetas html (refiriéndose a la etiqueta <html>: las etiquetas HTML de formato, como las etiquetas p, las etiquetas div, y demás, están bien).Si las tiene, estas etiquetas entrarán en conflicto con las etiquetas en el 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 una inclusión del lado del servidor, es necesario editar directamente el archivo que se está incluyendo.Cualquier cambio al archivo externo se refleja automáticamente en cada documento que lo incluye.

Hay dos tipos de server-side include: Virtual y Archivo. Dreamweaver inserta inclusiones de tipo Archivo de forma predeterminada, pero puedes usar el inspector de Propiedades para seleccionar la que sea apropiada para el tipo de servidor web que uses:

  • 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

Desafortunadamente, IIS no te permite incluir un archivo en una carpeta situada por encima de la carpeta actual en la jerarquía de carpetas, a menos que se haya instalado software especial en el servidor.Si debes incluir un archivo de una carpeta más alta en la jerarquía de carpetas en un servidor IIS, pregunta a tu administrador del sistema si el software necesario está instalado.

  • 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

Puedes usar Dreamweaver para insertar inclusiones del lado del servidor en tu página.

Inserción de un server-side include

Selecciona Insertar > Include del lado del servidor.
En el cuadro de diálogo que aparece, examina y selecciona un archivo.

De forma predeterminada, se inserta un include de tipo Archivo.

Para cambiar el tipo del include, selecciona el include del lado del servidor en la ventana Documento y cambia el tipo en el inspector de propiedades (Ventana > Propiedades), de la siguiente manera:
  • 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

Selecciona el include del lado del servidor en la ventana Documento.
Abra el inspector de propiedades (Ventana > Propiedades).
Siga uno de estos procedimientos:
  • Haz clic en el icono de carpeta y examina y selecciona un nuevo archivo para incluir.

  • En el cuadro, escriba la ruta y el nombre de archivo del nuevo archivo a incluir.

Editar el contenido de las inclusiones del lado del servidor

Puedes usar Dreamweaver para editar las inclusiones del lado del servidor.Para editar el contenido asociado con el archivo incluido, debes abrirlo.

Seleccione la inclusión del lado del servidor en la vista Diseño o en la vista 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 reflejan inmediatamente en el documento actual y en cualquier documento posterior que abras que incluya el archivo.

Cargue el archivo include en el sitio remoto, si es necesario.