SharePoint 加载项模型中的母版页

在新的 SharePoint 外接程序模型中实施 SharePoint 网站中的自定义母版页的方法与使用完全信任代码/场解决方案不同。 在典型的完全信任代码 (FTC)/场解决方案的品牌打造场景中，创建自定义母版页以实施自定义品牌打造。 母版页通常打包在具有使用声明性代码和 FTC/场解决方案的功能中，以在 SharePoint 网站中部署和注册母版页。

SharePoint 外接程序模型品牌打造场景中也会使用自定义母版页。 可以通过远程预配模式在 SharePoint 网站部署和注册你的自定义母版页。

自定义母版页的高级别准则

作为经验法则，我们将提供以下有关自定义母版页的高级别准则。

• 可使用自定义母版页来自定义 SharePoint 网站，但请注意，这会导致未来更新产生其他长期性的成本和挑战。

  • 在大多数情况下，你可以通过主题、组合外观和备用 CSS 以完成所有常见品牌打造场景。

    See the Branding SharePoint Sites (SharePoint Add-in Recipe) to learn all about the different branding options you have for SharePoint sites with the SharePoint Add-in model. The recipe will help you consider the short and long-term impact of customization from an operational and a maintenance perspective. You may discover that a custom master page is not required to implement your specific branding requirements.

  • 如果选择使用自定义母版页，则需要做好准备，以在 Office 365 应用主要功能更新后将相应的更改应用到自定义母版页中。

• 使用远程预配以通过 SharePoint 网站部署并注册自定义母版页。
• 请不要使用声明性代码或沙盒代码在 SharePoint 网站部署和注册母版页。

团队网站与发布网站

何时需要自定义母版页？

向 SharePoint 网站应用自定义品牌打造时，将需要构建团队网站和发布网站。 通常情况下，在本地和 Office 365 场景中基于 SharePoint 打造的内部网会结合使用团队网站和发布网站。

自定义品牌打造要求经常需要进行主题和 JavaScript 嵌入技术无法完成的特定布局的更改。

在这种情况下，团队网站通常对发布网站要求的自定义品牌打造的数量不作要求，且适用于移动设备的现成的 SharePoint 现代视图通常足以支持团队网站的移动设备。 由于是这种情况，因此最好只对发布网站使用自定义母版页，并使用 AlternativeCSS 和自定义 SharePoint 主题 (*.spcolor 文件) 、字体方案 (*.spfont 文件) 和定义为组合外观的背景图像，以打造团队网站品牌。

部署注意事项

• 将自定义母版页部署到发布网站时，只需将自定义母版页部署到根网站。
  • Provisioning.PublishingFeatures（O365 PnP 示例）演示了如何将自定义母版页部署到发布网站。
  • Provisioning SharePoint Publishing Features）（预配 SharePoint 发布功能（O365 PnP 视频）可指导你完成此示例。
• 将自定义母版页部署到非发布网站时，需要将自定义母版页部署到每个网站。

预配网站时，通常会应用自定义母版页。 远程预配过程非常适合这种方法。 通常，仅在原型制作和修改不计划扩大规模以包括其他网站集或子网站的单个 SharePoint 网站时，需要使用 Web 浏览器手动应用 SharePoint 品牌自定义。

• 有关部署细节和其他示例的详细信息，请参阅模块（SharePoint 外接程序方法）和网站预配（SharePoint 外接程序方法）。

有关自定义母版页和 SharePoint 网站的页面布局的详细信息。

自定义母版页是实施自定义品牌打造要求的唯一方式时，可以创建自定义母版页和页面布局。 请注意本文开篇提到的有关使用此方法将产生的长期维护成本的相关要点。

• 将自定义母版页用于 SharePoint 网站可以提供最终级别的自定义（无限制）。
• 使用适于 SharePoint 网站的自定义母版页需要最多的时间来进行短期和长期的实施和维护。
• 服务更新产生的现成母版页中的任何更改不会反映在自定义母版页中。
• 可以在每网站级别应用自定义母版页。
• 使用自定义母版页时，建议从其中一个现有的母版页开始，并对其进行修改以满足你的需求。
  • 最大程度地减少使用自定义母版页进行的自定义量，当对现有的母版页的 Office 365 服务的更改必须复制到自定义母版页时，该操作会使更新更为简单。
• SharePoint 母版页中有许多必备的内容占位符，这些一定不能删除，否则会导致页面出错。 调用必备内容占位符并向网站分配母版页时出现错误，此时就说明你已删除必备内容占位符。

何时适合将自定义母版页和页面布局用于 SharePoint 网站？

此选项在品牌打造需求非常明确或正在使用发布网站时适用。

建议的部署方法

• 可以通过 Web 浏览器手动上传自定义母版页并将其手动分配到组合外观。
• 还可以通过远程预配模式将自定义母版页上传并分配到 SharePoint 网站。
  • 有关部署细节和其他示例的详细信息，请参阅模块（SharePoint 外接程序方法）和网站预配（SharePoint 外接程序方法）。

相关链接

• 模块（SharePoint 外接程序方法）
• 网站预配（SharePoint 外接程序方法）
• SharePoint 网站品牌打造（SharePoint 外接程序方法）
• Ignite 2015 - 使用重复模式和做法深入了解 Office 365 中的安全 SharePoint 品牌打造
• 指南文章中 https://aka.ms/OfficeDevPnPGuidance
• MSDN 中的引用位于 https://aka.ms/OfficeDevPnPMSDN
• 视频中的 https://aka.ms/OfficeDevPnPVideos

PnP 示例

• 使用 CSOM 进行主题管理（O365 PnP 示例）
• Web 对象中的 AlternateCSSUrl 和 SiteLogoUrl 属性（O365 PnP 示例）
• 设置网站的主题（O365 PnP 示例）
• 在 SharePoint 相关应用中设置 SharePoint 主题（O365 PnP 示例）
• 进行现成的西雅图母版响应（O365 PnP 示例）
• 示例和内容（网址为 https://github.com/SharePoint/PnP）

适用于

• Office 365 多租户 (MT)
• Office 365 专用 (D) 部分
• SharePoint 2013 本地 – 部分

专用模式和本地模式在使用 SharePoint 外接程序模型技术方面完全相同，但在可以使用的可能的技术方面存在差异。