diff --git "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index 280caadc408..9d2253fd337 100644 --- "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](/docs/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" index 5515837cdec..ab0695cf58e 100644 --- "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" +++ "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" @@ -14,7 +14,7 @@ hide_title: true `config.yaml` -``` +```yaml server: address: ":8888" openapiPath: "/api.json" @@ -59,7 +59,7 @@ map[debug:true link:mysql:root:12345678@tcp(127.0.0.1:3306)/test] `config.yaml` -``` +```yaml server: address: ":8888" openapiPath: "/api.json" diff --git "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/docs/4-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" index e67eea058af..ec052787737 100644 --- "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" +++ "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" @@ -8,7 +8,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index f13266cfb8a..94b72b0fed2 100644 --- "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/2-\346\216\245\345\217\243\346\226\207\346\241\243/1-\346\216\245\345\217\243\346\226\207\346\241\243-\350\207\252\345\256\232\344\271\211UI.md" "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/2-\346\216\245\345\217\243\346\226\207\346\241\243/1-\346\216\245\345\217\243\346\226\207\346\241\243-\350\207\252\345\256\232\344\271\211UI.md" index fd4d0aec2e1..06cd02bade3 100644 --- "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/2-\346\216\245\345\217\243\346\226\207\346\241\243/1-\346\216\245\345\217\243\346\226\207\346\241\243-\350\207\252\345\256\232\344\271\211UI.md" +++ "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/2-\346\216\245\345\217\243\346\226\207\346\241\243/1-\346\216\245\345\217\243\346\226\207\346\241\243-\350\207\252\345\256\232\344\271\211UI.md" @@ -95,7 +95,7 @@ func main() { config.yaml -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index f11995f03b9..152ace6aee9 100644 --- "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -26,7 +26,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -55,7 +55,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -72,7 +72,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -98,7 +98,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -110,7 +110,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index dab5d3f9083..66d72d29d70 100644 --- "a/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/docs/7-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80"，多个地址以","号分隔。例如："192.168.2.3:8000,10.0.3.10:8001" diff --git "a/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index 37b049d131c..a2447940de3 100644 --- "a/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.0-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.0.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" index 26dfc69a83c..22496d5384c 100644 --- "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" +++ "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" @@ -23,7 +23,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index 1fd8a36c8ff..4f86c7f600b 100644 --- "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index 85fef57efe3..74c2426a9fe 100644 --- "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -24,7 +24,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -53,7 +53,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -70,7 +70,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -96,7 +96,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -108,7 +108,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index c9f399be85d..9a6403ef0d2 100644 --- "a/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.0.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80" diff --git "a/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index 4bfe58c4ab5..49efd55865a 100644 --- "a/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.1-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.1.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" index afb48c51a69..854a696cca3 100644 --- "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" +++ "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" @@ -23,7 +23,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index a16c808c417..2f22706603e 100644 --- "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index a336322650d..6bd0481cfa6 100644 --- "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -24,7 +24,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -53,7 +53,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -70,7 +70,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -96,7 +96,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -108,7 +108,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index c9f399be85d..9a6403ef0d2 100644 --- "a/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.1.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80" diff --git "a/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index a2d9c3c13a4..e8c0a320767 100644 --- "a/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.2-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.2.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" index 3e6ecf0145b..b9be65b6af3 100644 --- "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" +++ "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" @@ -23,7 +23,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index 68afc1c8f0b..c6c831086a1 100644 --- "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index 481f185d369..45159122d91 100644 --- "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -24,7 +24,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -53,7 +53,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -70,7 +70,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -96,7 +96,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -108,7 +108,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index c9f399be85d..9a6403ef0d2 100644 --- "a/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.2.x/3-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80" diff --git "a/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index 943ab3074be..9d49c2789c4 100644 --- "a/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.3-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.3.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" index bb9038ca261..07906a6def0 100644 --- "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" +++ "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" @@ -25,7 +25,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index 65df1e25de1..4c02973af60 100644 --- "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index 5674467c364..b7ed8e9e6a0 100644 --- "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -24,7 +24,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -53,7 +53,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -70,7 +70,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -96,7 +96,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -108,7 +108,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index 2a3802db194..d2d54580a0a 100644 --- "a/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.3.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80"，多个地址以","号分隔。例如："192.168.2.3:8000,10.0.3.10:8001" diff --git "a/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index d7ac782f33d..e35a9f947ee 100644 --- "a/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.4-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.4.x/1-\346\240\270\345\277\203\347\273\204\344\273\266-\351\207\215\347\202\271/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" index 904c0ede99d..f8f4d9249b7 100644 --- "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" +++ "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261.md" @@ -25,7 +25,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index afa77ab668a..c2843bd49d6 100644 --- "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index 40361ce1285..49129fef8cc 100644 --- "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -24,7 +24,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -53,7 +53,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -70,7 +70,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -96,7 +96,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -108,7 +108,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index 2a3802db194..d2d54580a0a 100644 --- "a/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.4.x/4-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80"，多个地址以","号分隔。例如："192.168.2.3:8000,10.0.3.10:8001" diff --git "a/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index e5b72e570e4..4fdbee4b089 100644 --- "a/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.5-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.5.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" index 78442e77795..c84a05950e9 100644 --- "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" +++ "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" @@ -8,7 +8,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index 821e0dbb524..0e6456b6a8a 100644 --- "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index a1a019d15ac..16135d2158d 100644 --- "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -26,7 +26,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -55,7 +55,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -72,7 +72,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -98,7 +98,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -110,7 +110,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index 2a3802db194..d2d54580a0a 100644 --- "a/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.5.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80"，多个地址以","号分隔。例如："192.168.2.3:8000,10.0.3.10:8001" diff --git "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" index c11ab009f30..eae8e44f262 100644 --- "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" +++ "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/0-\351\205\215\347\275\256\347\256\241\347\220\206-\351\205\215\347\275\256\345\257\271\350\261\241.md" @@ -12,7 +12,7 @@ hide_title: true 示例配置： -``` +```yaml viewpath: "/home/www/templates/" database: default: diff --git "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" index 263e7b67ab9..8f5638edede 100644 --- "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" +++ "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/1-\351\205\215\347\275\256\347\256\241\347\220\206-\346\226\207\344\273\266\351\205\215\347\275\256.md" @@ -176,7 +176,7 @@ func (c *AdapterFile) ClearContent() 在默认提供的文件系统接口实现下， `gcfg` 组件支持按层级获取配置数据，层级访问默认通过英文 `.` 号指定，其中 `pattern` 参数和 [通用编解码-gjson](output/goframe-v2.6-md/组件列表/编码解码/通用编解码-gjson) 的 `pattern` 参数一致。例如以下配置（ `config.yaml`）： -``` +```yaml server: address: ":8199" serverRoot: "resource/public" diff --git "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" index 5515837cdec..ab0695cf58e 100644 --- "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" +++ "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/3-\351\205\215\347\275\256\347\256\241\347\220\206-\346\216\245\345\217\243\345\214\226\350\256\276\350\256\241/0-\351\205\215\347\275\256\347\256\241\347\220\206-AdapterFile.md" @@ -14,7 +14,7 @@ hide_title: true `config.yaml` -``` +```yaml server: address: ":8888" openapiPath: "/api.json" @@ -59,7 +59,7 @@ map[debug:true link:mysql:root:12345678@tcp(127.0.0.1:3306)/test] `config.yaml` -``` +```yaml server: address: ":8888" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" index 0c23759638b..de311efd3a4 100644 --- "a/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" +++ "b/versioned_docs/version-2.6.x/2-\346\240\270\345\277\203\347\273\204\344\273\266/3-\351\205\215\347\275\256\347\256\241\347\220\206/5-\351\205\215\347\275\256\347\256\241\347\220\206-TOML\346\240\274\345\274\217.md" @@ -24,7 +24,7 @@ hide_title: true ## 基础语法 -``` +```toml title = "TOML 例子" [owner] @@ -73,7 +73,7 @@ hosts = [ 使用 `#` 表示注释： -``` +```toml # I am a comment. Hear me roar. Roar. key = "value" # Yeah, you can do this. ``` @@ -90,7 +90,7 @@ key = "value" # Yeah, you can do this. 由三个双引号包裹，除了分隔符开始的换行外，字符串内的换行将被保留： -``` +```toml str1 = """ Roses are red Violets are blue""" @@ -100,7 +100,7 @@ Violets are blue""" 由单引号包裹，其内不允许转义，因此可以方便的表示基本字符串中需要转义的内容： -``` +```toml winpath = 'C:\Users\nodejs\templates' ``` @@ -108,7 +108,7 @@ winpath = 'C:\Users\nodejs\templates' 与多行-基本字符串相似： -``` +```toml str1 = ''' Roses are red Violets are blue''' @@ -116,7 +116,7 @@ Violets are blue''' ## 数值与BOOL值 -``` +```toml int1 = +99 flt3 = -0.01 bool1 = true @@ -124,7 +124,7 @@ bool1 = true ## 日期时间 -``` +```toml date = 1979-05-27T07:32:00Z ``` @@ -134,7 +134,7 @@ date = 1979-05-27T07:32:00Z 注意，同一个数组下不允许混用数据类型。 -``` +```toml array1 = [ 1, 2, 3 ] array2 = [ "red", "yellow", "green" ] array3 = [ [ 1, 2 ], [3, 4, 5] ] @@ -146,13 +146,13 @@ array5 = [ 1, 2.0 ] # 注意：这是不行的。 表格（也叫哈希表或字典）是键值对的集合。它们在方括号内，自成一行。注意和数组相区分，数组只有值。 -``` +```toml [table] ``` 在此之下，直到下一个　`table` 或　`EOF` 之前，是这个表格的键值对。键在左，值在右，等号在中间。键以非空字符开始，以等号前的非空字符为结尾。键值对是无序的。 -``` +```toml [table] key = "value" ``` @@ -161,7 +161,7 @@ key = "value" 嵌套表格的表格名称中使用 `.` 符号。你可以任意命名你的表格，只是不要用点，点是保留的。 -``` +```toml [dog.tater] type = "pug" ``` @@ -174,7 +174,7 @@ type = "pug" 如果你不想的话，你不用声明所有的父表。TOML　知道该如何处理。 -``` +```toml # [x] 你 # [x.y] 不需要 # [x.y.z] 这些 @@ -185,7 +185,7 @@ type = "pug" 只要父表没有被直接定义，而且没有定义一个特定的键，你可以继续写入： -``` +```toml [a.b] c = 1 @@ -195,7 +195,7 @@ d = 2 然而你不能多次定义键和表格。这么做是不合法的。 -``` +```toml # 别这么干！ [a] @@ -216,7 +216,7 @@ c = 2 最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对，会被当成空表。 -``` +```toml [[products]] name = "Hammer" sku = 738594937 @@ -243,7 +243,7 @@ color = "gray" 表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格从属于最近定义的上层表格元素。 -``` +```toml [[fruit]] name = "apple" @@ -292,7 +292,7 @@ color = "gray" 尝试定义一个普通的表格，使用已经定义的数组的名称，将抛出一个解析错误： -``` +```toml # 不合法的　TOML [[fruit]] diff --git "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" index 9beb729bef7..b3887d02046 100644 --- "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" +++ "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/1-\350\267\257\347\224\261\347\256\241\347\220\206/1-\350\267\257\347\224\261\347\256\241\347\220\206-\350\267\257\347\224\261\346\263\250\345\206\214/3-\350\267\257\347\224\261\346\263\250\345\206\214-\350\247\204\350\214\203\350\267\257\347\224\261/0-\350\247\204\350\214\203\350\267\257\347\224\261-\345\237\272\346\234\254\347\244\272\344\276\213.md" @@ -8,7 +8,7 @@ hide_title: true 这里使用 `YAML` 配置文件： `config.yaml` -``` +```yaml server: address: ":8199" openapiPath: "/api.json" diff --git "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" index 1de5eef460e..982367d7936 100644 --- "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" +++ "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/11-\351\253\230\347\272\247\347\211\271\346\200\247/1-\346\234\215\345\212\241\346\227\245\345\277\227\347\256\241\347\220\206.md" @@ -42,7 +42,7 @@ AccessLogPattern string // Error log file pattern like: access-{Ymd} 官方推荐使用配置文件的方式来管理服务配置以及日志日志配置。 一个参考的日志配置内容示例（以 `yaml` 格式为例）： -``` +```yaml server: LogPath: "/var/log/gf-demos/server" LogStdout: false diff --git "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" index a11858d9bf8..b238f6face5 100644 --- "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" +++ "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/0-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266.md" @@ -12,7 +12,7 @@ hide_title: true ## 示例1，默认配置项 -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -26,7 +26,7 @@ server: 多个 `Server` 的配置示例： -``` +```yaml server: address: ":80" serverRoot: "/var/www/Server" @@ -55,7 +55,7 @@ s4 := g.Server() 比如上一个章节的示例，对应的配置文件如下： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -72,7 +72,7 @@ server: 同理，配置属性项的名称也不区分大小写，单词间也支持使用 `-`/ `_` 符号连接。也就是说以下配置文件效果和上面的配置文件一致： -``` +```yaml server: address: ":8199" serverRoot: "/var/www/Server" @@ -98,7 +98,7 @@ server: 由于安全性的考虑，默认的上传限制都不是很高，特别是 `ClientMaxBodySize` 的大小限制，在需要文件上传的场景可适当考虑调整，通过配置文件配置即可，例如： -``` +```yaml server: maxHeaderBytes: "20KB" clientMaxBodySize: "200MB" @@ -110,7 +110,7 @@ server: 从 `v2` 版本开始， `Server` 增加了对配置文件中 `Logger` 的配置项支持，主要是为了统一日志组件配置、并解决日志滚动切分的问题。配置示例： -``` +```yaml server: address: ":8080" logger: diff --git "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" index 2a3802db194..d2d54580a0a 100644 --- "a/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" +++ "b/versioned_docs/version-2.6.x/5-WEB\346\234\215\345\212\241\345\274\200\345\217\221/5-\346\234\215\345\212\241\351\205\215\347\275\256/1-\346\234\215\345\212\241\351\205\215\347\275\256-\351\205\215\347\275\256\346\226\207\344\273\266\346\250\241\346\235\277.md" @@ -8,7 +8,7 @@ hide_title: true 以下为配置文件模板： -``` +```yaml server: # 基本配置 address: ":80" # 本地监听地址。默认":80"，多个地址以","号分隔。例如："192.168.2.3:8000,10.0.3.10:8001"