Personalización de páginas maestras en Windows SharePoint Services

Al instalar Windows SharePoint Services, se aplica una sola página maestra predeterminada a todas las páginas de un sitio. Sin embargo, puede crear sus propias páginas maestras para un sitio y ponerlas a disposición del sitio y de todos los sitios situados por debajo.

Hay dos formas posibles de personalizar páginas maestras en Windows SharePoint Services:

• Copie el archivo default.master que se instala con Windows SharePoint Services en otro archivo y realice los cambios en el archivo cuyo nombre ha cambiado.

• Edite la página default.master en Microsoft Office SharePoint Designer 2007, donde puede editar y ver páginas maestras, crear y ver páginas de contenido con las páginas maestras marcadas como maestras y de sólo lectura.

  Office SharePoint Designer es la única aplicación en la que se puede ver una vista previa de una página maestra.

Advertencia

No edite el archivo default.master directamente en la carpeta <%System Drive%>Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\GLOBAL\ .

Cuando se crea un nuevo sitio, se usa la página maestra predeterminada que se encuentra en el sistema de archivos. Si una página maestra se personaliza con Office SharePoint Designer, Windows SharePoint Services almacena una versión modificada de la página maestra en la base de datos de contenido. Los cambios en la página maestra no afectan a las páginas de contenido que hacen referencia a ella, sino que permanecen en el sistema de archivos.

Nota

La personalización de la página maestra de un sitio sólo cambia las páginas de contenido para ese sitio. No afecta a páginas de aplicación (páginas en _layouts) porque las páginas _layouts son páginas de la aplicación Windows SharePoint Services y se comparten entre varios sitios.

Referencia a la página maestra desde una página de contenido

Windows SharePoint Services proporciona varios tokens para hacer referencia a la página maestra: dos tokens dinámicos ("~masterurl/default.master" y "~masterurl/custom.master") y dos estáticos ("~site/default.master" y "~sitecollection/default.master").

Nota

Estos tokens se aplican sólo a las páginas maestras de Windows SharePoint Services; no se aplican a las páginas maestras de ASP.NET 2.0.

• Token dinámico "~masterurl/default.master"

  Este token hace referencia a una página maestra de una página de contenido mediante el atributo MasterPageFile junto con el valor de la propiedad MasterUrl. Como ejemplo, en la siguiente directiva de página, <%@ Page MasterPageFile="~masterurl\default.master"%>, el token "~masterurl/default.master" es reemplazado en tiempo de ejecución por el valor de la propiedad MasterUrl. Esta propiedad contiene la ruta completa relativa al servidor a la página maestra, incluido el nombre de archivo.

  En el momento de la instalación, todas las páginas de contenido de SharePoint usan este token dinámico y la propiedad MasterUrl se establece en default.master de Windows SharePoint Services; sin embargo, puede cambiar este valor en cualquier momento para que señale a otra página maestra.

  Importante

  La cadena completa "~masterurl/default.master" constituye el token.

• Token dinámico "~masterurl/custom.master"

  Este token hace referencia a una página maestra de una página de contenido mediante el atributo MasterPageFile con el valor de la propiedad CustomMasterUrl. El token "~masterurl/custom.master" es reemplazado en tiempo de ejecución por el valor de la propiedad CustomMasterUrl, que contiene la ruta completa relativa al servidor a la página maestra, incluido el nombre de archivo.

  De forma predeterminada, ninguna página de contenido de SharePoint usa este token, que se proporciona para poder tener una segunda página maestra compartida.

  Importante

  Toda la cadena "~masterurl/custom.master" comprende el token.

• Tokens estáticos "~site/default.master" y "~sitecollection/default.master"

  Puede usa estos tokens para vincular a una página maestra relativa a una colección de sitios o a un sitio. Por ejemplo, si la página de contenido se encuentra en http://siteColl/subsite1/subsite2/default.aspx y usa el token "~sitecollection/mypage.master", la página de contenido usará la página maestra situada en http://siteColl/mypage.master. Si usa el token "~site/mypage.master", la página de contenido usará la página maestra que se encuentra en http://siteColl/subsite1/subsite2/mypage.master.

Nota

Las propiedades MasterUrl y CustomMasterUrl se establecen en "/_catalogs/masterpage/default.master" de forma predeterminada. Si posteriormente necesita eliminar default.master, debe establecer un valor diferente para ambas propiedades y no sólo para una, o se producirá un error que sugiere que el archivo default.master todavía se usa como la página maestra del sitio.

Como alternativa, puede cambiar la página maestra usada por una página de contenido cambiando directamente la dirección URL del atributo MasterPageFile especificado en la directiva de página. Sin embargo, a diferencia de usar la propiedad MasterUrl para cambiar la página maestra, éste es un cambio en el contenido de la página.

Consideraciones adicionales para trabajar con páginas maestras en Windows SharePoint Services

Tenga en cuenta lo siguiente cuando trabaje con páginas maestras en Windows SharePoint Services:

• El modo de compilación de páginas maestras funciona igual que el modo de compilación de cualquier otra página .aspx. Puede cambiar el modo de compilación en cualquier momento y se pueden combinar modos de compilación para las páginas maestras y de contenido; por ejemplo, una página maestra compilada y una página de contenido que no está compilada.

  No obstante, recuerde que aunque las páginas maestras compiladas pueden contener scripts incorporados, una vez que la página se personaliza en Office SharePoint Designer, o una herramienta similar, la página ya no está compilada y el script ya no funciona. Por este motivo, se recomienda no incluir scripts integrados en las páginas maestras.

• De forma predeterminada, Windows SharePoint Services no usa páginas maestras anidadas, pero no impide a los usuarios que las usen. Puede crear páginas maestras en cualquier nivel y tener una página maestra que haga referencia a otra página maestra. Por ejemplo, puede hacer referencia a una página maestra desde otra página maestra usando la siguiente directiva:

  <%@ Master master=MyParent.master %>
  

  Nota

  Puede que algunos editores de páginas no sean realmente compatibles con las páginas maestras anidadas.

• No puede agregar elementos web en zonas a una página maestra. Puede agregar elementos web estáticos (elementos fuera de una zona) a una página maestra, pero no puede agregar elementos web dinámicos a páginas maestras.

  Puede agregar zonas a páginas maestras y posteriormente agregar elementos web a la zona en el explorador, pero los elementos web estarán asociados a la página de contenido.

Vea también

Otros recursos

Páginas maestras predeterminadas de Windows SharePoint Services
Procedimiento para personalizar la visualización de Inicio rápido