公告欄
贊助
成為我們的資助者或贊助商，以支持我們的工作。
本頁內容
贊助商
公告欄模塊突出一些重要的事情，比如新聞和項目的新版本。
| Module | github.com/hbstack/announcement-bar |
|---|---|
| Repository | ⭐ Please consider giving a star if your like it. |
| Stars |  |
| Version |  |
| Used by |  |
| Requirements |  |
| License |  |
| Usage | See how to use modules. |
站點參數
| Parameter | Type | Default | Description |
|---|---|---|---|
bg | string | primary | 背景顏色。 |
color | string | #fff | 文本顏色。 |
interval | number | 5000 | 公告的間隔，單位：毫秒。 |
expand_stall_threshold | number | 1000 | 鼠標懸停於公告欄時展開所有公告所需要經過的毫秒數。 |
hugo.toml
1[params]
2 [params.hb]
3 [params.hb.announcement_bar]
4 expand_stall_threshold = 1000
5 interval = 5000
hugo.yaml
1params:
2 hb:
3 announcement_bar:
4 expand_stall_threshold: 1000
5 interval: 5000
hugo.json
1{
2 "params": {
3 "hb": {
4 "announcement_bar": {
5 "expand_stall_threshold": 1000,
6 "interval": 5000
7 }
8 }
9 }
10}
公告數據文件
該模塊被設計爲兼容單語言和多語言站點，你需要於 data/announcements 目錄下爲每個語言站點創建公告數據文件。
1$ tree data/announcements
2├── en.toml
3├── zh-hans.toml
4└── zh-hant.toml
如 tree 的結果所示，我們爲 en、zh-hans 和 zh-hant 站點定義了公告數據文件。
公告屬性
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
title | string | - | Y | 公告標題，支持 Markdown 語法。 |
url | string | - | N | 公告 URL。 |
weight | number | - | N | 值越小優先級越高。 |
當設置了
url，請確保 title 不包含無效內容，比如鏈接。公告例子
data/announcements/en.toml
1[external]
2 title = 'The announcement linked to external site.'
3 url = 'https://hugomods.com/'
4 weight = 3
5[internal]
6 title = 'Internal announcement.'
7 url = 'modules/enhancement/announcement-bar'
8 weight = 2
9[plain]
10 title = 'A **plain** text announcement.'
11 weight = 1
data/announcements/en.yaml
1external:
2 title: The announcement linked to external site.
3 url: https://hugomods.com/
4 weight: 3
5internal:
6 title: Internal announcement.
7 url: modules/enhancement/announcement-bar
8 weight: 2
9plain:
10 title: A **plain** text announcement.
11 weight: 1
data/announcements/en.json
1{
2 "external": {
3 "title": "The announcement linked to external site.",
4 "url": "https://hugomods.com/",
5 "weight": 3
6 },
7 "internal": {
8 "title": "Internal announcement.",
9 "url": "modules/enhancement/announcement-bar",
10 "weight": 2
11 },
12 "plain": {
13 "title": "A **plain** text announcement.",
14 "weight": 1
15 }
16}
