Bootstrap 配置切换短代码

从单个配置代码生成多个语言代码块,支持 TOML、JSON 和 YAML。

语法

1{{< bs/config-toggle >}}
2PUT YAML/TOML/JSON CODE HERE.
3{{< /bs/config-toggle >}}

参数

filename

索引名称类型必填默认值版本示例
#0filenamestring----

文件名。

langs

索引名称类型必填默认值版本示例
#1langsstring-toml,yaml,json--

逗号分隔的目标语言,可用于排除语言或重新排序。

style

索引名称类型必填默认值版本示例
-stylestring-tabs--

样式:tabspillsunderline.

fill

索引名称类型必填默认值版本示例
-fillboolean-false--

true 时,占用全宽。

title

索引名称类型必填默认值版本示例
-titlestring----

配置标题。

delimiter

索引名称类型必填默认值版本示例
-delimiterboolean----

true 时,用分隔符包裹代码。

站点参数

langs

名称上下文类型必填默认值版本示例
langs-array-[&#34;toml&#34;, &#34;yaml&#34;, &#34;json&#34;]--

目标语言,可用于排除语言和重新排序。

hugo.yaml

1params:
2  bootstrap:
3    config_toggle:
4      langs:
5      - yaml
6      - toml
7      - json

hugo.toml

1[params]
2  [params.bootstrap]
3    [params.bootstrap.config_toggle]
4      langs = ['yaml', 'toml', 'json']

hugo.json

 1{
 2   "params": {
 3      "bootstrap": {
 4         "config_toggle": {
 5            "langs": [
 6               "yaml",
 7               "toml",
 8               "json"
 9            ]
10         }
11      }
12   }
13}

示例

文件示例

源码
1{{< bs/config-toggle hello >}}
2{
3  "hello": "world"
4}
5{{< /bs/config-toggle >}}
结果

hello.yaml

1hello: world

hello.toml

1hello = 'world'

hello.json

1{
2   "hello": "world"
3}

排除语言并重新排序

源码
1{{< bs/config-toggle langs=json,toml >}}
2langs = ["toml", "json"]
3{{< /bs/config-toggle >}}
结果
1{
2   "langs": [
3      "toml",
4      "json"
5   ]
6}
1langs = ['toml', 'json']

Hugo 配置示例

源码
1{{< bs/config-toggle filename=hugo title="Configuration" style=pills fill=true >}}
2module:
3  imports:
4    - path: github.com/hugomods/bootstrap
5{{< /bs/config-toggle >}}
结果

hugo.yaml

1module:
2  imports:
3  - path: github.com/hugomods/bootstrap

hugo.toml

1[module]
2  [[module.imports]]
3    path = 'github.com/hugomods/bootstrap'

hugo.json

1{
2   "module": {
3      "imports": [
4         {
5            "path": "github.com/hugomods/bootstrap"
6         }
7      ]
8   }
9}

Hugo 前言示例

源码
1{{< bootstrap/config-toggle title="Front Matter" delimiter=true >}}
2title: Hello World!
3{{< /bootstrap/config-toggle >}}
结果
1---
2title: Hello World!
3---
1+++
2title = 'Hello World!'
3+++
1{
2   "title": "Hello World!"
3}