MrDoc 支持通过**站点公告**功能向网站访问者发布通知、更新说明、活动信息等内容。管理员可以设置公告的展示方式、启用状态、有效时间以及用户是否可以关闭公告。

## 一、功能入口

登录 MrDoc 管理后台，进入：

**站点管理 → 站点公告**

进入站点公告页面后，可以查看已经创建的公告，并进行新增、编辑、删除和启用/禁用等操作。

## 二、新增公告

点击页面上的**「新增公告」**按钮，即可创建新的站点公告。

### 1. 标题

填写公告的标题。

例如：`MrDoc 新版本发布`

标题用于标识公告内容，并会在公告展示区域中显示。

### 2. 内容

填写公告的具体内容。

例如：`MrDoc 专业版 v1.5.5 已发布，本次更新新增了 XXX 功能，并修复了 XXX 问题。`

公告内容用于向用户展示详细的通知信息。

### 3. 展示方式

用于设置公告在网站中的展示形式，目前支持以下三种方式：

* **顶部横幅**：公告以横幅形式显示在网站页面顶部。
* **弹出框**：用户访问网站时以弹出框形式显示公告内容。
* **两者**：同时使用顶部横幅和弹出框展示公告。

可以根据公告的重要程度选择合适的展示方式。

例如：

* 一般性的版本更新通知，可以选择**顶部横幅**。
* 需要用户重点关注的重要通知，可以选择**弹出框**。
* 对于非常重要的系统维护或服务变更通知，可以选择**两者**。

### 4. 跳转链接

用于设置公告的跳转地址。

填写后，用户可以通过公告进入指定页面，例如：

* 版本更新说明
* 产品活动页面
* 使用文档
* 外部网站

该选项为可选项。如果不填写，则公告仅用于信息展示。

### 5. 是否启用

用于控制公告是否生效。

* **启用**：公告按照设置的展示方式向用户展示。
* **禁用**：公告不会向用户展示。

### 6. 是否可关闭

用于控制用户是否可以主动关闭公告。

* **是**：用户可以关闭公告。
* **否**：用户无法主动关闭公告。

如果公告采用**弹出框**或**两者**的展示方式，建议根据公告的重要程度合理设置是否允许关闭。

### 7. 开始时间

用于设置公告开始展示的时间。

该项为可选项：

* **不设置**：公告启用后即可展示。
* **设置时间**：公告到达指定时间后开始展示。

可以提前创建公告，并通过开始时间控制其正式发布时间。

### 8. 结束时间

用于设置公告停止展示的时间。

该项为可选项：

* **不设置**：公告持续展示，直到管理员手动禁用。
* **设置时间**：到达指定时间后自动停止展示。

通过同时设置开始时间和结束时间，可以实现公告的定时发布和自动下线。

## 三、公告展示方式说明

三种展示方式的主要区别如下：

| 展示方式 | 顶部横幅 | 弹出框 |
| ---- | ---- | --- |
| 顶部横幅 | ✓    | —   |
| 弹出框  | —    | ✓   |
| 两者   | ✓    | ✓   |

**顶部横幅**适合不会明显打断用户操作的常规通知；**弹出框**适合需要用户重点关注的重要通知；如果希望同时兼顾醒目程度和持续提示效果，可以选择**两者**。

## 四、公告状态管理

创建公告后，可以在站点公告列表中查看和管理公告。

常见操作包括：

* **编辑**：修改公告标题、内容、展示方式及其他配置。
* **删除**：删除不再需要的公告。
* **启用/禁用**：控制公告是否生效。

对于暂时不需要展示、但以后可能继续使用的公告，可以选择**禁用**，无需直接删除。

## 五、公告展示时间

公告最终是否展示，会同时受到**启用状态**和**开始/结束时间**的影响。

| 配置              | 展示效果           |
| --------------- | -------------- |
| 已启用，未设置时间       | 启用后立即展示        |
| 已启用，仅设置开始时间     | 到开始时间后展示       |
| 已启用，仅设置结束时间     | 启用后展示，到结束时间后停止 |
| 已启用，同时设置开始和结束时间 | 仅在指定时间范围内展示    |
| 已禁用             | 不展示            |

## 六、使用建议

站点公告适合发布需要用户及时了解的信息，例如：

* MrDoc 版本更新通知
* 网站维护通知
* 服务异常或恢复通知
* 新功能上线通知
* 活动及运营信息
* 重要使用说明

对于长期有效的产品介绍、功能说明和使用教程，建议使用普通文档或帮助页面，而不是站点公告。

### 推荐配置

**普通版本更新通知**

> 展示方式：顶部横幅
> 是否启用：是
> 是否可关闭：是
> 开始时间：不设置
> 结束时间：根据需要设置

**重要系统通知**

> 展示方式：弹出框
> 是否启用：是
> 是否可关闭：根据通知重要程度设置
> 开始时间：根据需要设置
> 结束时间：根据需要设置

**重要维护或服务变更通知**

> 展示方式：两者
> 是否启用：是
> 是否可关闭：根据通知重要程度设置
> 开始时间：可提前设置
> 结束时间：设置为通知结束时间

## 七、注意事项

1. 公告启用后会按照配置向站点用户展示，请确认标题和内容无误后再启用。
2. 设置了开始时间的公告，在开始时间到达前不会展示。
3. 设置了结束时间的公告，在结束时间到达后会自动停止展示。
4. 弹出框适合重要程度较高的公告，不建议长期使用弹出框展示普通通知，以免影响用户正常使用。
5. 公告内容建议简洁明了，较长的说明可以通过**跳转链接**引导用户查看完整文档。

站点公告配置