“最新动态”组件提供了一种动态方式,用于在您的网站上展示最新新闻、博客文章或公告。它与博客系统 Discuss Kit 集成,自动获取和显示内容,使您的网站保持新鲜感并展示持续的活动。
该组件特别适用于:
- 展示新功能、更新或技术文章。
- 提供“证明与势头”——可见的、持续的进展。
- 加强品牌透明度和参与度。
如何使用
要实现“最新动态”部分,您必须准备一个数据源文件,然后在您网站的生成规则中引用它。这个过程很简单,能确保 AI 正确地定位和渲染内容。
第 1 步:准备数据文件
首先,创建一个 YAML 文件作为数据描述符,告诉 WebSmith 从哪里获取博客内容。
推荐将此文件放置在 src/blog-list-data.yaml。
示例数据文件
src/blog-list-data.yaml
blogTitle: "Latest Updates"
blogDescription: "Get the latest updates right here."
blogUrl: "https://www.arcblock.io" # 或者您的 Discuss Kit Blocklet URL
blogLabel: "did-domain"
blogMoreButtonText: "See More"字段说明
| 字段 | 描述 | 必需 |
|---|---|---|
blogTitle | 该部分显示的主标题。为清晰起见,建议保持在 60 个字符以内。 | 是 |
blogDescription | 显示在标题下方的简要摘要,解释该部分的内容。 | 是 |
blogUrl | 源 URL,通常是您的 Discuss Kit Blocklet。WebSmith 会自动提取标题、摘要、封面图片和日期。Discuss Kit API 必须可公开访问。 | 是 |
blogLabel | 一个可选的筛选标签,用于显示特定分类的内容。该值应从您的 Discuss Kit 网站获取(例如,URL 中的 labels 查询参数)。 | 否 |
blogMoreButtonText | 可选的“查看更多”按钮的文本,可以链接到您的主博客或新闻页面。 | 否 |
第 2 步:注册数据源
创建数据文件后,您必须注册它,以便 WebSmith 能够找到并使用它。
将文件路径添加到您的 config.yaml 文件中的 sourcesPath 字段:
config.yaml
sourcesPath:
- src/blog-list-data.yaml如果您正在更新现有网站,还必须将文件路径添加到 .aigne/web-smith/pages/workspace/website-structure.yaml 的 sourceIds 部分下。这确保了 WebSmith 在执行 update 操作时能够定位到新的数据源。
.aigne/web-smith/pages/workspace/website-structure.yaml
sourceIds:
- src/blog-list-data.yaml第 3 步:在生成规则中定义该部分
接下来,通过在您的 WebSmith config.yaml 文件中添加一条规则,来指示 AI 如何使用该数据源。该规则应指定该部分的位置、组件类型和数据源。
示例规则
config.yaml
rule: Section 2 must render the `Latest Updates` section using `src/blog-list-data.yaml` as immediate proof and momentum.此示例规则完成了以下操作:
- 定位:将“最新动态”组件放置为页面上的第二个部分。
- 组件类型:将该部分标识为“最新动态”或“博客列表”类型。
- 数据源:指向
src/blog-list-data.yaml作为配置来源。
或者,在使用 update 命令时,您可以提供直接的提示,而不是编辑 config.yaml 文件:
Change section 2 to “Latest Updates” and generate its content using src/blog-list-data.yaml.第 4 步:生成或更新您的网站
在数据文件和生成规则就位后,运行相应的命令,让 AIGNE WebSmith 构建或刷新您的网站。如果是首次生成,请使用 aigne web generate。要向现有网站添加一个部分,请使用 aigne web update 并选择要添加该部分的文档。
现在,WebSmith 将自动加载您的 YAML 数据,从指定的 Discuss Kit URL 检索最新的帖子,并在您的网站上渲染“最新动态”部分。
总结
“最新动态”组件是一个强大的工具,可以使您的网站内容保持最新和引人入胜。通过遵循创建数据文件和定义生成规则的简单步骤,您可以自动化在您的网站上直接显示新闻和博客文章的过程。
有关其他特殊组件的更多信息,请参阅使用特殊组件的文档。