Wyam主题开发：能否通过Markdown元数据为页面指定布局？

你想通过元数据指定特定页面布局的思路非常对，Wyam本身就支持通过Markdown文件顶部的YAML元数据来覆盖默认布局。具体操作步骤如下：

1. 在about.md中添加布局元数据 #

直接在你的about.md文件顶部的YAML块里加上Layout字段，指定你要使用的布局文件名：

---
Title: About Our Project
Layout: _About.cshtml
---
# 关于我们
这里是about页面的内容...

如果你的布局文件和默认_Layout.cshtml在同一个目录（比如Views/Shared），也可以简化写成Layout: _About，不过建议写全文件名，避免潜在的路径歧义。

2. 确保默认模板读取元数据布局 #

要让这个配置生效，你需要确保处理Markdown页面的Razor模板（比如你用来渲染Markdown内容的_Page.cshtml或者类似模板）会读取元数据里的Layout值。在模板里添加这样的代码：

@{
    // 优先使用元数据指定的布局，没有则用默认的_Layout.cshtml
    Layout = Model.String("Layout", "_Layout.cshtml");
}

<!-- 这里渲染Markdown内容 -->
@Model.Content

这样，当Wyam渲染about.md时，会自动识别元数据里的Layout配置，替换掉默认布局。

3. 注意事项 #

• 确认_About.cshtml布局文件放在Wyam能找到的路径下，通常是Views/Shared目录（如果你的Razor模块配置的是这个视图根目录）。
• 如果你的布局文件在其他路径，需要在Layout字段里写相对路径，比如../CustomLayouts/_About.cshtml，或者在Wyam配置中添加额外的视图搜索路径。
• 测试时可以运行Wyam生成站点后，查看about.html的源码，检查是否加载了_About.cshtml里的布局内容。

这个方法灵活且符合Wyam的设计理念，完全能满足你给特定页面设置专属布局的需求。

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