A Hugo theme component with reward-log or sponsor-log shortcode.

hugo-fixit 收录于 README 和主题组件

2024-07-21 2026-07-14 约 400 字预计阅读 2 分钟 - 次阅读

shortcode-rewards

A Hugo theme component with reward-log or sponsor-log shortcode.

Demo

Requirements

Developed based on the FixIt Timeline plugin.

v2 requires FixIt v1.0.x
v1 requires FixIt v0.4.x

Install Component

The installation method is the same as installing a theme. There are several ways to install, choose one, for example, install through Hugo Modules:

1
2
3
4
5
[module]
  [[module.imports]]
    path = "github.com/hugo-fixit/FixIt"
+ [[module.imports]]
+   path = "github.com/hugo-fixit/shortcode-rewards/v2"

Configuration

In order to Inject the partial shortcode-rewards.html into the custom-head through the custom block opened by the FixIt theme in the layouts/partials/custom.html file, you need to fill in the following necessary configurations:

1
2
3
4
5
[params]
  [params.custom_partials]
    # ... other partials
    head = [ "inject/shortcode-rewards.html" ]
    # ... other partials

Usage

First, create the reward-log.yml file and edit your data:

`1`	`cp themes/shortcode-rewards/reward_log.yml.example data/reward_log.yml`

If your site is multilingual, you can create a reward_log.en.yml file for English and reward_log.zh-cn.yml for Chinese.

Next, use the reward-log shortcode in any page:

`1`	`{{< reward-log >}}`

注意

For compatibility with older versions, sponsor-log shortcode can also be used, and the corresponding data file is sponsor_log.yml.

Params

Shortcode

The reward-log shortcode has the following named parameters, and the positional parameters ordered from top to bottom:

Parameter	Description	Type	Optional values	Default
reverse	whether the node is ascending or descending	boolean	-	true
placement	position of timestamp	string	top / bottom	bottom
animation	whether to enable animation	boolean	-	false
size	node size	string	small / medium / large	medium
node	node style	string	circle / dot	circle
width	`#` container width	string	-	-
height	`#` container height	string	-	-
class	`#` container classname	string	-	-

Parameters marked with # only support named parameters.

Data

The reward_log.yml file has the following fields:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# The sponsor logs data format is as follows
# currency: [CNY, USD, EUR, ...] https://gohugo.io/functions/lang/formatcurrency/
# origin: [alipay, bitcoin, paypal, wechatpay, ...]

message: Thanks all!
currency: CNY
symbol: ¥
# The sponsor logs inherit the FixIt Timeline events
logs:
  - date: "2006-01-02 15:04:05"
    sponsor: Cell
    money: 50
    origin: alipay
    remark: "Come on!"