From a45537c22de883249f4baea006232885b11cfc58 Mon Sep 17 00:00:00 2001 From: jaywcjlove Date: Tue, 25 Oct 2022 09:04:27 +0000 Subject: [PATCH] feat: add `ini.md` cheatsheet. 09f57d18482a17edf14e40eac99dd5598353d981 --- docs/ini.html | 219 +++++++++++++++++++++++++++++++++++++++++++++++++ docs/toml.html | 18 +++- docs/yaml.html | 2 + index.html | 3 + 4 files changed, 239 insertions(+), 3 deletions(-) create mode 100644 docs/ini.html diff --git a/docs/ini.html b/docs/ini.html new file mode 100644 index 00000000..f0aa2c65 --- /dev/null +++ b/docs/ini.html @@ -0,0 +1,219 @@ + + + + +INI 备忘清单 + & ini cheatsheet & Quick Reference + + + + + + +

+ +INI 备忘清单

+

这是理解和编写 INI 格式配置文件的快速参考备忘单，此清单包含配置的内容，结构和语法等内容。

+

入门

+

介绍

+

INI 是一种固定标准格式的配置文件，INI配置方法来自 MS-DOS 操作系统

+
; 这里是注释
+[owner]
+name=John Doe
+organization=Acme Products
+
+[database]
+; 这里是注释
+server=192.0.2.42
+port=143
+file="acme payroll.dat"
+
+

现在已成为许多配置的非正式标准，其它操作系统可能使用 .conf 或 .cfg 作为后缀

+

稳定的特性

+
    +
  • 基本元素是键或属性
    • +
  • 每个键由名称和值构成，等号 (=) 分隔
    • +
  • 键名称显示在等号的左侧
    • +
  • 等号和分号是保留字符
    • +
+ +
name = value
+
+

与下面👇 JSON 大致相同

+
{
+  "name": "value"
+}
+
+

注释

+

注释 (;)

+
; 这里是注释文本，将被忽略
+
+

注释 (#)

+
# 这里是注释文本，⚠️ 部分编译器支持
+
+

一行之后的注释 (;,#) (不标准)

+
var = a       ; 这是一个内联注释
+foo = bar     # 这是另一个内联注释
+
+

在某些情况下注释必须单独出现在行上

+

部分(Sections)

+
    +
  • 名称单独出现在一行中
    • +
  • 名称在方括号 [ 和 ] 中
    • +
  • 没有明确的 section 结束 分隔符
    • +
  • 在下一个 section 声明处或文件末尾处结束
    • +
  • 部分和属性名称不区分大小写
    • +
+ +
[section]
+key1 = a
+key2 = b
+
+

与下面👇 JSON 大致相同

+
{
+  "section": {
+    "key1": "a",
+    "key2": "b"
+  }
+}
+
+

嵌套(部分解析器支持)

+
[section]
+domain = jaywcjlove.github.io
+
+[section.subsection]
+foo = bar
+
+

与下面👇 JSON 大致相同

+
{
+  "section": {
+    "domain": "jaywcjlove.github.io"
+    "subsection": {
+      "foo": "bar"
+    }
+  }
+}
+
+

嵌套到上一节(简写)

+
[section]
+domain = jaywcjlove.github.io
+[.subsection]
+foo = bar
+
+

转义字符

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
序列意思
\\\ (单个反斜杠，转义转义字符)
\'撇号
\"双引号
\0空字符
\a铃声/警报/声音
\b退格键，某些应用程序的贝尔字符
\t制表符
\r回车
\n换行
\;分号
\#数字符号
\=等号
\:冒号
\x????十六进制代码点的 Unicode 字符对应于 ????
+

另见

+ +
+ + \ No newline at end of file diff --git a/docs/toml.html b/docs/toml.html index 46da02f5..ca32255d 100644 --- a/docs/toml.html +++ b/docs/toml.html @@ -216,9 +216,21 @@

另见