diff --git a/content/zh/about/contribute/creating-and-editing-pages/index.md b/content/zh/about/contribute/creating-and-editing-pages/index.md index f2708bce09..0fbb01f1e9 100644 --- a/content/zh/about/contribute/creating-and-editing-pages/index.md +++ b/content/zh/about/contribute/creating-and-editing-pages/index.md @@ -612,6 +612,64 @@ which looks like: - **没有嵌套的标签集**。不要尝试，这太可怕了。 +## 导航和表情{#banners-and-stickers} + +您可以自动插入时间敏感的 banners 和 stickers 到生成的网站，来通知即将发生的事件，或宣传一些新内容。 + +支持两种类型的推广： + +- **Countdown stickers** 显示距离重大事件发生还有多长时间 （如：“离 Istio 1.5发布还有2天”），stickers 视觉效果对用户影响最小。 + +- **Banners** 视觉效果最为突出，用于向用户传达即将（已经或正在）发生的重大事件 （例如，“Istio 1.5 已发布，请立即下载！” 或 “ 3 月 30 日加入我们的 KubeCon”），其呈现效果为全屏显示 。 + +要创建 banners 和 stickers ，您可以将文件添加到 `events/banners` 或者 `events/stickers` 目录中。 您需要为每个事件创建一个 markdown 文件。在这些文件中，使用以下特殊的字段来控制各种功能： + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
字段描述
title事件的名称。 它未显示在网站上，仅用于诊断消息。
period_start 以 YYYY-MM-DD 格式定义开始显示 item 的日期。 + 除了日期，它也可以是值 latest_release, 使用已知的最新 Istio 版本作为开始日期。当创建的 banner 为 "Istio x.y.z 刚刚发布" 时，此功能很有用。 +
period_end以 YYYY-MM-DD 格式定义显示 item 的最后日期。该值与 period_duration 互斥。 +
period_duration向用户显示项目的天数。 该值与上面的 + period_end 互斥。 +
max_impressions在活动期间向用户显示内容的次数。 值为 3 表示在此期间用户访问的前三个页面将显示内容，并且在后续页面加载时将隐藏该内容。 值为 0 或完全省略该字段会导致该内容在此期间的所有页面访问中显示。 +
timeout内容在给定页面上对用户可见的时间。 经过这么长时间后，该项目将从页面中删除。
link您可以指定一个URL，它将整个项目变成可点击的目标。 用户单击该项目后，该项目将不再显示给用户。 这里可以使用特殊值 `latest_release` 来引入指向当前版本的公告页面的链接。 +
+ ## 重命名、移动或删除页面{#renaming-moving-or-deleting-pages} 如果移动页面或将其完全删除，则应确保用户可能必须与这些页面的现有链接继续起作用。您可以通过添加别名来做到这一点，这将使用户自动从旧 URL 重定向到新 URL。 @@ -700,3 +758,7 @@ $ make lint {{< text bash >}} $ make INTERNAL_ONLY=True lint {{< /text >}} + +## 使用 GitHub{#using-GitHub} + +点击 [使用 GitHub 参与社区活动](/zh/about/contribute/github) 了解如何使用 GitHub 处理 Istio 文档。如果你非常感兴趣, 查看 [分支部分](/zh/about/contribute/github#branching) 来了解我们是怎么使用分支和处理冲突的。