跳到主要内容

最新动态

“最新动态”组件提供了一种动态方式,用于在您的网站上展示最新新闻、博客文章或公告。它与博客系统 Discuss Kit 集成,自动获取和显示内容,使您的网站保持新鲜感并展示持续的活动。

该组件特别适用于:

  • 展示新功能、更新或技术文章。
  • 提供“证明与势头”——可见的、持续的进展。
  • 加强品牌透明度和参与度。

如何使用

要实现“最新动态”部分,您必须准备一个数据源文件,然后在您网站的生成规则中引用它。这个过程很简单,能确保 AI 正确地定位和渲染内容。

第 1 步:准备数据文件

首先,创建一个 YAML 文件作为数据描述符,告诉 WebSmith 从哪里获取博客内容。

推荐将此文件放置在 src/blog-list-data.yaml

示例数据文件

src/blog-list-data.yaml

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

yaml
sourcesPath:
  - src/blog-list-data.yaml

如果您正在更新现有网站,还必须将文件路径添加到 .aigne/web-smith/pages/workspace/website-structure.yamlsourceIds 部分下。这确保了 WebSmith 在执行 update 操作时能够定位到新的数据源。

.aigne/web-smith/pages/workspace/website-structure.yaml

yaml
sourceIds:
  - src/blog-list-data.yaml

第 3 步:在生成规则中定义该部分

接下来,通过在您的 WebSmith config.yaml 文件中添加一条规则,来指示 AI 如何使用该数据源。该规则应指定该部分的位置、组件类型和数据源。

示例规则

config.yaml

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 检索最新的帖子,并在您的网站上渲染“最新动态”部分。

总结

“最新动态”组件是一个强大的工具,可以使您的网站内容保持最新和引人入胜。通过遵循创建数据文件和定义生成规则的简单步骤,您可以自动化在您的网站上直接显示新闻和博客文章的过程。

有关其他特殊组件的更多信息,请参阅使用特殊组件的文档。