创建带自定义母版页的SharePoint 2013门户：求最佳实践与建议

嘿，看了你规划的从零搭建带自定义母版页的SharePoint 2013多语言门户步骤，框架已经很扎实了！结合我做过的几个类似项目，给你补充一些关键的最佳实践和每个步骤的细化建议，帮你少走弯路：

• 先做原型验证：正式搭建前，用静态HTML原型敲定多语言布局细节（尤其是阿拉伯语从右到左的RTL排版），避免母版页转换后再大改结构。
• 严格遵循设计管理器工作流：别跳过“映射到SharePoint”的步骤，它能自动帮你关联CSS/JS资源，减少手动配置的出错概率。
• 多语言内容规划前置：变体不只是语言切换，要提前把内容类型、页面布局的多语言字段规划好，不然后期内容迁移会很头疼。

1. 从中央管理创建Web应用程序 #

• 按需启用匿名访问：如果门户要对外公开，务必开启，但后续要在网站集层面严格控制权限；内部门户的话，优先用基于声明的身份验证，方便AD集成。
• 提前配置备用访问映射：规划好多语言域名（比如en.yourportal.com和ar.yourportal.com），避免后期修改Web应用URL结构带来的麻烦。

2. 创建网站集 #

• 选发布门户模板（Publishing Portal）：它自带页面布局、内容类型和变体支持，比空白模板更适合企业门户场景，能省很多基础配置的功夫。
• 激活发布功能：网站集和网站层级都要激活「SharePoint Server Publishing Infrastructure」和「SharePoint Server Publishing」功能，这是设计管理器和变体生效的必要前提。

3. 启用变体以支持阿拉伯语和英语 #

• 先设变体根网站：建议把根网站作为英语母版站点，再创建阿拉伯语变体子站点。注意RTL语言的变体要单独设置“从右到左”的页面布局。
• 规范配置变体标签：给每种语言设唯一标签（比如en-US和ar-SA），可以启用“自动创建页面”，但要清楚：自动生成的只是页面框架，内容还是得手动或通过工具同步。
• 测试变体导航：务必验证语言切换按钮能正确跳转对应变体页面，且导航菜单在RTL模式下是反向显示的。

4. 上传html、css和js文件 #

• 用设计管理器的“上传设计文件”功能：别直接传到普通文档库，设计管理器会自动把文件存到_catalogs/masterpage/HTML Design Files目录，方便后续母版页转换。
• 资源分类管理：把CSS、JS、图片分别放到css/、js/、images/子文件夹，结构清晰才好维护。
• 准备RTL样式：为阿拉伯语单独写RTL版本的CSS（比如后缀加-rtl.css），后续在母版页里根据当前语言动态加载对应的样式文件。

5. 使用设计管理器转换html文件 #

• 转换前清理HTML代码：删掉多余的内联样式和JS，尽量用外部文件引用，SharePoint设计管理器对简洁的HTML兼容性更好。
• 正确映射SharePoint占位符：在HTML里添加设计管理器提供的注释占位符，比如：

  <!--SPM:<SharePoint:DeltaPlaceHolderMain runat="server" />-->
  

  确保母版页能正确继承SharePoint的核心功能（导航、搜索、页面内容区等）。
• 预览测试：转换完成后先在测试网站集预览，检查占位符渲染是否正常、CSS/JS加载是否成功，重点关注RTL布局的对齐问题。

6. 在Visual Studio中创建解决方案生成用户控件和自定义Web部件 #

• 用官方模板：选「SharePoint 2013 - 空白项目」，再添加“用户控件”和“Web部件”项，目标框架设为.NET Framework 4.5。
• 选对解决方案类型：如果是云环境或受限环境，优先用Sandboxed解决方案；需要访问服务器级资源（比如数据库）再用Farm Solution，但要注意部署权限要求。
• 多语言资源支持：在解决方案里添加.resx资源文件，给每个Web部件和用户控件的文本提供多语言版本，通过ResourceManager动态加载对应语言的内容。
• 部署测试：先在开发环境部署，测试Web部件在变体页面的渲染效果，尤其是RTL模式下的布局是否符合预期。

• 版本控制：用Git或TFS管理HTML、CSS、JS和Visual Studio代码，避免版本混乱，方便回滚。
• 性能优化：压缩CSS和JS文件，启用SharePoint的输出缓存和对象缓存，提升门户加载速度。
• 权限规划：提前设置网站集管理员、内容作者、访客等角色的权限，确保多语言内容的编辑权限隔离，避免误操作。

内容的提问来源于stack exchange，提问作者Mostafa