Shopify 知识库 · 指南
Shopify Article 文章页配方索引
从 article template type 进入购买指南与使用指南两种文章配方，说明按读者阶段选择配方的判据、alternate 模板的分配方式、article 模板与对象的已核验约束，并链接博客与文章的字段来源说明。
Shopify article template type 渲染单篇文章，路径样例 /blogs/{blog}/{article}。官方模板页写明，它显示文章的完整内容，并可带一个可选的评论区。文章由 Article 资源驱动：标题、作者、发布时间、正文、摘要、封面与标签是运行时数据，不是可以复制进共享 Section 的静态文案。博客与文章的字段来源、阅读任务、空状态与配置检查已在博客、文章与普通页面说明，本文不重复，只回答“不同任务的文章各自怎样组合”。
每份文章配方按同一条检索路径展开：
article→ 可选 alternate → 业务文章 → 页面内容清单 → 页面组合 → 内容 × 展现 → Theme 实现
平台关系先读Template、业务页面与内容关系网。文章的内容类型是博客或资源，不同文章类型只是它在不同读者阶段的用法。
按顾客任务选择页面
选择判据：
| 判据 | 购买指南 | 使用指南 |
|---|---|---|
| 读者阶段 | 尚未决定买什么 | 已拥有或正在使用某件商品 |
| 主要动作 | 比较、排除、选定 | 逐步操作、检查结果、升级求助 |
| 与商品的关系 | 可能涉及多个候选，需要披露推荐依据 | 通常对应一个明确型号或版本 |
| 主要风险 | 促销伪装成指南、比较维度不公 | 步骤与型号不符、安全说明缺失 |
| 更新触发 | 商品目录、价格、库存与推荐关系变化 | 商品版本、部件、操作界面变化 |
一篇文章同时想“帮人选”和“教人用”时，拆成两篇并互相链接；不要把购买推荐塞进故障排查文章。新闻、品牌故事、案例这类文章暂无独立配方，读博客与文章的内容结构即可。
先判断是否需要 alternate
多数文章共用默认 article.json 即可。只有页面组成稳定不同、会被一批文章持续复用、且不能靠文章正文和单个 Section 设置表达时，才建立 alternate，例如 article.buying-guide.json；后缀是主题自己的命名，不是 Shopify 预置类型。判断规则见Alternate template 的判断规则，本文不复制。
已核验的平台约束
| 事项 | 官方页面所写 |
|---|---|
| 模板用途与位置 | article 模板渲染文章页，包含文章完整内容与可选的评论区；文件为 templates/article.json |
| 必需对象 | 模板使用 article 对象；官方页摘要要求评论区使用 form 标签 'new_comment', article，含 comment[author]、comment[email]、comment[body] 三个字段 |
| 评论分页 | 官方页写明文章评论每页上限 50 条，需要用 paginate 分页，并建议每页 20 条 |
| JSON 模板 | JSON 模板中的 HTML 与 Liquid 必须放在被模板引用的 Section 内 |
| alternate 命名 | template-name.template-suffix.template-file-type，例如 article.guide.json（示例后缀为本站假设） |
| alternate 分配 | 帮助中心写明，在 Content > Blog posts 选择文章，于 Online store 区的 Theme template 下拉选择；下拉只列出当前 live 主题中的模板 |
| 读取分配结果 | Liquid article.template_suffix 返回分配给文章的自定义模板名（不含前缀与扩展名），未分配时为 nil |
| 不可替换默认模板 | Alternate templates 页写明不能用 alternate 替换默认模板 |
| 文章对象字段 | author、content、excerpt、excerpt_or_content、image、published_at、updated_at、tags、comments、comments_enabled?、metafields、url 等；未见作者资格、复核日期与引用来源字段，需放在正文或元字段中 |
未核验：Alternate templates 页面的分配说明只覆盖商品，未提及文章；文章批量分配 alternate 的边界、?view= 预览对文章的适用性、评论审核与垃圾评论的处理界面，均未核验。