released v1.19.0

* content: add about ffmpeg's content

* update

* update

.dockerignore

@@ -4,6 +4,8 @@ docs
 scripts
 node_modules
 package-lock.json
+pnpm-lock.yaml
+yarn.lock
 
 .DS_Store
 .cache

.editorconfig

@@ -0,0 +1,7 @@
+root = true
+
+[./docs/*.md]
+charset = utf-8
+indent_style = space
+indent_size = 2
+insert_final_newline = true

.gitignore

@@ -2,6 +2,8 @@ build
 dist
 node_modules
 package-lock.json
+pnpm-lock.yaml
+yarn.lock
 
 .DS_Store
 .cache

.lintstagedrc

@@ -1,3 +1,4 @@
 {
-  "**/*.{mjs,css,json,prettierrc,lintstagedrc}": ["prettier --write"]
+  "**/*.{mjs,css,json,prettierrc,lintstagedrc}": ["prettier --write"],
+  "./docs/*.md": ["npx markdownlint-cli --fix ./docs"]
 }

.markdownlint.json

@@ -0,0 +1,12 @@
+{
+  "MD003": false,
+  "MD013": false,
+  "MD014": false,
+  "MD024": false,
+  "MD033": false,
+  "MD040": false,
+  "MD010": {
+    "code_blocks": true,
+    "spaces_per_tab": 2
+  }
+}

CONTRIBUTING.md

@@ -38,7 +38,7 @@ Contributing 贡献
 
 ## CSS 类注释
 
-[`Quick Reference`](https://jaywcjlove.github.io/reference) 使用 [`@wcj/markdown-to-html`](https://github.com/jaywcjlove/markdown-to-html) 转换 `Markdown`，并使用 [`rehype-attr`](https://github.com/jaywcjlove/rehype-attr) 插件让其支持通过其注释语法添加类和样式。 此外，您可以在 Quick Reference 备忘清单上使用样式参考：https://jaywcjlove.github.io/reference/docs/quickreference.html
+[`Quick Reference`](https://jaywcjlove.github.io/reference) 使用 [`@wcj/markdown-to-html`](https://github.com/jaywcjlove/markdown-to-html) 转换 `Markdown`，并使用 [`rehype-attr`](https://github.com/jaywcjlove/rehype-attr) 插件让其支持通过其注释语法添加类和样式。此外，您可以在 Quick Reference 备忘清单上使用样式参考：<https://jaywcjlove.github.io/reference/docs/quickreference.html>
 
 最后，参考现有备忘清单的源代码是一个好习惯！
 
@@ -61,7 +61,7 @@ Contributing 贡献
 - SVG 图标尺寸 `<svg height="1em" width="1em"`
 - SVG 图标颜色使用继承颜色值 `<svg fill="currentColor"`
 
-#### 提示配置
+### 提示配置
 
 ```markdown
 [Django](./docs/djiango.md)<!--rehype:style=background: rgb(12 75 51/var(\-\-bg\-opacity));&class=contributing-->
@@ -69,7 +69,6 @@ Contributing 贡献
 
 添加 `contributing` 类名，会在卡片下方添加 _`👆待完善需要您的参与`_，添加 `data-info=👆看看还缺点儿什么？`，更换默认提示文本。
 
-
 ```markdown
 [Django](./docs/djiango.md)<!--rehype:style=background: rgb(12 75 51/var(\-\-bg\-opacity));&class=tag&data-lang=Python-->
 ```
@@ -83,3 +82,5 @@ npm i          # 安装依赖
 npm run build  # 编译输出 HTML
 npm run start  # 监听 md 文件编译输出 HTML
 ```
+
+- 或者你也可以使用 `pnpm` 或者 `yarn` 做为包管理器

README.md

@@ -9,10 +9,10 @@ Quick Reference
 <!--rehype:ignore:end-->
 
 <!--rehype:ignore:start-->
-[![Quick Reference](https://user-images.githubusercontent.com/1680273/197915058-b0aafe2c-10fc-4cc3-b54e-66329c7b4450.png)](https://jaywcjlove.github.io/reference)
+[![Quick Reference](https://user-images.githubusercontent.com/1680273/200623638-280ac85b-0cfa-4c60-bae3-ae14231acc6f.png)](https://jaywcjlove.github.io/reference)
 <!--rehype:ignore:end-->
 
-为开发人员分享快速参考备忘清单【速查表】 _(主要是方便自己)_，在看到 [Reference](https://github.com/Randy8080/reference) 快速参考备忘单，感觉非常简单，造轮子使命感突然来了，造个中文版本的，为了方便自己的技术栈查阅，立马撸起来 :)。如果您发现此处的备忘单不合适，您可以通过提交 [PR](https://github.com/jaywcjlove/reference/blob/main/CONTRIBUTING.md) 来修复它或提供更好的备忘清单，只针对【中文】用户。以下是开源天使提供的一些备忘清单和快速参考 :)。
+为开发人员分享快速参考备忘清单【速查表】。在看到 [Reference](https://github.com/Randy8080/reference) 快速参考备忘单，感觉非常简单，造中文版本的轮子使命感突然来了，为了方便自己的技术栈查阅，如果您提供一个清单，我将抽空搬运，立即撸起来 :)。如果您发现此处的备忘单不合适，您可以通过提交 [PR](https://github.com/jaywcjlove/reference/blob/main/CONTRIBUTING.md) 来修复它或提供更好的备忘清单，只针对【中文】用户。以下是开源天使提供的一些备忘清单和快速参考 :)。
 
 ## 正在建设中...
 
@@ -35,6 +35,7 @@ Quick Reference
 [Dockerfile](./docs/dockerfile.md)<!--rehype:style=background: rgb(0 72 153/var(\-\-bg\-opacity));&class=tag&data-lang=Docker-->
 [Django](./docs/djiango.md)<!--rehype:style=background: rgb(12 75 51/var(\-\-bg\-opacity));&class=contributing tag&data-lang=Python-->
 [Golang](./docs/golang.md)<!--rehype:style=background: rgb(39 160 193/var(\-\-bg\-opacity));-->
+[GraphQL](./docs/graphql.md)<!--rehype:style=background: rgb(214 66 146/var(\-\-bg\-opacity));-->
 [INI](./docs/ini.md)<!--rehype:style=background: rgb(57 59 60/var(\-\-bg\-opacity));-->
 [JSON](./docs/json.md)<!--rehype:style=background: rgb(57 59 60/var(\-\-bg\-opacity));-->
 [Java](./docs/java.md)<!--rehype:style=background: rgb(211 55 49/var(\-\-bg\-opacity));&class=contributing&data-info=👆看看还缺点儿什么？-->
@@ -42,6 +43,8 @@ Quick Reference
 [MySQL](./docs/mysql.md)<!--rehype:style=background: rgb(103 61 156/var(\-\-bg\-opacity));&class=tag&data-lang=SQL-->
 [MATLAB](./docs/matlab.md)<!--rehype:style=background: rgb(0 118 168/var(\-\-bg\-opacity));&class=contributing-->
 [Python](./docs/python.md)<!--rehype:style=background: rgb(240 81 57/var(\-\-bg\-opacity));-->
+[PostgreSQL](./docs/postgres.md)<!--rehype:style=background: rgb(43 109 163/var(\-\-bg\-opacity));&class=tag&data-lang=SQL-->
+[Ruby](./docs/ruby.md)<!--rehype:style=background: rgb(71 71 71/var(\-\-bg\-opacity));-->
 [Rust](./docs/rust.md)<!--rehype:style=background: rgb(71 71 71/var(\-\-bg\-opacity));-->
 [Swift](./docs/swift.md)<!--rehype:style=background: rgb(240 81 57/var(\-\-bg\-opacity));-->
 [SwiftUI](./docs/swiftui.md)<!--rehype:style=background: rgb(10 127 247/var(\-\-bg\-opacity));&class=tag&data-lang=swift-->
@@ -62,7 +65,7 @@ Quick Reference
 [JavaScript](./docs/javascript.md)<!--rehype:style=background: rgb(203 183 31/var(\-\-bg\-opacity));-->
 [Less.js](./docs/lessjs.md)<!--rehype:style=background: rgb(29 54 93/var(\-\-bg\-opacity));&class=tag&data-lang=CSS-->
 [React](./docs/react.md)<!--rehype:style=background: rgb(34 143 173/var(\-\-bg\-opacity));-->
-[RegEx](./docs/regex.md)<!--rehype:style=background: rgb(149 36 155/var(\-\-bg\-opacity));-->
+[RegEx 正则表达式](./docs/regex.md)<!--rehype:style=background: rgb(149 36 155/var(\-\-bg\-opacity));-->
 [TypeScript](./docs/typescript.md)<!--rehype:style=background: rgb(49 120 198/var(\-\-bg\-opacity));-->
 [Vue 2](./docs/vue2.md)<!--rehype:style=background: rgb(64 184 131/var(\-\-bg\-opacity));-->
 [Vue 3 ](./docs/vue.md)<!--rehype:style=background: rgb(64 184 131/var(\-\-bg\-opacity));&class=contributing-->
@@ -85,16 +88,16 @@ Quick Reference
 [Gmail](./docs/gmail.md)<!--rehype:style=background: rgb(234 67 54/var(\-\-bg\-opacity));-->
 [nginx](./docs/nginx.md)<!--rehype:style=background: rgb(0 153 0/var(\-\-bg\-opacity));-->
 [Semver](./docs/semver.md)<!--rehype:style=background: rgb(106 111 141/var(\-\-bg\-opacity));-->
-[Sketch](./docs/sketch.md)<!--rehype:style=background: rgb(223 148 0/var(\-\-bg\-opacity));-->
+[Sketch](./docs/sketch.md)<!--rehype:style=background: rgb(223 148 0/var(\-\-bg\-opacity));&class=tag&data-lang=macOS-->
 [Sublime Text](./docs/sublime-text.md)<!--rehype:style=background: rgb(223 148 0/var(\-\-bg\-opacity));-->
 [VSCode](./docs/vscode.md)<!--rehype:style=background: rgb(91 163 230/var(\-\-bg\-opacity));-->
 [Vim](./docs/vim.md)<!--rehype:style=background: rgb(9 150 8/var(\-\-bg\-opacity));-->
 [WebStorm](./docs/webstorm.md)<!--rehype:style=background: rgb(32 148 220/var(\-\-bg\-opacity));-->
 [XPath](./docs/xpath.md)<!--rehype:style=background: rgb(91 163 230/var(\-\-bg\-opacity));-->
-[Xcode](./docs/xcode.md)<!--rehype:style=background: rgb(24 151 233/var(\-\-bg\-opacity));-->
+[Xcode](./docs/xcode.md)<!--rehype:style=background: rgb(24 151 233/var(\-\-bg\-opacity));&class=tag&data-lang=macOS-->
 <!--rehype:class=home-card-->
 
-## Linux 命令
+## 命令
 
 [Ansible](./docs/ansible.md)<!--rehype:style=background: rgb(238 0 0/var(\-\-bg\-opacity));&class=contributing tag&data-lang=RedHad&data-info=👆看看还缺点儿什么？-->
 [Awk](./docs/awk.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
@@ -109,19 +112,22 @@ Quick Reference
 [Find](./docs/find.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
 [FFmpeg](./docs/ffmpeg.md)<!--rehype:style=background: rgb(0 193 9/var(\-\-bg\-opacity));&class=contributing-->
 [Htop](./docs/htop.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
-[Home Brew](./docs/homebrew.md)<!--rehype:style=background: rgb(252 185 87/var(\-\-bg\-opacity));-->
+[Home Brew](./docs/homebrew.md)<!--rehype:style=background: rgb(252 185 87/var(\-\-bg\-opacity));&class=tag&data-lang=macOS-->
 [Netstat](./docs/netstat.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
+[jq](./docs/jq.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));&class=tag&data-lang=JSON-->
 [Lsof](./docs/lsof.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
 [Netcat](./docs/netcat.md)<!--rehype:style=background: rgb(4 92 135/var(\-\-bg\-opacity));-->
 [Sed](./docs/sed.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
+[Systemd](./docs/systemd.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
 [SSH](./docs/ssh.md)<!--rehype:style=background: rgb(99 99 99/var(\-\-bg\-opacity));-->
 [Screen](./docs/screen.md)<!--rehype:style=background: rgb(99 99 99/var(\-\-bg\-opacity));-->
+[Tmux](./docs/tmux.md)<!--rehype:style=background: rgb(99 99 99/var(\-\-bg\-opacity));-->
 [YUM](./docs/yum.md)<!--rehype:style=background: rgb(86 86 123/var(\-\-bg\-opacity));-->
 <!--rehype:class=home-card-->
 
 ## 其它
 
-[Quick Reference](./docs/quickreference.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->
+[Quick Reference](./docs/quickreference.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));&class=tag&data-lang=排版说明-->
 [Github Actions](./docs/github-actions.md)<!--rehype:style=background: rgb(121 184 255/var(\-\-bg\-opacity));-->
 [Colors Named](./docs/colors-named.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));&class=tag&data-lang=CSS-->
 [HTTP 状态码](./docs/http-status-code.md)<!--rehype:style=background: rgb(16 185 129/var(\-\-bg\-opacity));-->

docs/ansible.md

@@ -18,7 +18,6 @@ Ansible 备忘清单
 
 - [Ansible 官方文档](https://docs.ansible.com)
 
-
 ### 配置位置
 
 文件路径 | 说明
@@ -27,12 +26,12 @@ Ansible 备忘清单
 `~/ansible.cfg`             | 用户特定的配置
 `$pwd/ansible.cfg`          | 当前目录下的配置
 
-
 ### Inventory文件(hosts列表)
 
 #### 静态Inventory
 
 `/etc/ansible/hosts`
+
 ```INI
 mail.example.com
 
@@ -41,6 +40,41 @@ foo.example.com
 bar.example.com
 ```
 
+### Inventory 主机组使用多个IP和域名
+
+```
+[web]
+172.18.12.5[1:4]
+[webservers]
+www[01:50].example.com
+```
+
+### Inventory 主机组使用子主机组
+
+```ini
+[usa:children]
+southeast
+northeast
+southwest
+northwest
+```
+
+### 给多台主机设置变量
+
+`group variables`
+如果组中的所有主机共享一个变量值，则可以一次将该变量应用于整个组
+
+```ini
+[atlanta]
+host1
+host2
+
+[atlanta:vars]
+ntp_server=ntp.atlanta.example.com
+proxy=proxy.atlanta.example.com
+
+```
+
 ## 命令行(ad-hoc)
 
 ### ansible
@@ -50,6 +84,7 @@ bar.example.com
 ```shell
 $ ansible all --list-hosts
 ```
+
 ping所有目标
 
 ```shell
@@ -95,7 +130,7 @@ $ ansible
 $ ansible <host-pattern> [options]
 ```
 
-----
+---
 
 :- | -
 :- | -
@@ -183,7 +218,6 @@ $ ansible-galaxy init --offline <ROLE>
 ```
 <!--rehype:className=wrap-text-->
 
-
 ### ansible-doc
 
 在本地访问文档
@@ -205,13 +239,13 @@ $ ansible-doc [options] [module...]
 `--version` | 显示程序的版本号并退出
 <!--rehype:className=style-list-->
 
-
 ### ansible-vault
 
 ```bash
 $ ansible-vault
 $ ansible-vault [create|decrypt|edit|encrypt|rekey|view] [--help] [options] vaultfile.yml
 ```
+
 ---
 
 :- | -
@@ -232,6 +266,7 @@ $ ansible-vault [create|decrypt|edit|encrypt|rekey|view] [--help] [options] vaul
 $ ansible-playbook
 $ ansible-playbook playbook.yml
 ```
+
 ---
 
 :- | -
@@ -300,6 +335,7 @@ $ ansible-playbook playbook.yml
 $ ansible-pull 
 $ ansible-pull -U <repository> [options]
 ```
+
 ---
 
 :- | -
@@ -358,10 +394,9 @@ $ ansible-pull -U <repository> [options]
 <!-- ### ansible-playbook -->
 <!-- todo -->
 
-
-
 另见
 ---
+
 [Getting started with Ansible](https://docs.ansible.com/ansible/latest/getting_started/index.html)  
 [Introduction to ad hoc commands](https://docs.ansible.com/ansible/latest/user_guide/intro_adhoc.html)
 [Ansible cheatsheet](https://github.com/luckylittle/ansible-cheatsheet/blob/master/ansible-cheatsheet.txt)

docs/awk.md

@@ -59,7 +59,8 @@ $0/NR ▶ │  1   │  baidu.com   │  awk  │
 $0/NR ▶ │  2   │  google.com  │  25   │
         └──────┴──────────────┴───────┘
 ```
----
+
+----
 
 ```shell
 # 第一个和最后一个字段
@@ -253,7 +254,6 @@ awk -v varName="$PWD" '
     END {print varName}' </dev/null
 ```
 
-
 Awk 运算符
 ---------
 
@@ -366,7 +366,6 @@ Awk 函数
 `toupper(s)`          | 字符串 `s` 转大写
 `getline`             | 将 `$0` 设置为当前输入文件中的下一个输入记录
 
-
 ### 用户定义函数
 
 ```shell
@@ -424,7 +423,6 @@ awk 'BEGIN {
 }'
 ```
 
-
 ### 带拆分的数组
 
 ```shell
@@ -536,7 +534,6 @@ awk -F: '{
 }' /etc/passwd
 ```
 
-
 Awk 循环
 ----------
 
@@ -744,6 +741,7 @@ daemon     /sbin
 -------------
 
 ### 正则表达式元字符
+
 - `\`
 - `^`
 - `$`

docs/bash.md

@@ -64,7 +64,6 @@ NAME = "John"   # => Error (关于空间)
 
 见：[特殊参数](http://wiki.bash-hackers.org/syntax/shellvars#special_parameters_and_shell_variables)
 
-
 ### 函数
 
 ```bash
@@ -265,7 +264,9 @@ for e in "${Fruits[@]}"; do
     echo $e
 done
 ```
+
 #### With index
+
 ```bash
 for i in "${!Fruits[@]}"; do
   printf "%s\t%s\n" "$i" "${Fruits[$i]}"
@@ -443,7 +444,6 @@ fi
 `[[ f1 -ot f2 ]]` | f2 早于 f1
 `[[ f1 -ef f2 ]]` | 相同的文件
 
-
 ### 更多条件
 
 条件 | 描述
@@ -570,7 +570,6 @@ while :; do
 done
 ```
 
-
 ### 正在读取行
 
 ```bash
@@ -720,7 +719,6 @@ Bash 历史
 
 `!!` 可以替换为任何有效的扩展，即 `!cat`、`!-2`、`!42` 等。
 
-
 各种各样的
 -------------
 
@@ -741,7 +739,6 @@ $(($RANDOM%200))  # Random number 0..199
 pwd # still in first directory
 ```
 
-
 ### 检查命令
 
 ```bash
@@ -765,7 +762,6 @@ python hello.py &>/dev/null    # 标准输出和标准错误到（空null）
 python hello.py < foo.txt      # 将 foo.txt 提供给 python 的标准输入
 ```
 
-
 ### 来源相对
 
 ```bash
@@ -791,7 +787,6 @@ case "$1" in
 esac
 ```
 
-
 ### 陷阱错误
 <!--rehype:wrap-class=col-span-2-->
 
@@ -862,7 +857,6 @@ fi
 
 见[特殊参数](http://wiki.bash-hackers.org/syntax/shellvars#special_parameters_and_shell_variables)。
 
-
 ### grep 检查
 <!--rehype:wrap-class=col-span-2-->
 
@@ -872,7 +866,6 @@ if grep -q 'foo' ~/.bash_history; then
 fi
 ```
 
-
 ### 反斜杠转义
 <!--rehype:wrap-class=row-span-2-->
 
@@ -963,11 +956,11 @@ echo "${args[@]}"
 另见
 ----
 
-* [Shell 教程](https://jaywcjlove.github.io/shell-tutorial) _(jaywcjlove.github.io)_
-* [Devhints](https://devhints.io/bash) _(devhints.io)_
-* [Bash-hackers wiki](http://wiki.bash-hackers.org/) _(bash-hackers.org)_
-* [Shell vars](http://wiki.bash-hackers.org/syntax/shellvars) _(bash-hackers.org)_
-* [Learn bash in y minutes](https://learnxinyminutes.com/docs/bash/) _(learnxinyminutes.com)_
-* [Bash Guide](http://mywiki.wooledge.org/BashGuide) _(mywiki.wooledge.org)_
-* [ShellCheck](https://www.shellcheck.net/) _(shellcheck.net)_
-* [shell - Standard Shell](https://devmanual.gentoo.org/tools-reference/bash/index.html) _(devmanual.gentoo.org)_
+- [Shell 教程](https://jaywcjlove.github.io/shell-tutorial) _(jaywcjlove.github.io)_
+- [Devhints](https://devhints.io/bash) _(devhints.io)_
+- [Bash-hackers wiki](http://wiki.bash-hackers.org/) _(bash-hackers.org)_
+- [Shell vars](http://wiki.bash-hackers.org/syntax/shellvars) _(bash-hackers.org)_
+- [Learn bash in y minutes](https://learnxinyminutes.com/docs/bash/) _(learnxinyminutes.com)_
+- [Bash Guide](http://mywiki.wooledge.org/BashGuide) _(mywiki.wooledge.org)_
+- [ShellCheck](https://www.shellcheck.net/) _(shellcheck.net)_
+- [shell - Standard Shell](https://devmanual.gentoo.org/tools-reference/bash/index.html) _(devmanual.gentoo.org)_

docs/c.md

@@ -608,7 +608,7 @@ printf("%c\n", myLetter);
 printf("%lf\n", myDouble);
 ```
 
----
+----
 
 数据类型 | 说  明
 :- | :-
@@ -620,7 +620,6 @@ printf("%lf\n", myDouble);
 `double` | 双精度浮点型
 `void` | 无类型
 
-
 ### 基本格式说明符
 
 | 格式说明符 | 数据类型 |
@@ -743,8 +742,6 @@ Carole 和 Debra: 我们爱你！
 
 需要把一个宏的参数转换为字符串常量时，使用字符串常量化运算符 `#`
 
-
-
 ### 标记粘贴运算符（##）
 
 ```c
@@ -821,12 +818,12 @@ void myFunction() { // 声明 declaration
 }
 ```
 
----
+----
 
 - `Declaration` 声明函数名称、返回类型和参数 _(如果有)_
 - `Definition` 函数体 _(要执行的代码)_
 
----
+----
 
 ```c
 // 函数声明
@@ -949,7 +946,7 @@ printf("%f", floor(1.4)); // 四舍五入 (舍)
 printf("%f", pow(4, 3));  // x(4)的y(3)次方
 ```
 
----
+----
 
 - `abs(x)` 绝对值
 - `acos(x)` 反余弦值
@@ -1304,16 +1301,21 @@ void main (){
 
 - 安装 [`Docker`](./docker.md)
 - 创建 [`Dockerfile`](./dockerfile.md) 文件
+
     ```dockerfile
     FROM alpine:3.14
     RUN apk add --no-cache gcc musl-dev
     RUN apk add --no-cache g++
     ```
+
 - 生成本地 myalpine 镜像
+
     ```bash
     docker build -t myalpine .
     ```
+
 - 运行映像，把当前路径 `($PWD)` 映射至容器的 `/test` 目录，用 `gcc` 编译程序，`exit`返回
+
     ```bash
     docker run -it -v $PWD:/test myalpine
     root@b1a38bd7107a:/# cd test
@@ -1324,7 +1326,6 @@ void main (){
     ```
 <!--rehype:className=style-timeline-->
 
-
 另见
 ---
 

docs/cargo.md

@@ -6,8 +6,7 @@ Cargo 备忘清单
 入门
 --------
 
-### 安装 Rust 和 Cargo
-
+### 安装/升级 Rust 和 Cargo
 
 ```bash
 $ curl -sSf https://static.rust-lang.org/rustup.sh | sh
@@ -266,7 +265,7 @@ $ cargo install --path .
 $ cargo install --list
 ```
 
-----
+---
 
 - `--vers version`
 - `--version version` 指定要安装的版本
@@ -315,13 +314,13 @@ $ cargo uninstall ripgrep
 $ cargo login [options] [token]
 ```
 
-----
+---
 
 :-|:-
 :-|:-
 `--registry` | 要使用的注册表的名称
 
-----
+---
 
 :-|:-
 :-|:-
@@ -339,7 +338,8 @@ $ cargo owner --add username foo
 # 从包中删除所有者：
 $ cargo owner --remove username foo
 ```
-----
+
+---
 
 :-|:-
 :-|:-
@@ -384,7 +384,7 @@ $ cargo owner --remove username foo
 $ cargo package [options]
 ```
 
-----
+---
 
 - `-l`, `--list` 输出包中包含的文件(不实际进行打包)。
 - `--no-verify` 构建包时不进行校验。

docs/chmod.md

@@ -107,7 +107,6 @@ d  rwx  r-x  r-x
 | `a`         | 全部，和 ugo 一样 |
 <!--rehype:className=show-header-->
 
-
 ### 权限
 
 | 缩写 | 权限    | 值 |
@@ -138,7 +137,6 @@ Chmod 示例
 | `-`    | 删除      |
 | `=`    | 设置        |
 
-
 ### chmod 600
 
 ```shell

docs/colors-named.md

@@ -6,6 +6,8 @@ CSS 定义了一大组[命名颜色](https://www.w3.org/TR/css-color-4/#named-co
 Named Colors
 ---
 
+<!-- markdownlint-disable MD038 -->
+
 ### 颜色列表
 <!--rehype:wrap-class=col-span-3&style=display:none;&wrap-style=padding-top: 0;-->
 
@@ -760,7 +762,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 150° Green-Cyans
 <!--rehype:wrap-class=col-span-3-->
 
@@ -880,7 +881,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 180° Cyans
 <!--rehype:wrap-class=col-span-3-->
 
@@ -1000,7 +1000,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 210° Cyan-Blues
 <!--rehype:wrap-class=col-span-3-->
 
@@ -1120,7 +1119,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 240° blues
 <!--rehype:wrap-class=col-span-3-->
 
@@ -1240,7 +1238,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 270° Blue-Magentas
 <!--rehype:wrap-class=col-span-3-->
 
@@ -1360,7 +1357,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 300° Magentas
 <!--rehype:wrap-class=col-span-3-->
 
@@ -1480,7 +1476,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 ### 330° Magenta-Reds
 <!--rehype:wrap-class=col-span-3-->
 
@@ -1600,7 +1595,6 @@ HSL 颜色示例
 </table>
 <!--rehype:className=show-header-->
 
-
 另见
 ----
 

docs/conan.md

@@ -209,7 +209,6 @@ $ conan inspect boost/1.74.0
 
 请参阅 [conan get](https://docs.conan.io/en/latest/reference/commands/consumer/get.html) 和 [conan inspect](https://docs.conan.io/en/latest/reference/commands/misc/inspect.html) 参考
 
-
 ### Lockfiles
 
 创建一个锁文件：

docs/cron.md

@@ -1,7 +1,6 @@
 Cron 备忘清单
 ===
 
-
 [Cron](https://en.wikipedia.org/wiki/Cron) 最适合安排重复性任务。 可以使用关联的 at 实用程序来完成一次性任务的调度。
 
 Crontab 格式
@@ -27,7 +26,7 @@ Min  Hour Day  Mon  Weekday
 └─────────────────────  分钟           (0..59)
 ```
 
-------
+-------
 
 | 字段          | 范围   | 特殊字符             |
 |--------------|--------|--------------------|
@@ -38,7 +37,6 @@ Min  Hour Day  Mon  Weekday
 | 星期几        | 0 - 6  | , - * ? / L #      |
 <!--rehype:className=show-header -->
 
-
 ### 示例
 
 | Example        | Description            |
@@ -56,7 +54,6 @@ Min  Hour Day  Mon  Weekday
 | `0 0 0 1 1 *`  | 每年 1 月 1 日（每年）   |
 | `@reboot`      | 每次重启 _(非标准)_   |
 
-
 ### 特殊字符串
 
 | 特殊字符串       | 意义                                            |
@@ -64,14 +61,13 @@ Min  Hour Day  Mon  Weekday
 | @reboot        | 运行一次，在系统启动时 _（非标准）_ |
 | @yearly        | 每年运行一次，“0 0 1 1 *” _（非标准）_ |
 | @annually      | （与@yearly 相同）_（非标准）_ |
-| @monthly       | 每月运行一次，“0 0 1 * *” _（非标准）_ |
-| @weekly        | 每周运行一次，“0 0 * * 0” _（非标准）_ |
-| @daily         | 每天运行一次，“0 0 * * *” _（非标准）_ |
+| @monthly       | 每月运行一次，“0 0 1 \* \*” _（非标准）_ |
+| @weekly        | 每周运行一次，“0 0 \* \* 0” _（非标准）_ |
+| @daily         | 每天运行一次，“0 0 \* \* \*” _（非标准）_ |
 | @midnight      | （与@daily 相同）_（非标准）_ |
-| @hourly        | 每小时运行一次，“0 * * * *” _（非标准）_ |
+| @hourly        | 每小时运行一次，“0 \* \* \* \*” _（非标准）_ |
 <!--rehype:className=show-header -->
 
-
 ### Crontab 命令
 
 | -            | -                                           |
@@ -82,7 +78,6 @@ Min  Hour Day  Mon  Weekday
 | `crontab -v` | 显示您上次编辑 crontab 文件的时间。 _（非标准）_ |
 | `echo "@reboot echo hi" | crontab` | 轻松添加任务 |
 
-
 ### 特殊字符
 <!--rehype:wrap-class=col-span-2-->
 
@@ -97,7 +92,6 @@ Min  Hour Day  Mon  Weekday
 `问号(?)`  | 可以代替“*”并允许用于月份和星期几。使用仅限于 cron 表达式中的 `月份中的某天` 或 `星期几`。
 <!--rehype:className=show-header auto-wrap-->
 
-
 ## Also see
 
 * [Devhints](https://devhints.io/cron) _(devhints.io)_

docs/css.md

@@ -149,14 +149,14 @@ div {
 }
 ```
 
-查看: [Flexbox](#css-flexbox) | [Flex Tricks](#css-flexbox-tricks)
+查看: [Flexbox](#css-flexbox) | [Flex Tricks](#css-flexbox-技巧)
 
 ### Grid 布局
 
 ```css
 #container {
   display: grid;
-  grid: repeat(2, 60px) / auto-flow 80px;
+s  grid: repeat(2, 60px) / auto-flow 80px;
 }
 #container > div {
   background-color: #8ca0ff;
@@ -165,7 +165,7 @@ div {
 }
 ```
 
-查看: [Grid Layout](#css-grid-layout)
+查看: [Grid Layout](#grid-布局)
 
 ### 变量和计数器
 
@@ -244,7 +244,6 @@ p:first-child {
 
 另见: [元素](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Type_selectors) / [类](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Class_selectors) / [ID](https://developer.mozilla.org/zh-CN/docs/Web/CSS/ID_selectors) / [通配](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Universal_selectors) 选择器
 
-
 ### 组合器
 
 选择器 | 说明
@@ -565,7 +564,6 @@ CSS 盒子模型
 
 另见: [Visibility](https://developer.mozilla.org/zh-CN/docs/Web/CSS/visibility)
 
-
 ### Auto 关键字
 
 ```css
@@ -577,7 +575,6 @@ div {
 
 另见: [边距(margin)](https://developer.mozilla.org/zh-CN/docs/Web/CSS/margin)
 
-
 ### 溢出(Overflow)
 
 ```css
@@ -804,7 +801,7 @@ flex-wrap: nowrap | wrap | wrap-reverse;
 flex-direction: row | row-reverse | column | column-reverse;
 ```
 
-----
+---
 
 ```bash
 ╭┈┈╮  ▲         ╭┈┈╮  ┆
@@ -825,7 +822,7 @@ column-reverse  column       row             row-reverse
 align-items: flex-start | flex-end | center | baseline | stretch;
 ```
 
-----
+---
 
 ```css
   ▶ flex-start(起点对齐)    ▶ flex-end(终点对齐)
@@ -863,7 +860,7 @@ align-content: flex-start | flex-end | center | space-between | space-around | s
 ```
 <!--rehype:className=wrap-text -->
 
-----
+---
 
 ```css
  ▶ flex-start(起点对齐)     ▶ flex-end(终点对齐)
@@ -903,7 +900,7 @@ align-content: flex-start | flex-end | center | space-between | space-around | s
 }
 ```
 
-----
+---
 
 ```css
 ╭┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╮ ╭┈┈┈┈┈┈┈┈┈╮
@@ -927,7 +924,7 @@ align-content: flex-start | flex-end | center | space-between | space-around | s
 }
 ```
 
-----
+---
 
 ```css
 ╭┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╮
@@ -983,7 +980,6 @@ CSS Flexbox 技巧
 
 ### 移动布局
 
-
 ```css
 .container {
   display: flex;
@@ -1166,7 +1162,6 @@ grid-row-end: span 2;
 }
 ```
 
-
 ### Justify Self
 
 ```css
@@ -1376,7 +1371,6 @@ a[href^="http"]:empty::before {
 
 如果 `<a>` 标签里面没有内容，将 `href` 的值作为内容展示
 
-
 ### 使用 :root 表示灵活类型
 <!--rehype:wrap-class=row-span-2-->
 
@@ -1396,6 +1390,27 @@ body {
 }
 ```
 
+### 吸附滚动
+<!--rehype:wrap-class=row-span-2-->
+
+```css {5,12}
+.container {
+  height: 250px;
+  overflow-x: scroll;
+  display: flex;
+  scroll-snap-type: x mandatory;
+  column-gap: 10px;
+}
+.child {
+  flex: 0 0 66%;
+  width: 250px;
+  background-color: #663399;
+  scroll-snap-align: center;
+}
+```
+
+可用于 `轮播图` 效果，[效果预览](https://codesandbox.io/embed/pensive-leftpad-w9p8rk?fontsize=14&hidenavigation=1&theme=dark)
+
 ### 类似 contenteditable 的样式
 
 ```css
@@ -1408,7 +1423,6 @@ div {
 
 通过样式来控制一个元素 `div` 是否可以编辑
 
-
 另见
 ---------
 

docs/curl.md

@@ -13,7 +13,6 @@ Curl 是一种在服务器之间传输数据的工具，支持协议，包括 HT
 - [Curl GitHub 源码仓库](https://github.com/curl/curl) _(github.com)_
 - [Curl 官方网站](https://curl.se/) _(curl.se)_
 
-
 ### Options
 <!--rehype:wrap-class=col-span-2 row-span-2-->
 

docs/djiango.md

@@ -17,17 +17,20 @@ $ pip --version
 ```
 <!--rehype:className=wrap-text -->
 
-如果你没有安装 PIP，你可以从这个页面下载并安装它：https://pypi.org/project/pip/
+如果你没有安装 PIP，你可以从这个页面下载并安装它：<https://pypi.org/project/pip/>
 
 ### 入门
 <!--rehype:wrap-class=row-span-4-->
 
 - 创建虚拟环境
+
   ```bash
   $ py -m venv myproject # Windows
   $ python -m venv myproject # Unix/MacOS
   ```
+
 - 其中包含子文件夹和文件，如下所示
+
   ```bash
   myproject
    ├┈Include
@@ -35,21 +38,27 @@ $ pip --version
    ├┈Scripts
    ╰┈pyvenv.cfg
   ```
+
 - 以下命令来激活环境
+
   ```bash
   # Windows:
   myproject\Scripts\activate.bat
   # Unix/MacOS:
   source myproject/bin/activate
   ```
+
 - 提示符中看到以下结果：
+
   ```bash
   # Windows:
   (myproject) C:\Users\Your Name>
   # Unix/MacOS:
   (myproject) ... $
   ```
+
 - 安装 Django
+
   ```bash
   # Windows:
   (myproject) C:\Users\Name>py -m pip install Django
@@ -762,9 +771,6 @@ function myFunction() {
 ```
 <!--rehype:className=wrap-text -->
 
-
-
-
 另见
 ----
 

docs/docker.md

@@ -21,7 +21,6 @@ $ docker run -d -p 80:80 docker/getting-started
 - `-p 80:80` -  将端口 80 映射到容器中的端口 80
 - `docker/getting-started` - 要使用的镜像
 
-
 在前台创建并运行容器
 
 ```shell
@@ -86,7 +85,6 @@ Docker 容器
 `docker stats nginx-server`   | 容器资源使用
 `docker diff nginx-server`    | 列出对容器所做的更改
 
-
 ### 创建容器
 
 ```shell

docs/electron.md

@@ -3,7 +3,6 @@ Electron 备忘清单
 
 此快速参考备忘单提供了 Electron v21 API 说明和使用示例。
 
-
 入门
 ----
 
@@ -15,11 +14,14 @@ Electron 备忘清单
 #### 创建你的应用程序
 
 - 安装
+
   ```bash
   mkdir my-app && cd my-app
   npm init
   ```
+
   在项目根目录会生成 `package.json`
+
   ```json
   {
     "name": "my-app",
@@ -30,22 +32,30 @@ Electron 备忘清单
     "license": "MIT"
   }
   ```
+
 - 安装依赖包
+
   ```bash
   npm install --save-dev electron
   ```
+
 - 添加开发模式打开您的应用命令
+
   ```js
   "scripts": {
     "start": "electron ."
   }
   ```
+
 - 运行命令，启动应用程序
+
   ```bash
   npm start
   ```
+
   入口都是 `main` 文件。这个文件控制了主进程，它运行在一个完整的Node.js环境中
 - 创建 `index.html` 页面
+
   ```html
   <!DOCTYPE html>
   <html>
@@ -60,7 +70,9 @@ Electron 备忘清单
     </body>
   </html>
   ```
+
 - 窗口中打开您的页面
+
   ```js
   const {
     app,
@@ -684,7 +696,6 @@ child.once('ready-to-show', () => {
 `win.setTitleBarOverlay(options)` _(win)_ | 在已开启 Window Controls Overlay 的窗口上，此方法将更新标题栏叠加层的样式 [#](https://www.electronjs.org/zh/docs/latest/api/browser-window#winsettitlebaroverlayoptions-windows)
 <!--rehype:className=style-list-->
 
-
 ### 静态方法
 <!--rehype:wrap-class=col-span-3-->
 

docs/emacs.md

@@ -522,5 +522,3 @@ With prefix argument LINE, put point on LINE."
                   0
               (prefix-numeric-value line))))
 ```
-
-

docs/emmet.md

@@ -3,7 +3,6 @@ Emmet 备忘清单
 
 [Emmet](https://emmet.io/) 是一个用于提升 [HTML](./html.md) 和 CSS 代码编写的 Web 开发人员工具包，它允许您使用著名的 CSS 选择器以光速编写大型 HTML 代码块。
 
-
 Emmet 语法
 ---------------
 
@@ -16,7 +15,6 @@ Emmet 语法
 - [Emmet for Coda](https://emmet.io/download/coda/) _(emmet.io)_
 - [Emmet for Atom](https://github.com/emmetio/emmet-atom#readme) _(github.com)_
 
-
 ### 乘法：*
 
 `ul>li*5`
@@ -81,7 +79,7 @@ p>{Click }+a{here}+{ 继续}
 ### ID 和 CLASS 属性
 <!--rehype:wrap-class=row-span-2-->
 
-#header
+\# header
 
 ```html
 <div id="header"></div>
@@ -199,7 +197,6 @@ ul>li.item$@2*3
 </ul>
 ```
 
-
 ### 上一层: ^
 
 div+div>p>span+em^bq
@@ -793,7 +790,6 @@ select
 
 select:disabled, select:d 别名 select[disabled.]
 
-
 ```html
 <select name="" id="" disabled="disabled"></select>
 ```
@@ -1162,7 +1158,7 @@ html:4s 别名 !!!4s+doc4[lang=${lang}]
 ```
 <!--rehype:className=wrap-text -->
 
-html:xt 别名 !!!xt+doc4[xmlns=http://www.w3.org/1999/xhtml xml:lang=${lang}]
+html:xt 别名 !!!xt+doc4[xmlns=<http://www.w3.org/1999/xhtml> xml:lang=${lang}]
 <!--rehype:className=wrap-text -->
 
 ```html
@@ -1179,7 +1175,7 @@ html:xt 别名 !!!xt+doc4[xmlns=http://www.w3.org/1999/xhtml xml:lang=${lang}]
 ```
 <!--rehype:className=wrap-text -->
 
-html:xs 别名 !!!xs+doc4[xmlns=http://www.w3.org/1999/xhtml xml:lang=${lang}]
+html:xs 别名 !!!xs+doc4[xmlns=<http://www.w3.org/1999/xhtml> xml:lang=${lang}]
 
 ```html
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
@@ -1195,7 +1191,7 @@ html:xs 别名 !!!xs+doc4[xmlns=http://www.w3.org/1999/xhtml xml:lang=${lang}]
 ```
 <!--rehype:className=wrap-text -->
 
-html:xxs 别名 !!!xxs+doc4[xmlns=http://www.w3.org/1999/xhtml xml:lang=${lang}]
+html:xxs 别名 !!!xxs+doc4[xmlns=<http://www.w3.org/1999/xhtml> xml:lang=${lang}]
 
 ```html
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
@@ -1968,6 +1964,7 @@ CSS
     font-weight: normal;
 }
 ```
+
 #### @i, @import
 
 ```css
@@ -2057,7 +2054,7 @@ CSS
 `bfv:h` | backface-visibility:hidden;
 `bfv:v` | backface-visibility:visible;
 `bg:ie` | filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='x.png',sizingMethod='crop');
-`cm` | /* ${child} */
+`cm` | /\* ${child} */
 `colm` | columns:;
 `colmc` | column-count:;
 `colmf` | column-fill:;
@@ -2384,7 +2381,7 @@ choose+ A别名 xsl:choose>xsl:when+xsl:otherwise
 </xsl:choose>
 ```
 
-xsl 别名 !!!+xsl:stylesheet[version=1.0 xmlns:xsl=http://www.w3.org/1999/XSL/Transform]>{ | }
+xsl 别名 !!!+xsl:stylesheet[version=1.0 xmlns:xsl=<http://www.w3.org/1999/XSL/Transform>]>{ | }
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
@@ -2401,4 +2398,4 @@ xsl 别名 !!!+xsl:stylesheet[version=1.0 xmlns:xsl=http://www.w3.org/1999/XSL/T
 另见
 --------
 
-* [Emmet Cheat sheet](https://docs.emmet.io/cheat-sheet/) _(docs.emmet.io)_
+- [Emmet Cheat sheet](https://docs.emmet.io/cheat-sheet/) _(docs.emmet.io)_

docs/es6.md

@@ -149,7 +149,6 @@ class Circle extends Shape {
 原型的语法糖。
 请参阅: [类](https://babeljs.io/learn-es2015/#classes)
 
-
 Promises
 --------
 
@@ -237,7 +236,9 @@ let {title, author} = {
 const scores = [22, 33]
 const [math = 50, sci = 50, arts = 50] = scores
 ```
+
 ----
+
 ```js
 // Result:
 // math === 22, sci === 33, arts === 50
@@ -252,7 +253,9 @@ function greet({ name, greeting }) {
   console.log(`${greeting}, ${name}!`)
 }
 ```
+
 ----
+
 ```js
 greet({ name: 'Larry', greeting: 'Ahoy' })
 ```
@@ -266,7 +269,9 @@ function greet({ name = 'Rauno' } = {}) {
   console.log(`Hi ${name}!`);
 }
 ```
+
 ----
+
 ```js
 greet() // Hi Rauno!
 greet({ name: 'Larry' }) // Hi Larry!
@@ -279,7 +284,9 @@ function printCoordinates({ left: x, top: y }) {
   console.log(`x: ${x}, y: ${y}`)
 }
 ```
+
 ----
+
 ```js
 printCoordinates({ left: 25, top: 90 })
 ```
@@ -456,7 +463,9 @@ Objects
 ```js
 module.exports = { hello, bye }
 ```
+
 同下:
+
 ```js
 module.exports = {
   hello: hello, bye: bye
@@ -524,22 +533,30 @@ Modules 模块
 import 'helpers'
 // 又名: require('···')
 ```
----
+
+----
+
 ```js
 import Express from 'express'
 // 又名: const Express = require('···').default || require('···')
 ```
----
+
+----
+
 ```js
 import { indent } from 'helpers'
 // 又名: const indent = require('···').indent
 ```
----
+
+----
+
 ```js
 import * as Helpers from 'helpers'
 // 又名: const Helpers = require('···')
 ```
----
+
+----
+
 ```js
 import { indentSpaces as indent } from 'helpers'
 // 又名: const indent = require('···').indentSpaces
@@ -554,12 +571,16 @@ import { indentSpaces as indent } from 'helpers'
 export default function () { ··· }
 // 又名: module.exports.default = ···
 ```
+
 ----
+
 ```js
 export function mymethod () { ··· }
 // 又名: module.exports.mymethod = ···
 ```
+
 ----
+
 ```js
 export const pi = 3.14159
 // 又名: module.exports.pi = ···
@@ -643,7 +664,6 @@ new URL('data.txt', import.meta.url)
 
 Node.js 环境中，`import.meta.url`返回的总是本地路径，即 `file:URL` 协议的字符串，比如 `file:///home/user/foo.js`
 
-
 Generators
 ----------
 
@@ -655,7 +675,9 @@ function* idMaker () {
   while (true) { yield id++ }
 }
 ```
----
+
+----
+
 ```js
 let gen = idMaker()
 gen.next().value  // → 0
@@ -707,7 +729,6 @@ gen[Symbol.iterator] = function* () {
 
 `Generator` 函数赋值给 `Symbol.iterator` 属性，从而使得 `gen` 对象具有了 `Iterator` 接口，可以被 `...` 运算符遍历了
 
-
 ### Symbol.iterator 属性
 
 ```js

docs/expressjs.md

@@ -10,16 +10,21 @@ Express 备忘清单
 <!--rehype:wrap-class=row-span-2-->
 
 - 创建项目，添加 `package.json` 配置
+
   ```bash
   $ mkdir myapp # 创建目录
   $ cd myapp    # 进入目录
   $ npm init -y # 初始化一个配置
   ```
+
 - 安装依赖
+
   ```bash
   $ npm install express # 安装依赖
   ```
+
 - 入口文件 `index.js` 添加代码：
+
   ```js
   const express = require('express')
   const app = express()
@@ -31,7 +36,9 @@ Express 备忘清单
     console.log(`监听端口${port}示例应用`)
   })
   ```
+
 - 使用以下命令运行应用程序
+
   ```bash
   $ node index.js
   ```

docs/ffmpeg.md

@@ -103,7 +103,6 @@ $ ffmpeg -i movie.webm movie.mp4
 `Mi` | 220 | 1048576 | 兆字节 Mebibyte
 `Gi` | 230 | 1073741824 | Gibibyte
 
-
 ### 音频参数
 <!--rehype:wrap-class=col-span-2-->
 
@@ -170,7 +169,10 @@ $ ffmpeg -r 1 -i input.m2v -r 24 output.avi
 <!--rehype:wrap-class=col-span-2-->
 
 ```bash
+# 从1分45秒开始剪切2分35秒
 $ ffmpeg -i <input> -ss 00:01:45 -t 00:02:35 -vcodec copy -acodec copy <output>
+# 从1分45秒开始剪切到第4分20秒，与上一行等效
+$ ffmpeg -i <input> -ss 00:01:45 -to 00:04:20 -codec copy <output>
 $ ffmpeg -ss 00:00:30 -i orginalfile.mpg -t 00:00:05 -vcodec copy -acodec copy newfile.mpg
 # 从 4.5 秒开始的 5 秒长的视频
 $ ffmpeg -i in.mp4 -ss 4.5 -t 5 out.mp4
@@ -232,11 +234,11 @@ $ ffmpeg -i in.mp4 -filter:v scale="538:trunc(ow/a/2)*2" -c:a copy out.mp4
 ### 提取音频流
 
 ```bash
-$ ffmpeg -i file.mp4 -vn -acodec copy output.aac 
+$ ffmpeg -i file.mp4 -vn -c copy output.aac 
 ```
 <!--rehype:className=wrap-text -->
 
-将`-vn`(无视频)与 `-acodec copy` 结合起来。请注意，输出文件扩展名必须与输入文件中的音频编解码器匹配，`-acodec copy` 才能工作。
+`-vn` (过滤视频)，使用 `-c copy`，不会重新解码和编码，加快速度。
 
 ### 创建缩略图
 <!--rehype:wrap-class=row-span-2-->
@@ -255,6 +257,12 @@ $ ffmpeg -i <input file> -vf fps=1/60 thumbnails/thumb%03d.png
 ```
 <!--rehype:className=wrap-text -->
 
+### 提取视频流
+
+```bash
+$ ffmpeg -i file.mp4 -an -c copy output.mp4
+```
+
 ### 处理 id3 标签
 <!--rehype:wrap-class=row-span-2-->
 
@@ -281,8 +289,44 @@ $ ffmpeg -i file.aac -acodec mp3 -ar 44100 -ab 128000 output.mp3
 ```
 <!--rehype:className=wrap-text -->
 
+### -map 命令
+<!--rehype:wrap-class=col-span-2 row-span-2-->
+
+`-map` 命令用于指定索引文件，以及索引文件中流类型和它的索引
+
+----
+
+```bash
+-map index:stram_type:stream_index
+```
+
+----
+
+:- | -
+:- | -
+`input_file_index` | 输入的文件索引(从 0 开始)
+`stream_type` | 指定文件流的类型(a -> 音频，v -> 视频，s -> 字幕)
+`stream_index` | 指定流类型的索引(从 0 开始)
+
+将第一个输入文件的第二个音频拷贝到 out.mp3
+
+```bash
+$ ffmpeg -i input.mp4 -map 0:a:1 -c copy out.mp3
+```
+
+将第一个输入文件的视频流和第二个输入文件的音频流拷贝到 out.mp4
+
+```bash
+$ ffmpeg -i i1.mp4 -i i2.mp4 -map 0:v -map 0:a -c copy out.mp4
+```
+
+#### 反向 -map 命令
+<!--rehype:wrap-class=col-span-2-->
+
+反向的 map 命令（在 map 命令的参数前加负号）。例如，`-map -0:a:0`，忽略第一个文件中的第一个音频流。
+<!--rehype:className=wrap-text -->
+
 ### 切换容器(转换类型)
-<!--rehype:wrap-class=row-span-2-->
 
 将容器从 `MKV` 更改为 `MP4`
 
@@ -314,22 +358,54 @@ $ ffmpeg -i input.mov -itsoffset 3 -i input.mov -map 1:v -map 0:a -codec:a copy
 ```
 <!--rehype:className=wrap-text -->
 
-
 ### 图片中的视频
 
-如果您有多个编号的图像 image1.jpg、image2.jpg... 像这样从它们创建一个视频
-
 ```bash
 $ ffmpeg -f image2 -i image%d.jpg video.mp4
 ```
 <!--rehype:className=wrap-text -->
 
+多个编号的图像 image1.jpg、image2.jpg... 像这样从它们创建一个视频
+
 ### 将视频拆分为图像
 
 ```bash
 $ ffmpeg -i video.mp4 image%d.jpg
 ```
 
+### 录屏
+<!--rehype:wrap-class=col-span-2 row-span-2-->
+
+#### 查找所有可用设备
+
+```bash
+$ ffmpeg -f avfoundation -list_devices true -i ""
+```
+<!--rehype:className=wrap-text -->
+
+<span style="color:red">一定要选择好设备，根据设备进行配置。</sapn>
+
+#### windows 下录屏
+
+```bash
+$ ffmpeg -hide_banner -loglevel error -stats -f gdigrab -framerate 60 \
+-offset_x 0 -offset_y 0 -video_size 1920x1080 -draw_mouse 1 -i deskop \
+-c:v libx264 -r 60 -preset ultrafast -pix_fmt yuv420p -y screen_record.mp4
+```
+
+#### mac 下录屏
+
+```bash
+$ ffmpeg -f avfoundation -i 1:0 -preset ultrafast out.mkv
+```
+
+### 将输入文件转码为 DVD PAL 格式
+
+```bash
+$ ffmpeg -y -threads 8 -i inFile -target pal-dvd -ac 2 -aspect 16:9 -acodec mp2 -ab 224000 -vf pad=0:­0:0:0 outFile
+```
+<!--rehype:className=wrap-text -->
+
 ### 转换为 Gif
 <!--rehype:wrap-class=col-span-2 row-span-3-->
 
@@ -349,27 +425,24 @@ $ ffmpeg -i input.gif output.mov
 $ ffmpeg -i input.mov -codec:v copy -codec:a copy output.mp4
 ```
 
-### 移除音频
-
-```bash
-$ ffmpeg -i input.mov -codec:v copy -an output.mov
-```
-<!--rehype:className=wrap-text -->
-
-### 将输入文件转码为 DVD PAL 格式
-
-```bash
-$ ffmpeg -y -threads 8 -i inFile -target pal-dvd -ac 2 -aspect 16:9 -acodec mp2 -ab 224000 -vf pad=0:­0:0:0 outFile
-```
-<!--rehype:className=wrap-text -->
-
-
 ### 转换为灰度
 
 ```bash
 $ ffmpeg -y -i inFile -flags gray outFile
 ```
 
+### 字幕格式转换
+
+```bash
+# srt -> ass
+$ ffmpeg -i subtitle.srt subtitle.ass
+# ass -> vtt
+$ ffmpeg -i subtitle.ass subtitle.vtt
+```
+
+srt、ass、vtt 等格式之间可以相互转换
+
+<!--rehype:className=wrap-text -->
 
 ### 字幕
 <!--rehype:wrap-class=col-span-2 row-span-2-->
@@ -494,6 +567,93 @@ $ ffmpeg -i audioS.mp4 -i videoS.mp4 -c copy -map 0:a -map 1:v outFil­e.mp4
 ```
 <!--rehype:className=wrap-text -->
 
+### 合并视频
+
+<!--rehype:wrap-class=col-span-2 row-span-3-->
+
+合并相同规格(解码/分辨率/帧率)视频
+
+```bash
+# mylist.txt >>>
+file '1.mp4'
+file '2.mp4'
+file '3.mp4'
+
+# 这些文件是相对路径，如使用绝对路径需要添加 `-safe 0` 参数
+$ ffmpeg -f concat -i mylist.txt -c copy output.mp4
+```
+<!--rehype:className=wrap-text -->
+
+合并当前目录下所有视频
+
+```bash
+$ ffmpeg -f concat -safe 0 -i <(for f in ./*.mp4; do echo "file '$PWD/$f'"; done) -c copy output.mp4
+```
+<!--rehype:className=wrap-text -->
+
+合并不同规格视频，保证视频不变形
+
+```bash
+$ ffmpeg -i 1.mp4 -c copy -bsf:v h264_mp4toannexb -f mpegts tmp1.ts
+$ ffmpeg -i 2.mp4 -c copy -bsf:v h264_mp4toannexb -f mpegts tmp2.ts
+$ ffmpeg -i 3.mp4 -c copy -bsf:v h264_mp4toannexb -f mpegts tmp3.ts
+
+$ ffmpeg -threads 2 -i "concat:tmp1.ts|tmp2.ts|tmp3.ts"  -vf "scale=720:1080:force_original_aspect_ratio=decrease,pad=720:1080:(ow-iw)/2:(oh-ih)/2" -pix_fmt yuvj420p -shortest -y output.mp4
+```
+<!--rehype:className=wrap-text -->
+
+合并不同解码视频
+
+```bash
+$ ffmpeg -i input1.mp4 -i input2.webm -i input3.mov \
+-filter_complex "[0:v:0][0:a:0][1:v:0][1:a:0][2:v:0][2:a:0]concat=n=3:v=1:a=1[outv][outa]" \
+-map "[outv]" -map "[outa]" output.mkv
+```
+<!--rehype:className=wrap-text -->
+
+合并视频并重新编码音频
+
+```bash
+$ ffmpeg -f concat -i mylist.txt -c:v copy -c:a flac -strict -2 output.mp4
+```
+<!--rehype:className=wrap-text -->
+
+### 合并音频与图片
+
+合并多个音频，自定义背景图片，生成视频音乐
+
+```bash
+# mylist.txt >>>
+file '1.mp3'
+file '2.mp3'
+file '3.mp3'
+
+# OBS: 46500 = 25:50 minutes * 60 * 30fps
+# echo "00:25:50" | awk -F: '{ print (($1 * 3600) + ($2 * 60) + $3) * 30 }'
+$ ffmpeg -y -loop 1 -i cover.jpg -f concat -i mylist.txt -c:v libx264 -r 30 -pix_fmt yuv420p -vframes 46500 -c:a aac -b:a 192k -strict experimental -shortest output.mp4
+```
+<!--rehype:className=wrap-text -->
+
+### 添加水印
+
+在视频左上方 20,20 的位置插入 logo.png 图片
+
+```bash
+# -b:v 548k 可选参数，设置视频比特率，默认 200k 最好设置与原视频一致
+ffmpeg -i 1.mp4 -acodec copy -b:v 548k -vf "movie=logo.png[watermark];[in][watermark]overlay=20:20" output.mp4
+```
+<!--rehype:className=wrap-text -->
+
+### 去除水印
+
+设置一个矩形覆盖区域 x=10:y=10:w=120:h=45
+
+```bash
+# show=1 为可选参数，设置显示边框，方便调试用的
+ffmpeg -i 1.mp4 -b:v 548k -vf delogo=x=10:y=10:w=120:h=45:show=1 output.mp4
+```
+<!--rehype:className=wrap-text -->
+
 另见
 ---
 

docs/find.md

@@ -39,7 +39,6 @@ $ find . -name "json_*"
 | `-mindepth` | find / -mindepth 3 -maxdepth 5 -name pass | 在子目录级别 2 和 4 之间 |
 <!--rehype:className=show-header-->
 
-
 ### 类型
 
 |           |                      |
@@ -224,7 +223,6 @@ $ find . -type d -empty
 $ find . -type f -empty -delete
 ```
 
-
 查找日期和时间
 -------------
 

docs/git.md

@@ -374,15 +374,20 @@ Git 技巧
 ### 重命名分支
 
 - **重命名**为`new`
+
   ```shell
   $ git branch -m <new>
   $ git branch -m <old> <new> #重命名分支  
   ```
+
 - **推送**并重置
+
   ```shell
   $ git push origin -u <new>
   ```
+
 - **删除**远程分支
+
   ```shell
   $ git push origin --delete <old> #方法1
   $ git push origin :oldBranchName #方法2
@@ -827,7 +832,6 @@ $ git config --global --unset http.https://github.com.proxy
 $ git config --global --unset https.https://github.com.proxy
 ```
 
-
 ### clone 最新一次提交
 
 ```bash

docs/github-actions.md

@@ -212,6 +212,7 @@ jobs:
 ```shell
 jobs.<job_id>.environment
 ```
+
 使用单一环境名称的示例
 
 ```yml
@@ -251,7 +252,6 @@ steps:
 
 设置环境变量的示例
 
-
 ```yml
 env:
   MY_ENV_VAR: ${{ <expression> }}

docs/gmail.md

@@ -86,7 +86,6 @@ Gmail 快捷键
 `g` 然后 `k` | 前往任务
 <!--rehype:className=shortcuts-->
 
-
 ### Gmail 主题列表选择
 
 :- | :-

docs/golang.md

@@ -89,7 +89,7 @@ Golang 基本类型
 s1 := "Hello" + "World"
 s2 := `A "raw" string literal
 can include line breaks.`
-// 输出：11
+// 输出：10
 fmt.Println(len(s1))
 // 输出：Hello
 fmt.Println(string(s1[0:5]))
@@ -247,7 +247,6 @@ s := strconv.Itoa(i)
 fmt.Println(s) // Outputs: 90
 ```
 
-
 Golang 字符串
 --------
 
@@ -317,7 +316,7 @@ func main() {
 ### 函数实例
 
 | 实例                          | Result      |
-|-------------------------------|-------------|
+| ----------------------------- | ----------- |
 | Contains("test", "es")        | true        |
 | Count("test", "t")            | 2           |
 | HasPrefix("test", "te")       | true        |
@@ -569,6 +568,7 @@ sum(nums...)  // => [1 2 3 4] 10
 ```go
 import --> const --> var --> init()
 ```
+
 ---
 
 ```go
@@ -725,7 +725,7 @@ func main() {
 ### WaitGroup
 <!--rehype:wrap-class=row-span-2-->
 
-```golang
+```go
 package main
 import (
         "fmt"
@@ -916,6 +916,7 @@ func main() {
 -------------
 
 ### 关键字(Keywords)
+
 - break
 - default
 - func
@@ -956,6 +957,7 @@ func main() {
 
 另见
 --------
+
 - [Devhints](https://devhints.io/go) _(devhints.io)_
 - [A tour of Go](https://tour.golang.org/welcome/1) _(tour.golang.org)_
 - [Golang wiki](https://github.com/golang/go/wiki/) _(github.com)_

docs/graphql.md

@@ -0,0 +1,653 @@
+GraphQL 备忘清单
+===
+
+这份快速参考备忘单提供了 [GraphQL](https://graphql.org/) 的简要概述
+
+入门
+---
+
+### 概述
+
+- RESTful API 的另一种方法
+- GraphQL 是一种 API 查询语言
+- 使用清晰的共享术语轻松描述 GraphQL API 的形状。
+- 客户端发出查询/突变以读取和更新数据
+- GraphQL 语法可以表达复杂的实体关系
+- 用 [不同语言](https://graphql.org/code/) 实现 GraphQL 的库
+
+[GraphQL](https://graphql.org/)
+
+### Schema
+
+:-|-
+:-|-
+`schema`       | GraphQL 架构定义
+`query`        | 读取和遍历数据
+`mutation`     | 修改数据或触发动作
+`subscription` | 发生事件时运行查询
+
+### 内置标量类型
+
+:-|-
+:-|-
+`Int`     | 有符号 32 位整数
+`Float`   | 有符号双精度浮点值
+`String`  | UTF-8 字符序列
+`Boolean` | 对或错布尔值类型
+`ID`      | 唯一标识符
+
+### 类型定义
+
+:-|-
+:-|-
+`scalar`    | 标量类型
+`type`      | 对象类型
+`interface` | 接口类型
+`union`     | 联合类型
+`enum`      | 枚举类型
+`input`     | 输入对象类型
+
+### 类型修饰符
+
+:-|-
+:-|-
+`String`     | 可空字符串
+`String!`    | 非空字符串
+`[String]`   | 可空字符串列表
+`[String]!`  | 可空字符串的非空列表
+`[String!]!` | 非空字符串的非空列表
+
+### 输入参数
+<!--rehype:wrap-class=row-span-2-->
+
+#### 基本输入
+
+```graphql
+type Query {
+  users(limit: Int): [User]
+}
+```
+
+#### 输入默认值
+
+```graphql
+type Query {
+  users(limit: Int = 10): [User]
+}
+```
+
+#### 具有多个参数的输入
+
+```graphql
+type Query {
+  users(limit: Int, sort: String): [User]
+}
+```
+
+#### 具有多个参数和默认值的输入
+
+```graphql
+type Query {
+  users(limit: Int = 10, sort: String): [User]
+}
+type Query {
+  users(limit: Int, sort: String = "asc"): [User]
+}
+type Query {
+  users(limit: Int = 10, sort: String = "asc"): [User]
+}
+```
+<!--rehype:className=wrap-text -->
+
+### 输入类型
+
+```graphql
+input ListUsersInput {
+  limit: Int
+  since_id: ID
+}
+```
+
+```graphql
+type Mutation {
+  users(params: ListUsersInput): [User]!
+}
+```
+
+### 自定义标量
+
+```graphql
+scalar Url
+type User {
+  name: String
+  homepage: Url
+}
+```
+
+### 接口
+
+```graphql
+interface Foo {
+  is_foo: Boolean
+}
+interface Goo {
+  is_goo: Boolean
+}
+type Bar implements Foo {
+  is_foo: Boolean
+  is_bar: Boolean
+}
+type Baz implements Foo, Goo {
+  is_foo: Boolean
+  is_goo: Boolean
+  is_baz: Boolean
+}
+```
+
+实现一个或多个接口的对象
+
+### 联合
+
+```graphql
+type Foo {
+  name: String
+}
+type Bar {
+  is_bar: String
+}
+union SingleUnion = Foo
+union MultipleUnion = Foo | Bar
+type Root {
+  single: SingleUnion
+  multiple: MultipleUnion
+}
+```
+
+一个或多个对象的联合
+
+### 枚举
+
+```graphql
+enum USER_STATE {
+  NOT_FOUND
+  ACTIVE
+  INACTIVE
+  SUSPENDED
+}
+type Root {
+  stateForUser(userID: ID!): USER_STATE!
+  users(state: USER_STATE, limit: Int = 10): [User]
+}
+```
+<!--rehype:className=wrap-text -->
+
+查询和变更(Mutations)
+---
+
+### 字段
+
+```graphql
+{
+  hero {
+    name
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "hero": {
+      "name": "R2-D2"
+    }
+  }
+}
+```
+
+### 查询可以有注释
+
+```graphql
+{
+  hero {
+    name
+    # 查询可以有注释！
+    friends {
+      name
+    }
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "hero": {
+      "name": "R2-D2",
+      "friends": [
+        { "name": "Luke Skywalker" },
+        { "name": "Han Solo" }
+      ]
+    }
+  }
+}
+```
+
+### 参数 Arguments
+
+```graphql
+{
+  human(id: "1000") {
+    name
+    height
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "human": {
+      "name": "Luke Skywalker",
+      "height": 1.72
+    }
+  }
+}
+```
+
+### 不同类型的参数
+
+```graphql
+{
+  human(id: "1000") {
+    name
+    height(unit: FOOT)
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "human": {
+      "name": "Luke Skywalker",
+      "height": 5.6430448
+    }
+  }
+}
+```
+
+### 别名(Aliases)
+
+```graphql
+{
+  empireHero: hero(episode: EMPIRE) {
+    name
+  }
+  jediHero: hero(episode: JEDI) {
+    name
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "empireHero": {
+      "name": "Luke Skywalker"
+    },
+    "jediHero": {
+      "name": "R2-D2"
+    }
+  }
+}
+```
+
+### 片段(Fragments)
+<!--rehype:wrap-class=row-span-2-->
+
+```graphql
+{
+  leftComparison: hero(episode: EMPIRE) {
+    ...comparisonFields
+  }
+  rightComparison: hero(episode: JEDI) {
+    ...comparisonFields
+  }
+}
+​
+fragment comparisonFields on Character {
+  name
+  appearsIn
+  friends {
+    name
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "leftComparison": {
+      "name": "Luke Skywalker",
+      "appearsIn": [
+        "NEWHOPE",
+        "EMPIRE",
+        "JEDI"
+      ],
+      "friends": [
+        { "name": "Han Solo" },
+        { "name": "Leia Organa" },
+        { "name": "C-3PO" },
+        { "name": "R2-D2" }
+      ]
+    },
+    "rightComparison": {
+      "name": "R2-D2",
+      "appearsIn": [
+        "NEWHOPE",
+        "EMPIRE",
+        "JEDI"
+      ],
+      "friends": [
+        { "name": "Luke Skywalker" },
+        { "name": "Han Solo" },
+        { "name": "Leia Organa" }
+      ]
+    }
+  }
+}
+```
+
+### 在片段内使用变量
+<!--rehype:wrap-class=row-span-3-->
+
+```graphql
+query HeroComparison($first: Int = 3) {
+  leftComparison: hero(episode: EMPIRE) {
+    ...comparisonFields
+  }
+  rightComparison: hero(episode: JEDI) {
+    ...comparisonFields
+  }
+}
+​
+fragment comparisonFields on Character {
+  name
+  friendsConnection(first: $first) {
+    totalCount
+    edges {
+      node {
+        name
+      }
+    }
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "leftComparison": {
+      "name": "Luke Skywalker",
+      "friendsConnection": {
+        "totalCount": 4,
+        "edges": [
+          {
+            "node": {
+              "name": "Han Solo"
+            }
+          },
+          {
+            "node": {
+              "name": "Leia Organa"
+            }
+          }
+        ]
+      }
+    },
+    "rightComparison": {
+      "name": "R2-D2",
+      "friendsConnection": {
+        "totalCount": 3,
+        "edges": [
+          {
+            "node": {
+              "name": "Luke Skywalker"
+            }
+          },
+          {
+            "node": {
+              "name": "Han Solo"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+### 操作名称(Operation name)
+
+```graphql
+query HeroNameAndFriends {
+  hero {
+    name
+    friends {
+      name
+    }
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "hero": {
+      "name": "R2-D2",
+      "friends": [
+        { "name": "Luke Skywalker" },
+        { "name": "Han Solo" },
+        { "name": "Leia Organa" }
+      ]
+    }
+  }
+}
+```
+
+### 变量(Variables)
+
+```graphql
+# { "graphiql": true, "variables": { "episode": JEDI } }
+query HeroNameAndFriends($episode: Episode) {
+  hero(episode: $episode) {
+    name
+    friends {
+      name
+    }
+  }
+}
+```
+<!--rehype:className=wrap-text -->
+
+变量前缀必须为 `$`，后跟其类型
+
+### 默认变量(Default variables)
+
+```graphql
+query HeroNameAndFriends($episode: Episode = "JEDI") {
+  hero(episode: $episode) {
+    name
+    friends {
+      name
+    }
+  }
+}
+```
+<!--rehype:className=wrap-text -->
+
+### 指令(Directives)
+
+```graphql
+query Hero($episode: Episode, $withFriends: Boolean!) {
+  hero(episode: $episode) {
+    name
+    friends @include(if: $withFriends) {
+      name
+    }
+  }
+}
+```
+<!--rehype:className=wrap-text -->
+
+----
+
+```graphql
+{ "episode": "JEDI", "withFriends": false }
+```
+
+结果:
+
+```json
+{
+  "data": { "hero": { "name": "R2-D2" } }
+}
+```
+
+- `@include(if: Boolean)` 仅在参数为 `true` 时，包含此字段
+- `@skip(if: Boolean)` 如果参数为 `true`，跳过此字段
+
+### 变更(Mutations)
+
+```graphql
+mutation CreateReviewForEpisode($ep: Episode!, $review: ReviewInput!) {
+  createReview(episode: $ep, review: $review) {
+    stars
+    commentary
+  }
+}
+```
+<!--rehype:className=wrap-text -->
+
+----
+
+```
+{
+  "ep": "JEDI",
+  "review": {
+    "stars": 5,
+    "commentary": "This is a great movie!"
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "createReview": {
+      "stars": 5,
+      "commentary": "This is a great movie!"
+    }
+  }
+}
+```
+
+### 内联片段(Inline Fragments)
+
+```graphql
+query HeroForEpisode($ep: Episode!) {
+  hero(episode: $ep) {
+    name
+    ... on Droid {
+      primaryFunction
+    }
+    ... on Human {
+      height
+    }
+  }
+}
+```
+
+----
+
+```graphql
+{ "ep": "JEDI" }
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "hero": {
+      "name": "R2-D2",
+      "primaryFunction": "Astromech"
+    }
+  }
+}
+```
+
+### 元字段(Meta fields)
+
+```graphql
+{
+  search(text: "an") {
+    __typename
+    ... on Human {
+      name
+    }
+    ... on Droid {
+      name
+    }
+    ... on Starship {
+      name
+    }
+  }
+}
+```
+
+结果:
+
+```json
+{
+  "data": {
+    "search": [
+      {
+        "__typename": "Human",
+        "name": "Han Solo"
+      },
+      {
+        "__typename": "Human",
+        "name": "Leia Organa"
+      },
+      {
+        "__typename": "Starship",
+        "name": "TIE Advanced x1"
+      }
+    ]
+  }
+}
+```
+
+另见
+-------
+
+- [GraphQL Schema Language Cheat Sheet](https://github.com/sogko/graphql-schema-language-cheat-sheet) _(github.com)_

docs/grep.md

@@ -3,7 +3,6 @@ Grep 备忘清单
 
 本备忘单旨在快速提醒使用命令行程序 grep 所涉及的主要概念，并假设您已经了解其用法。
 
-
 入门
 ------
 <!--rehype:body-class=cols-5-->
@@ -31,7 +30,6 @@ $ grep 'mellon' myfile.txt
 
 文件名中接受通配符。
 
-
 ### 选项示例
 <!--rehype:wrap-class=col-span-3-->
 
@@ -51,7 +49,6 @@ $ grep 'mellon' myfile.txt
 | `-o`   | grep -o search_string filename        | 只显示字符串的匹配部分
 | `-n`   | grep -n "go" demo.txt                 | 显示匹配的行号
 
-
 Grep 正则表达式
 -------
 
@@ -97,7 +94,6 @@ Grep 正则表达式
 `[0-9]`       | 任何数字
 `[0-9­A-Z­a-z]` | 任何大小写字母或数字
 
-
 ### 位置
 
 :- | :-

docs/html-char.md

@@ -3,7 +3,6 @@ HTML 字符实体备忘清单
 
 此备忘清单是 HTML 实体及其编号和名称的完整列表。还包括可以用 HTML 表示的 ASCII 字符的完整列表。
 
-
 HTML 字符实体引用
 ------
 <!--rehype:body-class=cols-1-->

docs/html.md

@@ -43,6 +43,7 @@ HTML 备忘清单
 <p>我来自快速参考</p>
 <p>分享快速参考备忘单。</p>
 ```
+
 请参阅：[段落元素](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/p)
 
 ### HTML 链接
@@ -68,8 +69,6 @@ HTML 备忘清单
 
 请参阅：[\<a> 属性](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/a#attributes)
 
-
-
 ### Image 标签
 
 ```html
@@ -163,10 +162,8 @@ HTML 备忘清单
   src="https://www.openstreetmap.org/export/embed.html?bbox=-0.004017949104309083%2C51.47612752641776%2C0.00030577182769775396%2C51.478569861898606&layer=mapnik">
 </iframe>
 
-
 请参阅：[内联框架元素](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/iframe)
 
-
 ### HTML 中的 JavaScript
 
 ```html
@@ -176,7 +173,6 @@ HTML 备忘清单
 </script>
 ```
 
-
 #### 外部 JavaScript
 
 ```html
@@ -186,7 +182,6 @@ HTML 备忘清单
 </body>
 ```
 
-
 ### HTML 中的 CSS
 
 ```html
@@ -206,8 +201,6 @@ HTML 备忘清单
 </head>
 ```
 
-
-
 HTML5 标签
 -------------
 
@@ -227,7 +220,6 @@ HTML5 标签
 </body>
 ```
 
-
 ### 标题导航
 
 ```html
@@ -242,7 +234,6 @@ HTML5 标签
 </header>
 ```
 
-
 ### HTML5 Tags
 <!--rehype:wrap-class=row-span-4-->
 
@@ -281,7 +272,6 @@ HTML5 标签
 [video](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/video)           | 嵌入视频
 [wbr](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/wbr)               | 换行机会
 
-
 ### HTML5 Video
 
 ```html
@@ -339,7 +329,6 @@ HTML5 标签
   音 <rp>(</rp><rt>yīn</rt><rp>)</rp>
 </ruby>
 
-
 ### HTML5 kdi
 
 ```html
@@ -358,7 +347,6 @@ HTML5 标签
  <li>User <bdi>إيان</bdi>: 90 points</li>
 </ul>
 
-
 ### HTML5 progress
 
 ```html
@@ -375,7 +363,6 @@ HTML5 标签
 
 <p>我爱<mark>备忘清单</mark></p>
 
-
 HTML 表格
 --------------
 
@@ -517,7 +504,6 @@ HTML 表单
   <label for="ck">记住我</label>
 </form>
 
-
 HTML `<form>` 元素用于收集信息并将其发送到外部源。
 
 ### Form 属性
@@ -602,13 +588,16 @@ Textarea 是一个多行文本输入控件
 单选按钮用于让用户只选择一个
 
 ### Checkboxes
+
 ```html
 <input type="checkbox" name="s" id="soc">
 <label for="soc">Soccer</label>
 <input type="checkbox" name="s" id="bas">
 <label for="bas">Baseball</label>
 ```
+
 #### ↓ 预览
+
 <form style="padding: 20px;">
     <input type="checkbox" name="sports" id="soccer">
     <label for="soccer">Soccer</label>
@@ -718,7 +707,6 @@ Textarea 是一个多行文本输入控件
 
 `将数据提交到服务器` 重置为默认值
 
-
 HTML input 标签
 -----------
 <!--rehype:body-class=cols-2-->
@@ -732,7 +720,7 @@ HTML input 标签
 <input type="text" name="?" value="?" minlength="6"  required />
 ```
 
-----
+---
 
 :-|:-
 :-|:-
@@ -794,7 +782,6 @@ HTML input 标签
 | `type="search"`         | <input type="search">                |
 | `type="range"`          | <input type="range">                 |
 
-
 ### Input CSS 选择器
 
 |               |                  |
@@ -820,6 +807,7 @@ meta 标记描述 HTML 文档中的元数据。它解释了关于 HTML 的其他
 <meta property="og:title"  content="···">
 <meta name="twitter:title" content="···">
 ```
+
 ---
 
 ```html
@@ -828,6 +816,7 @@ meta 标记描述 HTML 文档中的元数据。它解释了关于 HTML 的其他
 <meta property="og:url"  content="https://···">
 <meta name="twitter:url" content="https://···">
 ```
+
 ---
 
 ```html
@@ -836,6 +825,7 @@ meta 标记描述 HTML 文档中的元数据。它解释了关于 HTML 的其他
 <meta property="og:description"  content="···">
 <meta name="twitter:description" content="···">
 ```
+
 ---
 
 ```html
@@ -843,12 +833,14 @@ meta 标记描述 HTML 文档中的元数据。它解释了关于 HTML 的其他
 <meta property="og:image"  content="https://···">
 <meta name="twitter:image" content="https://···">
 ```
+
 ---
 
 ```html
 <!-- ua -->
 <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
 ```
+
 ---
 
 ```html

docs/http-status-code.md

@@ -17,63 +17,63 @@ HTTP 状态码
 ### 2xx. 成功的
 <!--rehype:wrap-class=row-span-2-->
 
-* [200: OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) _请求没问题_<!--rehype:tooltips-->
-* [201: Created](https://tools.ietf.org/html/rfc7231#section-6.3.2) _请求完成，并创建了一个新资源_<!--rehype:tooltips-->
-* [202: Accepted](https://tools.ietf.org/html/rfc7231#section-6.3.3) _接受请求进行处理，但处理未完成_<!--rehype:tooltips-->
-* [203: Non-Authoritative Information](https://tools.ietf.org/html/rfc7231#section-6.3.4) _实体标头中的信息来自本地或第三方副本，而不是来自原始服务器_<!--rehype:tooltips-->
-* [204: No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) _响应中给出了状态码和标头，但响应中没有实体主体_<!--rehype:tooltips-->
-* [205: Reset Content](https://tools.ietf.org/html/rfc7231#section-6.3.6) _浏览器应清除用于此事务的表单以获取其他输入_<!--rehype:tooltips-->
-* [206: Partial Content](https://tools.ietf.org/html/rfc7233#section-4.1) _服务器正在返回请求大小的部分数据。 用于响应指定 Range 标头的请求。 服务器必须使用 Content-Range 标头指定响应中包含的范围_<!--rehype:tooltips-->
+- [200: OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) _请求没问题_<!--rehype:tooltips-->
+- [201: Created](https://tools.ietf.org/html/rfc7231#section-6.3.2) _请求完成，并创建了一个新资源_<!--rehype:tooltips-->
+- [202: Accepted](https://tools.ietf.org/html/rfc7231#section-6.3.3) _接受请求进行处理，但处理未完成_<!--rehype:tooltips-->
+- [203: Non-Authoritative Information](https://tools.ietf.org/html/rfc7231#section-6.3.4) _实体标头中的信息来自本地或第三方副本，而不是来自原始服务器_<!--rehype:tooltips-->
+- [204: No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) _响应中给出了状态码和标头，但响应中没有实体主体_<!--rehype:tooltips-->
+- [205: Reset Content](https://tools.ietf.org/html/rfc7231#section-6.3.6) _浏览器应清除用于此事务的表单以获取其他输入_<!--rehype:tooltips-->
+- [206: Partial Content](https://tools.ietf.org/html/rfc7233#section-4.1) _服务器正在返回请求大小的部分数据。 用于响应指定 Range 标头的请求。 服务器必须使用 Content-Range 标头指定响应中包含的范围_<!--rehype:tooltips-->
 
 ### 4xx. 客户端错误
 <!--rehype:wrap-class=row-span-3-->
 
-* [400: Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1) _服务器不理解该请求_<!--rehype:tooltips-->
-* [401: Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1) _请求的页面需要用户名和密码_<!--rehype:tooltips-->
-* [402: Payment Required](https://tools.ietf.org/html/rfc7231#section-6.5.2) _您还不能使用此代码_<!--rehype:tooltips-->
-* [403: Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3) _禁止访问请求的页面_<!--rehype:tooltips-->
-* [404: Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4) _服务器找不到请求的页面_<!--rehype:tooltips-->
-* [405: Method Not Allowed](https://tools.ietf.org/html/rfc7231#section-6.5.5) _请求中指定的方法是不允许的_<!--rehype:tooltips-->
-* [406: Not Acceptable](https://tools.ietf.org/html/rfc7231#section-6.5.6) _服务器只能生成客户端不接受的响应_<!--rehype:tooltips-->
-* [407: Proxy Authentication Required](https://tools.ietf.org/html/rfc7235#section-3.2) _您必须先通过代理服务器进行身份验证，然后才能提供此请求_<!--rehype:tooltips-->
-* [408: Request Timeout](https://tools.ietf.org/html/rfc7231#section-6.5.7) _请求花费的时间比服务器准备等待的时间长_<!--rehype:tooltips-->
-* [409: Conflict](https://tools.ietf.org/html/rfc7231#section-6.5.8) _由于冲突，请求无法完成_<!--rehype:tooltips-->
-* [410: Gone](https://tools.ietf.org/html/rfc7231#section-6.5.9) _请求的页面不再可用_<!--rehype:tooltips-->
-* [411: Length Required](https://tools.ietf.org/html/rfc7231#section-6.5.10) _“Content-Length”未定义。 没有它，服务器将不会接受请求_<!--rehype:tooltips-->
-* [412: Precondition Failed](https://tools.ietf.org/html/rfc7232#section-4.2) _请求中给出的前提条件被服务器评估为 false_<!--rehype:tooltips-->
-* [413: Payload Too Large](https://tools.ietf.org/html/rfc7231#section-6.5.11) _服务器不会接受请求，因为请求实体太大_<!--rehype:tooltips-->
-* [414: URI Too Long](https://tools.ietf.org/html/rfc7231#section-6.5.12) _服务器不会接受请求，因为 url 太长。 当您将“发布”请求转换为具有长查询信息的“获取”请求时发生_<!--rehype:tooltips-->
-* [415: Unsupported Media Type](https://tools.ietf.org/html/rfc7231#section-6.5.13) _服务器不会接受请求，因为不支持媒体类型_<!--rehype:tooltips-->
-* [416: Range Not Satisfiable](https://tools.ietf.org/html/rfc7233#section-4.4) _请求的字节范围不可用且超出范围_<!--rehype:tooltips-->
-* [417: Expectation Failed](https://tools.ietf.org/html/rfc7231#section-6.5.14) _此服务器无法满足在 Expect 请求标头字段中给出的期望_<!--rehype:tooltips-->
-* [426: Upgrade Required](https://tools.ietf.org/html/rfc7231#section-6.5.15) _服务器拒绝使用当前协议执行请求，但在客户端升级到不同协议后可能愿意这样做_<!--rehype:tooltips-->
-* [451: Unavailable For Legal Reasons](https://datatracker.ietf.org/doc/html/rfc7725#section-3) _此状态代码表示服务器拒绝访问资源作为法律要求的结果_<!--rehype:tooltips-->
+- [400: Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1) _服务器不理解该请求_<!--rehype:tooltips-->
+- [401: Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1) _请求的页面需要用户名和密码_<!--rehype:tooltips-->
+- [402: Payment Required](https://tools.ietf.org/html/rfc7231#section-6.5.2) _您还不能使用此代码_<!--rehype:tooltips-->
+- [403: Forbidden](https://tools.ietf.org/html/rfc7231#section-6.5.3) _禁止访问请求的页面_<!--rehype:tooltips-->
+- [404: Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4) _服务器找不到请求的页面_<!--rehype:tooltips-->
+- [405: Method Not Allowed](https://tools.ietf.org/html/rfc7231#section-6.5.5) _请求中指定的方法是不允许的_<!--rehype:tooltips-->
+- [406: Not Acceptable](https://tools.ietf.org/html/rfc7231#section-6.5.6) _服务器只能生成客户端不接受的响应_<!--rehype:tooltips-->
+- [407: Proxy Authentication Required](https://tools.ietf.org/html/rfc7235#section-3.2) _您必须先通过代理服务器进行身份验证，然后才能提供此请求_<!--rehype:tooltips-->
+- [408: Request Timeout](https://tools.ietf.org/html/rfc7231#section-6.5.7) _请求花费的时间比服务器准备等待的时间长_<!--rehype:tooltips-->
+- [409: Conflict](https://tools.ietf.org/html/rfc7231#section-6.5.8) _由于冲突，请求无法完成_<!--rehype:tooltips-->
+- [410: Gone](https://tools.ietf.org/html/rfc7231#section-6.5.9) _请求的页面不再可用_<!--rehype:tooltips-->
+- [411: Length Required](https://tools.ietf.org/html/rfc7231#section-6.5.10) _“Content-Length”未定义。 没有它，服务器将不会接受请求_<!--rehype:tooltips-->
+- [412: Precondition Failed](https://tools.ietf.org/html/rfc7232#section-4.2) _请求中给出的前提条件被服务器评估为 false_<!--rehype:tooltips-->
+- [413: Payload Too Large](https://tools.ietf.org/html/rfc7231#section-6.5.11) _服务器不会接受请求，因为请求实体太大_<!--rehype:tooltips-->
+- [414: URI Too Long](https://tools.ietf.org/html/rfc7231#section-6.5.12) _服务器不会接受请求，因为 url 太长。 当您将“发布”请求转换为具有长查询信息的“获取”请求时发生_<!--rehype:tooltips-->
+- [415: Unsupported Media Type](https://tools.ietf.org/html/rfc7231#section-6.5.13) _服务器不会接受请求，因为不支持媒体类型_<!--rehype:tooltips-->
+- [416: Range Not Satisfiable](https://tools.ietf.org/html/rfc7233#section-4.4) _请求的字节范围不可用且超出范围_<!--rehype:tooltips-->
+- [417: Expectation Failed](https://tools.ietf.org/html/rfc7231#section-6.5.14) _此服务器无法满足在 Expect 请求标头字段中给出的期望_<!--rehype:tooltips-->
+- [426: Upgrade Required](https://tools.ietf.org/html/rfc7231#section-6.5.15) _服务器拒绝使用当前协议执行请求，但在客户端升级到不同协议后可能愿意这样做_<!--rehype:tooltips-->
+- [451: Unavailable For Legal Reasons](https://datatracker.ietf.org/doc/html/rfc7725#section-3) _此状态代码表示服务器拒绝访问资源作为法律要求的结果_<!--rehype:tooltips-->
 
 ### 1xx. 信息
 
-* [100: Continue](https://tools.ietf.org/html/rfc7231#section-6.2.1) _服务器只收到了请求的一部分，但只要没有被拒绝，客户端就应该继续请求_<!--rehype:tooltips-->
-* [101: Switching Protocols](https://tools.ietf.org/html/rfc7231#section-6.2.2) _服务器切换协议_<!--rehype:tooltips-->
-* [102: Processing](https://tools.ietf.org/html/rfc2518#section-10.1) _用于通知客户端服务器已接受完整请求但尚未完成的临时响应_<!--rehype:tooltips-->
+- [100: Continue](https://tools.ietf.org/html/rfc7231#section-6.2.1) _服务器只收到了请求的一部分，但只要没有被拒绝，客户端就应该继续请求_<!--rehype:tooltips-->
+- [101: Switching Protocols](https://tools.ietf.org/html/rfc7231#section-6.2.2) _服务器切换协议_<!--rehype:tooltips-->
+- [102: Processing](https://tools.ietf.org/html/rfc2518#section-10.1) _用于通知客户端服务器已接受完整请求但尚未完成的临时响应_<!--rehype:tooltips-->
 
 ### 3xx. 重定向
 
-* [300: Multiple Choices](https://tools.ietf.org/html/rfc7231#section-6.4.1) _一个链接列表。 用户可以选择一个链接并转到该位置。 最多五个地址_<!--rehype:tooltips-->
-* [301: Moved Permanently](https://tools.ietf.org/html/rfc7231#section-6.4.2) _请求的页面已移至新的 url_<!--rehype:tooltips-->
-* [302: Found](https://tools.ietf.org/html/rfc7231#section-6.4.3) _请求的页面已临时移动到新的 url_<!--rehype:tooltips-->
-* [303: See Other](https://tools.ietf.org/html/rfc7231#section-6.4.4) _请求的页面可以在不同的 url 下找到_<!--rehype:tooltips-->
-* [304: Not Modified](https://tools.ietf.org/html/rfc7232#section-4.1) _这是对 If-Modified-Since 或 If-None-Match 标头的响应代码，其中 URL 自指定日期以来未修改_<!--rehype:tooltips-->
-* [305: Use Proxy](https://tools.ietf.org/html/rfc7231#section-6.4.5) _请求的 URL 必须通过 Location 标头中提到的代理访问_<!--rehype:tooltips-->
-* [306: Unused](https://tools.ietf.org/html/rfc7231#section-6.4.6) _此代码在以前的版本中使用过。 它不再使用，但代码被保留_<!--rehype:tooltips-->
-* [307: Temporary Redirect](https://tools.ietf.org/html/rfc7231#section-6.4.7) _请求的页面已临时移动到新的 url_<!--rehype:tooltips-->
+- [300: Multiple Choices](https://tools.ietf.org/html/rfc7231#section-6.4.1) _一个链接列表。 用户可以选择一个链接并转到该位置。 最多五个地址_<!--rehype:tooltips-->
+- [301: Moved Permanently](https://tools.ietf.org/html/rfc7231#section-6.4.2) _请求的页面已移至新的 url_<!--rehype:tooltips-->
+- [302: Found](https://tools.ietf.org/html/rfc7231#section-6.4.3) _请求的页面已临时移动到新的 url_<!--rehype:tooltips-->
+- [303: See Other](https://tools.ietf.org/html/rfc7231#section-6.4.4) _请求的页面可以在不同的 url 下找到_<!--rehype:tooltips-->
+- [304: Not Modified](https://tools.ietf.org/html/rfc7232#section-4.1) _这是对 If-Modified-Since 或 If-None-Match 标头的响应代码，其中 URL 自指定日期以来未修改_<!--rehype:tooltips-->
+- [305: Use Proxy](https://tools.ietf.org/html/rfc7231#section-6.4.5) _请求的 URL 必须通过 Location 标头中提到的代理访问_<!--rehype:tooltips-->
+- [306: Unused](https://tools.ietf.org/html/rfc7231#section-6.4.6) _此代码在以前的版本中使用过。 它不再使用，但代码被保留_<!--rehype:tooltips-->
+- [307: Temporary Redirect](https://tools.ietf.org/html/rfc7231#section-6.4.7) _请求的页面已临时移动到新的 url_<!--rehype:tooltips-->
 
 ### 5xx. 服务器错误
 
-* [500: Internal Server Error](https://tools.ietf.org/html/rfc7231#section-6.6.1) _请求未完成。服务器遇到了意外情况_<!--rehype:tooltips-->
-* [501: Not Implemented](https://tools.ietf.org/html/rfc7231#section-6.6.2) _请求未完成。服务器不支持所需的功能_<!--rehype:tooltips-->
-* [502: Bad Gateway](https://tools.ietf.org/html/rfc7231#section-6.6.3) _请求未完成。服务器收到来自上游服务器的无效响应_<!--rehype:tooltips-->
-* [503: Service Unavailable](https://tools.ietf.org/html/rfc7231#section-6.6.4) _请求未完成。服务器暂时超载或停机_<!--rehype:tooltips-->
-* [504: Gateway Timeout](https://tools.ietf.org/html/rfc7231#section-6.6.5) _网关已超时_<!--rehype:tooltips-->
-* [505: HTTP Version Not Supported](https://tools.ietf.org/html/rfc7231#section-6.6.6) _服务器不支持“http 协议”版本_<!--rehype:tooltips-->
+- [500: Internal Server Error](https://tools.ietf.org/html/rfc7231#section-6.6.1) _请求未完成。服务器遇到了意外情况_<!--rehype:tooltips-->
+- [501: Not Implemented](https://tools.ietf.org/html/rfc7231#section-6.6.2) _请求未完成。服务器不支持所需的功能_<!--rehype:tooltips-->
+- [502: Bad Gateway](https://tools.ietf.org/html/rfc7231#section-6.6.3) _请求未完成。服务器收到来自上游服务器的无效响应_<!--rehype:tooltips-->
+- [503: Service Unavailable](https://tools.ietf.org/html/rfc7231#section-6.6.4) _请求未完成。服务器暂时超载或停机_<!--rehype:tooltips-->
+- [504: Gateway Timeout](https://tools.ietf.org/html/rfc7231#section-6.6.5) _网关已超时_<!--rehype:tooltips-->
+- [505: HTTP Version Not Supported](https://tools.ietf.org/html/rfc7231#section-6.6.6) _服务器不支持“http 协议”版本_<!--rehype:tooltips-->
 
 ### RESTful API
 

docs/iso-639-1.md

@@ -3,7 +3,6 @@ ISO 639-1 Language Code  备忘清单
 
 这是一个符合 ISO 639-1 标准的 ISO 语言代码列表，它为多语言网站提供参考。
 
-
 入门
 ----
 

docs/java.md

@@ -73,6 +73,7 @@ for (char c: word.toCharArray()) {
 }
 // 输出: Q-u-i-c-k-R-e-f-
 ```
+
 查看: [Loops](#java-循环)
 
 ### 数组 Arrays
@@ -85,6 +86,7 @@ String[] letters = {"A", "B", "C"};
 int[] mylist = {100, 200};
 boolean[] answers = {true, false};
 ```
+
 查看: [Arrays](#java-数组)
 
 ### Swap
@@ -127,9 +129,10 @@ if (j == 10) {
 }
 ```
 
-查看: [Conditionals](#java-conditionals)
+查看: [Conditionals](#条件语句 Conditionals)
 
 ### 用户输入
+
 ```java
 Scanner in = new Scanner(System.in);
 String str = in.nextLine();
@@ -175,48 +178,60 @@ StringBuilder sb = new StringBuilder(10);
 └───┴───┴───┴───┴───┴───┴───┴───┴───┘
 0   1   2   3   4   5   6   7   8   9
 ```
+
 ---
 
 ```java
 sb.append("Reference");
 ```
+
 ---
+
 ```java
 ┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
 | R | e | f | e | r | e | n | c | e |
 └───┴───┴───┴───┴───┴───┴───┴───┴───┘
 0   1   2   3   4   5   6   7   8   9
 ```
+
 ---
 
 ```java
 sb.delete(3, 9);
 ```
+
 ---
+
 ```java
 ┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
 | R | e | f |   |   |   |   |   |   |
 └───┴───┴───┴───┴───┴───┴───┴───┴───┘
 0   1   2   3   4   5   6   7   8   9
 ```
+
 ---
 
 ```java
 sb.insert(0, "My ");
 ```
+
 ---
+
 ```java
 ┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
 | M | y |   | R | e | f |   |   |   |
 └───┴───┴───┴───┴───┴───┴───┴───┴───┘
 0   1   2   3   4   5   6   7   8   9
 ```
+
 ---
 
 ```java
 sb.append("!");
 ```
+
 ---
+
 ```java
 ┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
 | M | y |   | R | e | f | ! |   |   |
@@ -370,7 +385,7 @@ Java 条件语句
 - `!` _(逻辑补码运算符；反转布尔值)_
 <!--rehype:className=style-round-->
 
-----
+---
 
 - `==` _(等于)_
 - `!=` _(不等于)_
@@ -380,19 +395,19 @@ Java 条件语句
 - `<=` _(小于或等于)_
 <!--rehype:className=cols-2 style-round-->
 
-----
+---
 
 - `&&` _条件与_
 - `||` _条件或_
 - [?:](#三元运算符) _三元(if-then-else 语句的简写)_
 <!--rehype:className=style-round-->
 
-----
+---
 
 - `instanceof` _(将对象与指定类型进行比较)_
 <!--rehype:className=style-round-->
 
-----
+---
 
 - `~` _(一元按位补码)_
 - `<<` _(签名左移)_
@@ -462,7 +477,7 @@ for (int i = 0; i < 10; i++) {
 // 输出: 0123456789
 ```
 
-------
+---
 
 ```java
 for (int i = 0,j = 0; i < 3; i++,j--) {

docs/javascript.md

@@ -54,7 +54,6 @@ count = 10;
 console.log(count); // => 10
 ```
 
-
 ### const 关键字
 
 ```javascript
@@ -238,11 +237,9 @@ parseFloat();
 parseInt();                 
 ```
 
-
 JavaScript 条件
 ----
 
-
 ### 操作符
 <!--rehype:wrap-class=row-span-3-->
 
@@ -273,7 +270,7 @@ true && false;       // false
 1 === '1'             // false
 ```
 
-#### 逻辑运算符 !
+#### 逻辑运算符
 
 ```javascript
 let lateToWork = true;
@@ -727,7 +724,6 @@ numbers.concat(newFirstNumber)
 
 如果你想避免改变你的原始数组，你可以使用 concat。
 
-
 ### 方法 .splice()
 
 ```javascript
@@ -1295,7 +1291,6 @@ class Song {
 }
 ```
 
-
 JavaScript Modules
 ----
 <!--rehype:body-class=cols-2-->

docs/jest.md

@@ -546,7 +546,6 @@ test('async test', () => {
 
 从你的测试中 _返回_ 一个 `Promise`
 
-
 ## 模拟
 
 ### 模拟函数
@@ -800,7 +799,6 @@ const fs = require('fs')
 const fs = require.requireActual('fs')
 ```
 
-
 数据驱动测试（Jest 23+）
 ----
 
@@ -886,7 +884,6 @@ test('第二个文本', () => {
 
 `Node.js` 和 `Jest` 会缓存你需要的模块。 要测试具有副作用的模块，您需要在测试之间重置模块注册表
 
-
 另见
 ----
 

docs/jq.md

@@ -0,0 +1,236 @@
+jq 备忘清单
+===
+
+这个快速参考备忘单提供了使用 [jq](https://stedolan.github.io/jq/) 命令的各种方法。
+
+入门
+----
+
+### 介绍
+
+jq 就像用于 JSON 数据的 [sed](./sed.md) - 您可以使用它来切片、过滤、映射和转换结构化数据
+
+- [jq 官网](https://stedolan.github.io/jq/) _(stedolan.github.io)_
+- [jq 命令使用](https://jaywcjlove.github.io/linux-command/c/jq.html) _(jaywcjlove.github.io)_
+
+安装
+
+```bash
+$ sudo apt-get install jq # Debian& Ubuntu
+$ sudo dnf install jq     # Fedora 
+$ sudo zypper install jq  # openSUSE
+$ sudo pacman -S jq    # Arch
+$ brew install jq      # macOS & Homebrew
+$ port install jq      # macOS & MacPorts
+```
+
+语法
+
+```bash
+$ jq [options] <jq filter> [file...]
+$ jq [options] --args <jq filter> [strings...]
+$ jq [options] --jsonargs <jq filter> [JSON_TEXTS...]
+```
+<!--rehype:className=wrap-text -->
+
+### 选项
+<!--rehype:wrap-class=col-span-2-->
+
+:- | -
+:- | -
+`-c`               | 紧凑而不是漂亮的输出
+`-n`               | 使用`null`作为单个输入值
+`-e`               | 根据输出设置退出状态代码
+`-s`               | 将所有输入读取（吸取）到数组中；应用过滤器
+`-r`               | 输出原始字符串，而不是JSON文本
+`-R`               | 读取原始字符串，而不是JSON文本
+`-C`               | 为 JSON 着色
+`-M`               | 单色（不要为JSON着色）
+`-S`               | 在输出上排序对象的键
+`--tab`            | 使用制表符进行缩进
+`--arg a v`        | 将变量 `$a` 设置为 value `<v>`
+`--argjson a v`    | 将变量 `$a` 设置为 JSON value `<v>`
+`--slurpfile a f`  | 将变量 `$a` 设置为从`<f>`读取的JSON文本数组
+`--rawfile a f`    | 将变量 `$a` 设置为包含`<f>`内容的字符串
+`--args`           | 其余参数是字符串参数，而不是文件
+`--jsonargs`       | 其余的参数是JSON参数，而不是文件
+`--`               | 终止参数处理
+
+学习示例
+---
+
+### 获取一个键的值
+
+```bash
+$ echo '{"foo": 42, "bar": "less interesting data"}' | jq '.foo'
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+42
+```
+
+### 数组运算
+
+```bash
+$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[1]'
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+{
+  "name": "XML",
+  "good": false
+}
+```
+
+### 构造一个数组/对象
+
+```bash
+$ echo '{"user":"stedolan","titles":["JQ Primer", "More JQ"]}' | jq '{user, title: .titles[]}'
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+{
+  "user": "stedolan",
+  "title": "JQ Primer"
+}
+{
+  "user": "stedolan",
+  "title": "More JQ"
+}
+```
+
+### 计算一个值的长度
+
+```bash
+$ echo '[[1,2], "string", {"a":2}, null]' | jq '.[] | length'              
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+2
+6
+1
+0
+```
+
+### 取出数组中的键
+
+```bash
+$ echo '{"abc": 1, "abcd": 2, "Foo": 3}' | jq 'keys'              
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+[
+  "Foo",
+  "abc",
+  "abcd"
+]
+```
+
+### 使用多个过滤器
+
+```bash
+$ echo '{ "foo": 42, "bar": "something else", "baz": true}' | jq '.foo, .bar' 
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+42
+"something else"
+```
+
+### 管道传递给下一个过滤器
+
+```bash
+$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name'     
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+"JSON"
+"XML"
+```
+
+### 条件语句判断
+
+```bash
+$ echo '[1,5,3,0,7]' | jq 'map(select(. >= 2))'        
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+[
+  5,
+  3,
+  7
+]
+```
+
+### 每个输入调用过滤器
+
+```bash
+$ echo '[1,2,3]' | jq 'map(.+1)'
+```
+
+输出结果
+
+```bash
+[
+  2,
+  3,
+  4
+]
+```
+
+### 条件判断
+
+```bash
+$ echo '2' | jq 'if . == 0 then "zero" elif . == 1 then "one" else "many" end'
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+"many"
+```
+
+### 字符串插入值并进行运算
+
+```bash
+$ echo '42' | jq '"The input was \(.), which is one less than \(.+1)"'
+```
+<!--rehype:className=wrap-text -->
+
+输出结果
+
+```bash
+"The input was 42, which is one less than 43"
+```
+<!--rehype:className=wrap-text -->
+
+另见
+----
+
+- [jq 官网](https://stedolan.github.io/jq/) _(stedolan.github.io)_
+- [jq 命令使用](https://jaywcjlove.github.io/linux-command/c/jq.html) _(jaywcjlove.github.io)_

docs/json.md

@@ -75,8 +75,8 @@ JSON 备忘清单
 ```json
 { "foo": 'bar' }
 ```
-Have to be delimited by double quotes
 
+Have to be delimited by double quotes
 
 ### 数字
 <!--rehype:wrap-class=row-span-2-->
@@ -297,6 +297,7 @@ let myArray = [
   }
 ];
 ```
+
 ----
 
 |                     |                            |
@@ -320,7 +321,7 @@ let myArray = [
 ];
 ```
 
------
+----
 
 |              |           |
 |--------------|-----------|
@@ -328,7 +329,6 @@ let myArray = [
 | `myArray[5]` | true      |
 | `myArray[6]` | undefined |
 
-
 另见
 ----
 

docs/koajs.md

@@ -3,7 +3,6 @@ Koajs 备忘清单
 
 基于 Node.js 平台的下一代 web 开发框架，包含 [Koa](https://koajs.com/) 的 API 参考列表和一些示例。
 
-
 入门
 ---
 
@@ -13,6 +12,7 @@ Koajs 备忘清单
 [Koa](https://koajs.com/) 需要 [node v7.6.0](https://nodejs.org) 或更高版本来支持ES2015、异步方法，你可以安装自己支持的 `node` 版本
 
 - 安装依赖
+
   ```bash
   $ mkdir myapp # 创建目录
   $ cd myapp    # 进入目录
@@ -20,7 +20,9 @@ Koajs 备忘清单
   $ npm init -y # 初始化一个配置
   $ npm install koa # 安装依赖
   ```
+
 - 入口文件 `index.js` 添加代码：
+
   ```js
   const Koa = require('koa');
   const app = new Koa();
@@ -31,7 +33,9 @@ Koajs 备忘清单
 
   app.listen(3000);
   ```
+
 - 使用以下命令运行应用程序
+
   ```bash
   $ node index.js
   ```

docs/lerna.md

@@ -199,7 +199,7 @@ $ lerna publish --canary preminor
 }
 ```
 
-----
+---
 
 :- | :-
 :- | :-
@@ -239,7 +239,7 @@ $ lerna version -m "chore(doc): publish %v"
 - `prerelease` 预发行
 <!--rehype:className=cols-2-->
 
-----
+---
 
 :- | :-
 :- | :-
@@ -311,7 +311,6 @@ $ lerna bootstrap --hoist
 `--force-local` [#](https://github.com/lerna/lerna/tree/main/commands/bootstrap#--force-local) | 此标志会导致引导命令始终对本地依赖项进行符号链接，而不管匹配的版本范围如何
 <!--rehype:className=style-list-arrow-->
 
-
 ### info 本地环境信息
 
 ```bash
@@ -424,13 +423,13 @@ lerna la
 - 如果不存在 `.gitignore`，则生成一个忽略文件
 <!--rehype:className=style-timeline-->
 
-----
+---
 
 ```shell
 $ lerna init --independent
 ```
 
-----
+---
 
 :- | :-
 :- | :-
@@ -527,7 +526,6 @@ $ lerna diff package-name # 区分一个特定的包
 
 类似于 `lerna changed`，此命令运行 `git diff`
 
-
 ### clean
 
 从所有包中删除 `node_modules` 目录

docs/lessjs.md

@@ -72,7 +72,6 @@ $ lessc styles.less styles.css
 
 另见: [混合(Mixin)的更多信息](https://lesscss.org/features/#mixins-feature)
 
-
 ### 嵌套(Nesting)
 
 ```css

docs/lsof.md

@@ -78,7 +78,6 @@ $ kill -9 `lsof -t -u apache`
 $ kill -9 $(lsof -t -i :8080)
 ```
 
-
 ### 参数
 <!--rehype:wrap-class=row-span-2-->
 
@@ -109,13 +108,12 @@ lsof -p $pid
 lsof -i:9981 -P -t -sTCP:LISTEN
 ```
 
-### 列出打开文件的进程:
+### 列出打开文件的进程
 
 ```bash
 lsof $filename
 ```
 
-
 示例
 ---
 
@@ -219,7 +217,6 @@ migration     2 root  txt   unknown                                 /proc/2/exe
 `NAME` | 打开文件的确切名称
 `REG` | 常规文件
 
-
 另见
 ---
 

docs/markdown.md

@@ -3,7 +3,6 @@ Markdown 备忘清单
 
 这是 Markdown 语法的快速参考备忘单。
 
-
 Markdown 快速参考
 ----
 
@@ -30,7 +29,6 @@ Header 2
 --------
 ```
 
-
 ### 块引用
 
 ```markdown
@@ -64,6 +62,7 @@ Header 2
 + Item 1
 + Item 2
 ```
+
 或者**任务**列表
 
 ```markdown
@@ -132,11 +131,13 @@ ___
 
 ### 代码
 
-~~~markdown
+```markdown
+
 ```javascript
 console.log("This is a block code")
 ```
-~~~
+
+```
 
 ```markdown
 ~~~css
@@ -144,12 +145,10 @@ console.log("This is a block code")
 ~~~
 ```
 
-
 ```markdown
     4 空格缩进做一个代码块
 ```
 
-
 #### 内联代码
 
 ```markdown

docs/matlab.md

@@ -6,7 +6,6 @@ MATLAB 备忘清单
 入门
 ---
 
-
 ### 介绍
 
 MATLAB 是 `matrix laboratory` 的缩写形式
@@ -24,14 +23,18 @@ MATLAB 允许您使用单一的算术运算符或函数来处理矩阵中的所
 ```matlab
 a + 10
 ```
+
 MATLAB 将执行上述语句，并返回以下结果：
+
 ```
 ans = 3×3
     11    13    15
     12    14    16
     17    18    20
 ```
----
+
+----
+
 ```matlab
 sin(a)
 ```
@@ -50,7 +53,9 @@ ans = 3×3
 ```matlab
 a'
 ```
+
 ----
+
 ```
 ans = 3×3
      1     2     7
@@ -63,7 +68,9 @@ ans = 3×3
 ```matlab
 p = a*inv(a)
 ```
+
 ----
+
 ```
 p = 3×3
     1.0000         0         0
@@ -79,7 +86,9 @@ p = 3×3
 ```matlab
 A = [a,a]
 ```
+
 ----
+
 ```
 A = 3×6
 
@@ -93,7 +102,9 @@ A = 3×6
 ```matlab
 A = [a; a]
 ```
+
 ----
+
 ```
 A = 6×3
 
@@ -126,7 +137,9 @@ a = 1×4
 ```matlab
 a = [1 3 5; 2 4 6; 7 8 10]
 ```
+
 ----
+
 ```
 a = 3×3
      1     3     5
@@ -139,7 +152,9 @@ a = 3×3
 ```matlab
 z = zeros(5,1)
 ```
+
 ----
+
 ```
 z = 5×1
      0
@@ -156,6 +171,7 @@ z = 5×1
 ```matlab
 sqrt(-1)
 ```
+
 ----
 
 ```
@@ -167,7 +183,9 @@ ans = 0.0000 + 1.0000i
 ```matlab
 c = [3+4i, 4+3j; -i, 10j]
 ```
+
 ----
+
 ```
 c = 2×2 complex
 
@@ -198,7 +216,6 @@ c = 2×2 complex
 :- | :-
 [DisplayFormatOptions](https://ww2.mathworks.cn/help/matlab/ref/ans.html) | 命令行窗口中的输出显示格式
 
-
 ### 矩阵和数组
 <!--rehype:wrap-class=row-span-5-->
 
@@ -478,7 +495,6 @@ c = 2×2 complex
 
 ### 字符串匹配模式 - 自定义模式显示
 
-
 :- | :- | :-
 :- | :- | :-
 [maskedPattern](https://ww2.mathworks.cn/help/matlab/ref/maskedpattern.html) | 具有指定显示名称的模式
@@ -494,7 +510,6 @@ c = 2×2 complex
 [regexptranslate](https://ww2.mathworks.cn/help/matlab/ref/regexptranslate.html) | 将文本转换为正则表达式
 [regexpPattern](https://ww2.mathworks.cn/help/matlab/ref/regexppattern.html) | 匹配指定正则表达式的模式
 
-
 ### 字符串匹配模式 - 联接和拆分
 
 :- | :- | :-
@@ -543,7 +558,6 @@ c = 2×2 complex
 [strncmp](https://ww2.mathworks.cn/help/matlab/ref/strncmp.html) | 比较字符串的前 <code class="literal">n</code> 个字符（区分大小写）
 [strncmpi](https://ww2.mathworks.cn/help/matlab/ref/strncmpi.html) | 比较字符串的前 <code class="literal">n</code> 个字符（不区分大小写）
 
-
 ### 基本算术
 <!--rehype:wrap-class=row-span-3-->
 
@@ -620,7 +634,6 @@ c = 2×2 complex
 :- | :- | :-
 [bsxfun](https://ww2.mathworks.cn/help/matlab/ref/bsxfun.html) | 对两个数组应用按元素运算（启用隐式扩展）
 
-
 ### 关系运算
 
 值的比较
@@ -688,7 +701,6 @@ true 或 false 条件
 [bitshift](https://ww2.mathworks.cn/help/matlab/ref/bitshift.html) | 将位移动指定位数
 [swapbytes](https://ww2.mathworks.cn/help/matlab/ref/swapbytes.html) | 交换字节顺序
 
-
 数据导入和导出
 ---
 
@@ -824,7 +836,6 @@ true 或 false 条件
 
 ### NetCDF 库程序包 - 维度
 
-
 :- | :- | :-
 :- | :- | :-
 [netcdf.defDim](https://ww2.mathworks.cn/help/matlab/ref/netcdf.defdim.html) | 创建 netCDF 维度
@@ -907,7 +918,6 @@ true 或 false 条件
 [h5write](https://ww2.mathworks.cn/help/matlab/ref/h5write.html) | 写入 HDF5 数据集
 [h5writeatt](https://ww2.mathworks.cn/help/matlab/ref/h5writeatt.html) | 写入 HDF5 属性
 
-
 ### HDF5 库程序包
 <!--rehype:wrap-class=row-span-4-->
 
@@ -966,7 +976,6 @@ true 或 false 条件
 [hdfdf24](https://ww2.mathworks.cn/help/matlab/ref/hdfdf24.html) | HDF 24 位光栅图像 (DF24) 接口的入口
 [hdfdfr8](https://ww2.mathworks.cn/help/matlab/ref/hdfdfr8.html) | HDF 8 位光栅图像 (DFR8) 接口的入口
 
-
 ### FITS 文件 - 函数
 
 :- | :-
@@ -1305,7 +1314,6 @@ true 或 false 条件
 [setRTS](https://ww2.mathworks.cn/help/matlab/ref/serialport.setrts.html) | 设置串行 RTS 引脚
 [setDTR](https://ww2.mathworks.cn/help/matlab/ref/serialport.setdtr.html) | 设置串行 DTR 引脚
 
-
 ### TCP/IP 通信 - 连接和配置
 
 :- | :-

docs/mime.md

@@ -3,7 +3,6 @@ MIME 类型 备忘清单
 
 此备忘单列出了一些常见的 Web MIME 类型。 您可以查看包含所有已注册 MIME 类型的 [IANA/MIME 媒体类型注册表](https://www.iana.org/assignments/media-types/media-types.xhtml)。
 
-
 入门
 ----
 
@@ -17,7 +16,6 @@ MIME 类型 备忘清单
 - 对于 Internet 上的文件格式或格式内容
 <!--rehype:className=style-round-->
 
-
 MIME 类型列表
 --------
 

docs/mysql.md

@@ -3,7 +3,6 @@ MySQL 备忘清单
 
 本备忘单旨在快速理解 [MySQL](https://mysql.com) 所涉及的主要概念，提供了最常用的SQL语句，供您参考。
 
-
 入门
 ---
 
@@ -388,6 +387,7 @@ CREATE TABLE t(
   CHECK(c1> 0 AND c1 >= c2)
 );
 ```
+
 c2列中的设置值不为NULL
 
 ```sql
@@ -556,7 +556,6 @@ DROP INDEX idx_name;
 MySQL 数据类型
 ---------
 
-
 ### Strings
 
 | -            | -                           |
@@ -573,8 +572,8 @@ MySQL 数据类型
 | `ENUM`       | One of preset options       |
 | `SET`        | Selection of preset options |
 
-
 ### Date & time
+
 | Data Type   | Format              |
 |-------------|---------------------|
 | `DATE` | yyyy-MM-dd          |
@@ -583,7 +582,6 @@ MySQL 数据类型
 | `TIMESTAMP` | yyyy-MM-dd hh:mm:ss |
 | `YEAR` | yyyy                |
 
-
 ### Numeric
 
 | -             | -                                                             |

docs/netcat.md

@@ -25,7 +25,6 @@ $ nc -lp port [host] [port]
 ### 选项示例
 <!--rehype:wrap-class=col-span-3 row-span-2-->
 
-
 选项 | 示例 | 说明
 :- | :- | :-
 `-h`   | nc -h                      | 帮助
@@ -40,7 +39,6 @@ $ nc -lp port [host] [port]
 `-4`   | nc -4 -l 8000              | 仅限 `IPv4`
 `-6`   | nc -6 -l 8000              | 仅限 `IPv6`
 
-
 ### 聊天客户端-服务器
 <!--rehype:wrap-class=col-span-2-->
 

docs/netstat.md

@@ -42,7 +42,6 @@ $ netstat -h
 `netstat -au` | 所有 UDP 连接
 `netstat -ant` | 显示没有反向 DNS 查找的 IP 地址
 
-
 选项 | 说明
 :- | :-
 `netstat` | 活动连接
@@ -53,7 +52,6 @@ $ netstat -h
 `netstat -tnl` | 监听 TCP 端口
 `netstat -unl` | 监听 UDP 端口
 
-
 ### 网络
 
 选项 | 说明
@@ -65,7 +63,6 @@ $ netstat -h
 
 ### 路由
 
-
 选项 | 说明
 :- | :-
 `netstat -r`  | 显示路由表

docs/nginx.md

@@ -313,7 +313,6 @@ server {
 
 您可以使用 Let's Encrypt 轻松保护您的网站/应用程序。去 [lets-encrypt](https://certbot.eff.org/lets-encrypt/ubuntuxenial-nginx.html) 获取更多信息
 
-
 ### 重定向(301永久)
 <!--rehype:wrap-class=row-span-2-->
 

docs/npm.md

@@ -86,11 +86,9 @@ $ npm cache verify # 验证缓存文件夹的内容，垃圾收集任何不需
 `npm update -g`         | 更新全局包
 `npm update lodash`     | 更新 `lodash` 包
 
-
 ### 杂项功能
 <!--rehype:wrap-class=row-span-2-->
 
-
 ```bash
 # 将某人添加为所有者
 $ npm owner add USERNAME PACKAGENAME
@@ -168,7 +166,6 @@ $ nrm use cnpm
 `$PREFIX/etc/npmrc` | 全局配置文件
 `/path/to/npm/npmrc` | npm 内置配置文件
 
-
 ### 配置内容
 
 ```ini
@@ -180,17 +177,16 @@ $ nrm use cnpm
 
 注释使用 `#`, `;` 放置到一行的开头， [`.npmrc`](https://docs.npmjs.com/cli/v8/configuring-npm/npmrc) 文件由指定此注释语法的 [`npm/ini`](https://github.com/npm/ini) 解析
 
-
 ### registry
 
 :- | :-
 :- | :-
-`npm` | https://registry.npmjs.org/
-`yarn` | https://registry.yarnpkg.com/
-`tencent` | https://mirrors.cloud.tencent.com/npm/
-`cnpm` | https://r.cnpmjs.org/
-`taobao` | https://registry.npmmirror.com/
-`npmMirror` | https://skimdb.npmjs.com/registry/
+`npm` | <https://registry.npmjs.org/>
+`yarn` | <https://registry.yarnpkg.com/>
+`tencent` | <https://mirrors.cloud.tencent.com/npm/>
+`cnpm` | <https://r.cnpmjs.org/>
+`taobao` | <https://registry.npmmirror.com/>
+`npmMirror` | <https://skimdb.npmjs.com/registry/>
 
 ### `.npmignore`
 
@@ -261,6 +257,36 @@ ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-
 //somewhere.com/another/:_authToken=MYTOKEN2
 ```
 
+纯 ESM 包
+----
+
+### CommonJS 项目移动到 ESM
+<!--rehype:wrap-class=col-span-3-->
+
+- 将 `"type": "module"` 添加到您的 [package.json](./package.json.md)
+- 将 [package.json](./package.json.md) 中的 `"main": "index.js"` 替换为 `"exports": "./index.js"`。
+- 将 [package.json](./package.json.md) 中的 `"engines"` 字段更新为 Node.js 14: `"node": ">=14.16"`。(不包括 <red>~~Node.js 12~~</red>，因为它不再受支持)
+- 删除 `"use strict"`；来自所有 JavaScript 文件
+- 将所有 `require()` / `module.export` 替换为 `import` / `export`
+- 仅使用完整的相对文件路径进行导入：`import x from '.';` → `import x from './index.js';`
+- 如果您有 `TypeScript` 类型定义（例如 `index.d.ts`），请将其更新为使用 ESM 导入/导出
+- 可选但推荐使用 `node:` 导入[协议](https://nodejs.org/api/esm.html#esm_node_imports)
+
+### TypeScript 项目输出 ESM
+<!--rehype:wrap-class=col-span-3-->
+
+- 确保您使用的是 TypeScript 4.7 或更高版本
+- 将 `"type": "module"` 添加到您的 [package.json](./package.json.md)
+- 将 [package.json](./package.json.md) 中的 `"main": "index.js"` 替换为 `"exports": "./index.js"`
+- 将 [package.json](./package.json.md) 中的 `"engines"` 字段更新为 Node.js 14: `"node": ">=14.16"`。 （不包括 <red>~~Node.js 12~~</red>，因为它不再受支持）
+- 将 `"module": "node16"`, `"moduleResolution": "node16"` 添加到您的 [tsconfig.json](./typescript.md) ([列子](https://github.com/sindresorhus/tsconfig/blob/main/tsconfig.json))
+- 仅使用完整的相对文件路径进行导入：`import x from '.';` → `import x from './index.js';`
+- 删除 `namespace` 使用并改用 `export`
+- 可选但推荐使用 `node:` 导入[协议](https://nodejs.org/api/esm.html#esm_node_imports)
+- **即使您正在导入 `.ts` 文件，也必须在相对导入中使用 `.js` 扩展名**
+
+阅读[官方 ESM 指南](https://www.typescriptlang.org/docs/handbook/esm-node.html)
+
 另见
 ----
 

docs/package.json.md

@@ -12,6 +12,8 @@ package.json 备忘清单
 
 - [npm 文档](https://docs.npmjs.com/files/package.json) _(npmjs.com)_
 - [yarnpkg 文档](https://classic.yarnpkg.com/en/docs/package-json) _(yarnpkg.com)_
+- [packages 文档](https://nodejs.org/api/packages.html) _(nodejs.org)_
+- [npm 备忘清单(速查表)](./npm.md) _(jaywcjlove.github.io)_
 
 ### `name`
 
@@ -21,7 +23,7 @@ package.json 备忘清单
 }
 ```
 
-**规则**
+#### 规则
 
 - 必须小于或等于214个字符(包括 `@scope/` 范围包)
 - 不能以点（`.`）或下划线（`_`）开头
@@ -328,12 +330,100 @@ https://registry.npmjs.org/[包名]/-/[包名]-[version].tgz
 
 字段由模块作者提供，作为 `JavaScript` 包或组件工具的提示，用于打包模块以供客户端使用。 提案就[在这里](https://github.com/defunctzombie/package-browser-field-spec)。
 
+### `exports`
+
+```json
+{
+  "name": "mod",
+  "exports":{
+    ".": "./lib/index.js",
+    "./lib/*": "./lib/*.js"
+  }
+}
+```
+
+使用最新的 `exports` 字段导出，可规避 `main` 字段局限性 [具体参考](https://nodejs.org/api/packages.html)
+
+### exports 导出子路径中的模块
+
+```json
+{
+  "name": "mod",
+  "exports": {
+    ".": "./index.js",
+    "./sub": "./src/sub.js"
+  }
+}
+```
+
+导入
+
+```js
+import sub from "mod/sub"
+```
+
+### exports 简写 (`.` 唯一的导出)
+
+```json
+{
+  "exports": {
+    ".": "./dist/index.js"
+  }
+}
+```
+
+简写
+
+```json
+{
+  "exports": "./dist/index.js"
+}
+```
+
+### 条件导出(exports)
+<!--rehype:wrap-class=col-span-2 row-span-2-->
+
+:- | -
+:- | -
+`export` | 通过 `import` 或 `import()` 或 `es` 模块加载的任何顶层导入或解析操作加载时，匹配。
+`require` | 当包通过 `require()` 加载时匹配。预期的格式包括 CommonJS、JSON 和本地插件。
+`node` | 匹配任何 `Node.js` 环境。可以是 `cjs` 或 `es` 模块文件。必须在 `import` 或 `require` 之后。
+`default` | 默认的降级条件。可以是一个 `cjs` 或 `es` 模块文件。这个条件应该总是排在最后。
+
+```js
+{
+  "exports": {
+    ".": {
+      "import":"./dist/index.mjs",
+      "require":"./dist/index.cjs",  // 当包通过 `require()` 加载时匹配
+      "node": "./dist/ployfill.js",  // 匹配任何 `Node.js` 环境
+      "default": "./dist/default.js" // 默认的降级条件
+    }
+  }
+}
+```
+
+<red>注意：</red>由于 `require` 和 `import` 互斥，所以 `require` 不能加载 `es` 的模块，`export` 不能加载 `cjs` 模块
+
+### `main` Vs `exports`
+
+```json
+{
+  "main": "./index.js",
+  "exports": "./index.js"
+} 
+```
+
+如果同时出现 <red>~~`main`~~</red> 和 `exports` 字段，只会读取 `exports` 字段
+
 ## 任务类字段
 
 包里还可以包含一些可执行脚本或者其他配置信息。
 
 ### `scripts`
 
+脚本是定义自动化开发相关任务的好方法，比如使用一些简单的构建过程或开发工具。 在 `scripts` 字段里定义的脚本，可以通过 `yarn run <script>` 命令来执行。 例如，下面 `build-project` 脚本可以通过 `yarn run build-project` 调用，并执行 `node build-project.js`。
+
 ```json
 {
   "scripts": {
@@ -342,12 +432,14 @@ https://registry.npmjs.org/[包名]/-/[包名]-[version].tgz
 }
 ```
 
-脚本是定义自动化开发相关任务的好方法，比如使用一些简单的构建过程或开发工具。 在 `scripts` 字段里定义的脚本，可以通过 `yarn run <script>` 命令来执行。 例如，上述 `build-project` 脚本可以通过 `yarn run build-project` 调用，并执行 `node build-project.js`。
-
 有一些特殊的脚本名称。 如果定义了 `preinstall` 脚本，它会在包安装前被调用。 出于兼容性考虑，`install`、`postinstall` 和 `prepublish` 脚本会在包完成安装后被调用。
 
+----
+
 `start` 脚本的默认值为 `node server.js`。
 
+----
+
 参考文档：[npm docs](https://docs.npmjs.com/files/package.json#default-values)
 
 ### 特定的 `scripts`
@@ -355,24 +447,24 @@ https://registry.npmjs.org/[包名]/-/[包名]-[version].tgz
 
 对于以下脚本，`npm` 支持 `package.json` 文件的 `scripts` 默认命令字段：
 
-- `prepublish`: 在打包并发布包之前运行，以及在没有任何参数的本地 `npm` 安装之前运行。 （见下文）
-- `prepare`: 在打包和发布包之前运行，在没有任何参数的本地 `npm install` 上运行，以及安装 git 依赖项时（见下文）。 这是在 `preublish` 之后运行，但是在 `preublishOnly` 之前运行。
-- `prepublishOnly`: 在包准备和打包之前运行，仅限于npm发布。 （见下文。）
+- `prepublish`: 在打包并发布包之前运行，以及在没有任何参数的本地 `npm` 安装之前运行
+- `prepare`: 在打包和发布包之前运行，在没有任何参数的本地 `npm install` 上运行，以及安装 git 依赖项时。 这是在 `preublish` 之后运行，但是在 `preublishOnly` 之前运行
+- `prepublishOnly`: 在包准备和打包之前运行，仅限于npm发布
 - `prepack`: 在打包 `tarball` 之前运行（在 `npm pack`，`npm publish`，以及安装 git 依赖项时）
-- `postpack`: 在生成 `tarball` 之后运行并移动到其最终目标。
-- `publish`, `postpublish`: 在包发布后运行。
-- `preinstall`: 在安装软件包之前运行。
-- `install`, `postinstall`: 安装包后运行。
-- `preuninstall`, `uninstall`: 在卸载软件包之前运行。
-- `postuninstall`: 在卸载软件包之后运行。
-- `preversion`: 在改变包版本之前运行。
-- `version`: 改变包版本后运行，但提交之前。
-- `postversion`: 改变包版本后运行，然后提交。
-- `pretest`, `test`, `posttest`: 由 `npm test` 命令运行。
-- `prestop`, `stop`, `poststop`: 由 `npm stop` 命令运行。
-- `prestart`, `start`, `poststart`: 由 `npm start` 命令运行。 
-- `prerestart`, `restart`, `postrestart`: 由 `npm restart` 命令运行。 注意：如果没有提供重启脚本，`npm restart` 将运行 `stop` 和`start` 脚本。
-- `preshrinkwrap`, `shrinkwrap`, `postshrinkwrap`: 由 `npm shrinkwrap` 命令运行。
+- `postpack`: 在生成 `tarball` 之后运行并移动到其最终目标
+- `publish`, `postpublish`: 在包发布后运行
+- `preinstall`: 在安装软件包之前运行
+- `install`, `postinstall`: 安装包后运行
+- `preuninstall`, `uninstall`: 在卸载软件包之前运行
+- `postuninstall`: 在卸载软件包之后运行
+- `preversion`: 在改变包版本之前运行
+- `version`: 改变包版本后运行，但提交之前
+- `postversion`: 改变包版本后运行，然后提交
+- `pretest`, `test`, `posttest`: 由 `npm test` 命令运行
+- `prestop`, `stop`, `poststop`: 由 `npm stop` 命令运行
+- `prestart`, `start`, `poststart`: 由 `npm start` 命令运行
+- `prerestart`, `restart`, `postrestart`: 由 `npm restart` 命令运行。 注意：如果没有提供重启脚本，`npm restart` 将运行 `stop` 和`start` 脚本
+- `preshrinkwrap`, `shrinkwrap`, `postshrinkwrap`: 由 `npm shrinkwrap` 命令运行
 
 参考文档：[npm docs](https://docs.npmjs.com/misc/scripts).
 
@@ -577,7 +669,6 @@ https://registry.npmjs.org/[包名]/-/[包名]-[version].tgz
 
 此选项指定你的包的操作系统兼容性，它会检查 `process.platform`。
 
-
 ### `cpu`
 
 ```json
@@ -624,6 +715,8 @@ Yarn
 
 ### `flat`
 
+<!-- markdownlint-disable MD042 -->
+
 如果你的包只允许给定依赖的一个版本，你想强制和命令行上 [yarn install --flat](#) 相同的行为，把这个值设为 `true`。
 
 ```json
@@ -651,8 +744,11 @@ Yarn
 
 注意，`yarn install --flat` 命令将会自动在 `package.json` 文件里加入 `resolutions` 字段。
 
-
 另见
 ----
 
 - [PACKAGE.JSON 中文说明](https://jaywcjlove.github.io/package.json) _(github.io)_
+- [npm 文档](https://docs.npmjs.com/files/package.json) _(npmjs.com)_
+- [yarnpkg 文档](https://classic.yarnpkg.com/en/docs/package-json) _(yarnpkg.com)_
+- [packages 文档](https://nodejs.org/api/packages.html) _(nodejs.org)_
+- [npm 备忘清单(速查表)](./npm.md) _(jaywcjlove.github.io)_

docs/postgres.md

@@ -0,0 +1,629 @@
+PostgreSQL 备忘清单
+===
+
+[PostgreSQL](https://www.postgresql.org/docs/current/) 备忘清单为您提供了常用的 PostgreSQL 命令和语句。
+
+入门
+---------------
+
+### 入门
+
+切换和连接
+
+```shell
+$ sudo -u postgres psql
+```
+
+列出所有数据库
+
+```shell
+postgres=# \l
+```
+
+连接到名为 postgres 的数据库
+
+```shell
+postgres=# \c postgres
+```
+
+断开
+
+```shell
+postgres=# \q
+postgres=# \!
+```
+
+### psql 命令
+<!--rehype:wrap-class=col-span-2-->
+
+参数 | 示例 | 说明
+:- |- | -
+`[-d] <database>`   | psql -d mydb                                 | 连接到数据库
+`-U`                | psql -U john mydb                            | 以特定用户身份连接
+`-h` `-p`           | psql -h localhost -p 5432 mydb               | 连接到主机/端口
+`-U` `-h` `-p` `-d` | psql -U admin -h 192.168.1.5 -p 2506 -d mydb | 连接远程 PostgreSQL
+`-W`                | psql -W mydb                                 | 强制密码
+`-c`                | psql -c '\c postgres' -c '\dt'               | 执行 SQL 查询或命令
+`-H`                | psql -c "\l+" -H postgres > database.html    | 生成 HTML 报告
+`-l`                | psql -l                                      | 列出所有数据库
+`-f`                | psql mydb -f file.sql                        | 从文件执行命令
+`-V`                | psql -V                                      | 打印 psql 版本
+<!--rehype:className=show-header-->
+
+### 获得帮助
+
+:- | -
+:- | -
+`\h`        | SQL 命令语法帮助
+`\h` DELETE | DELETE SQL 语句语法
+`\?`        | PostgreSQL 命令列表
+
+在 PostgreSQL 控制台中运行
+
+PostgreSQL 工作
+-------
+
+### Recon 观察
+
+显示版本
+
+```sql
+SHOW SERVER_VERSION;
+```
+
+显示系统状态
+
+```sql
+\conninfo
+```
+
+显示环境变量
+
+```sql
+SHOW ALL;
+```
+
+列出用户
+
+```sql
+SELECT rolname FROM pg_roles;
+```
+
+显示当前用户
+
+```sql
+SELECT current_user;
+```
+
+显示当前用户的权限
+
+```sql
+\du
+```
+
+显示当前数据库
+
+```sql
+SELECT current_database();
+```
+
+显示数据库中的所有表
+
+```sql
+\dt
+```
+
+列出函数
+
+```sql
+\df <schema>
+```
+
+### Databases 数据库
+
+列出数据库
+
+```sql
+\l
+```
+
+连接到数据库
+
+```sql
+\c <database_name>
+```
+
+显示当前数据库
+
+```sql
+SELECT current_database();
+```
+
+[创建数据库](http://www.postgresql.org/docs/current/static/sql-createdatabase.html)
+
+```sql
+CREATE DATABASE <database_name> WITH OWNER <username>;
+```
+<!--rehype:className=wrap-text-->
+
+[删除数据库](http://www.postgresql.org/docs/current/static/sql-dropdatabase.html)
+
+```sql
+DROP DATABASE IF EXISTS <database_name>;
+```
+<!--rehype:className=wrap-text-->
+
+[重命名数据库](http://www.postgresql.org/docs/current/static/sql-alterdatabase.html)
+
+```sql
+ALTER DATABASE <old_name> RENAME TO <new_name>;
+```
+<!--rehype:className=wrap-text-->
+
+### Tables 表
+
+列出当前数据库中的表
+
+```sql
+\dt
+SELECT table_schema,table_name FROM information_schema.tables ORDER BY table_schema,table_name;
+```
+<!--rehype:className=wrap-text-->
+
+全局列表
+
+```sql
+\dt *.*.
+SELECT * FROM pg_catalog.pg_tables
+```
+
+列表表架构
+
+```sql
+\d <table_name>
+\d+ <table_name>
+SELECT column_name, data_type, character_maximum_length
+FROM INFORMATION_SCHEMA.COLUMNS
+WHERE table_name = '<table_name>';
+```
+<!--rehype:className=wrap-text-->
+
+[创建表](http://www.postgresql.org/docs/current/static/sql-createtable.html)
+
+```sql
+CREATE TABLE <table_name>(
+  <column_name> <column_type>,
+  <column_name> <column_type>
+);
+```
+
+创建表，主键自增
+
+```sql
+CREATE TABLE <table_name> (
+  <column_name> SERIAL PRIMARY KEY
+);
+```
+
+[删除表](http://www.postgresql.org/docs/current/static/sql-droptable.html)
+
+```sql
+DROP TABLE IF EXISTS <table_name> CASCADE;
+```
+
+### Permissions 权限
+
+成为 postgres 用户，如果您有权限错误
+
+```shell
+sudo su - postgres
+psql
+```
+
+[授予](http://www.postgresql.org/docs/current/static/sql-grant.html) 对数据库的所有权限
+
+```sql
+GRANT ALL PRIVILEGES ON DATABASE <db_name> TO <user_name>;
+```
+<!--rehype:className=wrap-text-->
+
+授予数据库连接权限
+
+```sql
+GRANT CONNECT ON DATABASE <db_name> TO <user_name>;
+```
+<!--rehype:className=wrap-text-->
+
+授予架构权限
+
+```sql
+GRANT USAGE ON SCHEMA public TO <user_name>;
+```
+
+授予函数权限
+
+```sql
+GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO <user_name>;
+```
+<!--rehype:className=wrap-text-->
+
+授予在所有表上选择、更新、插入、删除的权限
+
+```sql
+GRANT SELECT, UPDATE, INSERT ON ALL TABLES IN SCHEMA public TO <user_name>;
+```
+<!--rehype:className=wrap-text-->
+
+在表上授予权限
+
+```sql
+GRANT SELECT, UPDATE, INSERT ON <table_name> TO <user_name>;
+```
+<!--rehype:className=wrap-text-->
+
+授予对表的选择权限
+
+```sql
+GRANT SELECT ON ALL TABLES IN SCHEMA public TO <user_name>;
+```
+<!--rehype:className=wrap-text-->
+
+### Columns 列
+
+[添加栏目](http://www.postgresql.org/docs/current/static/sql-altertable.html)
+
+```sql
+ALTER TABLE <table_name> IF EXISTS
+ADD <column_name> <data_type> [<constraints>];
+```
+<!--rehype:className=wrap-text-->
+
+更新栏
+
+```sql
+ALTER TABLE <table_name> IF EXISTS
+ALTER <column_name> TYPE <data_type> [<constraints>];
+```
+<!--rehype:className=wrap-text-->
+
+删除列
+
+```sql
+ALTER TABLE <table_name> IF EXISTS
+DROP <column_name>;
+```
+
+将列更新为自增主键
+
+```sql
+ALTER TABLE <table_name>
+ADD COLUMN <column_name> SERIAL PRIMARY KEY;
+```
+<!--rehype:className=wrap-text-->
+
+使用自动递增的主键插入表中
+
+```sql
+INSERT INTO <table_name>
+VALUES (DEFAULT, <value1>);
+INSERT INTO <table_name> (<column1_name>,<column2_name>)
+VALUES ( <value1>,<value2> );
+```
+<!--rehype:className=wrap-text-->
+
+### Data 数据
+
+[选择](http://www.postgresql.org/docs/current/static/sql-select.html) 所有数据
+
+```sql
+SELECT * FROM <table_name>;
+```
+
+读取一行数据
+
+```sql
+SELECT * FROM <table_name> LIMIT 1;
+```
+
+搜索数据
+
+```sql
+SELECT * FROM <table_name> WHERE <column_name> = <value>;
+```
+<!--rehype:className=wrap-text-->
+
+[插入](http://www.postgresql.org/docs/current/static/sql-insert.html) 数据
+
+```sql
+INSERT INTO <table_name> VALUES( <value_1>, <value_2> );
+```
+<!--rehype:className=wrap-text-->
+
+[更新](http://www.postgresql.org/docs/current/static/sql-update.html) 数据
+
+```sql
+UPDATE <table_name>
+SET <column_1> = <value_1>, <column_2> = <value_2>
+WHERE <column_1> = <value>;
+```
+<!--rehype:className=wrap-text-->
+
+[删除](http://www.postgresql.org/docs/current/static/sql-delete.html) 所有数据
+
+```sql
+DELETE FROM <table_name>;
+```
+
+删除特定数据
+
+```sql
+DELETE FROM <table_name>
+WHERE <column_name> = <value>;
+```
+
+### Users 用户
+<!--rehype:wrap-class=col-span-2-->
+
+列出角色
+
+```sql
+SELECT rolname FROM pg_roles;
+```
+
+[创建用户](http://www.postgresql.org/docs/current/static/sql-createuser.html)
+
+```sql
+CREATE USER <user_name> WITH PASSWORD '<password>';
+```
+
+[删除用户](http://www.postgresql.org/docs/current/static/sql-dropuser.html)
+
+```sql
+DROP USER IF EXISTS <user_name>;
+```
+
+[更改](http://www.postgresql.org/docs/current/static/sql-alterrole.html) 用户密码
+
+```sql
+ALTER ROLE <user_name> WITH PASSWORD '<password>';
+```
+
+### Schema
+
+列出 Schemas
+
+```sql
+\dn
+SELECT schema_name FROM information_schema.schemata;
+SELECT nspname FROM pg_catalog.pg_namespace;
+```
+
+[创建架构](http://www.postgresql.org/docs/current/static/sql-createschema.html)
+
+```sql
+CREATE SCHEMA IF NOT EXISTS <schema_name>;
+```
+
+[删除模式](http://www.postgresql.org/docs/current/static/sql-dropschema.html)
+
+```sql
+DROP SCHEMA IF EXISTS <schema_name> CASCADE;
+```
+
+PostgreSQL 命令
+-----------
+
+### 表
+
+:- | -
+:- | -
+`\d <table>`     | 描述表
+`\d+ <table>`    | 详细描述表格
+`\dt`            | 列出当前模式中的表
+`\dt *.*`        | 列出所有模式中的表
+`\dt <schema>.*` | 列出架构的表
+`\dp`            | 列出表访问权限
+`\det[+]`        | 列出外部表
+
+### 查询缓冲区
+
+:- | -
+:- | -
+`\e [FILE]`  | 编辑查询缓冲区(或文件)
+`\ef [FUNC]` | 编辑函数定义
+`\p`         | 显示内容
+`\r`         | 重置(清除)查询缓冲区
+`\s [FILE]`  | 显示历史记录或保存到文件
+`\w FILE`    | 将查询缓冲区写入文件
+
+### 信息
+<!--rehype:wrap-class=row-span-4-->
+
+:- | -
+:- | -
+`\l[+]`         | 列出所有数据库
+`\dn[S+]`       | 列出架构
+`\di[S+]`       | 列出索引
+`\du[+]`        | 列出角色
+`\ds[S+]`       | 列出序列
+`\df[antw][S+]` | 列出函数
+`\deu[+]`       | 列出用户映射
+`\dv[S+]`       | 列表视图
+`\dl`           | 列出大对象
+`\dT[S+]`       | 列出数据类型
+`\da[S]`        | 列出聚合
+`\db[+]`        | 列出表空间
+`\dc[S+]`       | 列出转化
+`\dC[+]`        | 列出演员表
+`\ddp`          | 列出默认权限
+`\dd[S]`        | 显示对象描述
+`\dD[S+]`       | 列出域
+`\des[+]`       | 列出国外服务器
+`\dew[+]`       | 列出外部数据包装器
+`\dF[+]`        | 列出文本搜索配置
+`\dFd[+]`       | 列出文本搜索词典
+`\dFp[+]`       | 列出文本搜索解析器
+`\dFt[+]`       | 列出文本搜索模板
+`\dL[S+]`       | 列出程序语言
+`\do[S]`        | 列出运算符
+`\dO[S+]`       | 列出排序规则
+`\drds`         | 列出每个数据库的角色设置
+`\dx[+]`        | 列出扩展
+
+`S`：显示系统对象，`+`：附加细节
+
+### 连接
+
+:- | -
+:- | -
+`\c [DBNAME]`          | 连接到新数据库
+`\encoding [ENCODING]` | 显示或设置客户端编码
+`\password [USER]`     | 更改密码
+`\conninfo`            | 显示信息
+
+### 格式化
+
+:- | -
+:- | -
+`\a`           | 在未对齐和对齐之间切换
+`\C [STRING]`  | 设置表格标题，如果没有则取消设置
+`\f [STRING]`  | 显示或设置未对齐的字段分隔符
+`\H`           | 切换 HTML 输出模式
+`\t [on\|off]` | 仅显示行
+`\T [STRING]`  | 设置或取消设置 HTML \<table\> 标签属性
+`\x [on\|off]` | 切换扩展输出
+
+### 输入输出
+
+:- | -
+:- | -
+`\copy ...`       | 导入/导出表 _另见：_ [复制](#导入导出-csv)
+`\echo [STRING]`  | 打印字符串
+`\i FILE`         | 执行文件
+`\o [FILE]`       | 将所有结果导出到文件
+`\qecho [STRING]` | 输出流的字符串
+
+### 变量
+
+:- | -
+:- | -
+`\prompt [TEXT] NAME` | 设置变量
+`\set [NAME [VALUE]]` | 设置变量 _(如果没有参数，则列出所有变量)_
+`\unset NAME`         | 删除变量
+
+### 杂项
+
+:- | -
+:- | -
+`\cd [DIR]`        | 更改目录
+`\timing [on\|off]` | 切换时间
+`\! [COMMAND]`     | 在shell中执行
+`\! ls -l`         | 在shell中列出所有
+
+### 大对象
+
+- `\lo_export LOBOID FILE`
+- `\lo_import FILE [COMMENT]`
+- `\lo_list`
+- `\lo_unlink LOBOID`
+
+各种各样的
+-------------
+
+### 备份
+
+使用 pg_dumpall 备份所有数据库
+
+```shell
+$ pg_dumpall -U postgres > all.sql
+```
+
+使用 pg_dump 备份数据库
+
+```shell
+$ pg_dump -d mydb -f mydb_backup.sql
+```
+
+- &nbsp; `-a` &nbsp; 只转储数据，而不是模式(schema)
+- &nbsp; `-s` &nbsp; 只转储模式，不转储数据
+- &nbsp; `-c` &nbsp; 在重新创建之前删除数据库
+- &nbsp; `-C` &nbsp; 还原前创建数据库
+- &nbsp; `-t` &nbsp; 仅转储命名表
+- &nbsp; `-F` &nbsp; 格式(`c`：自定义，`d`：目录，`t`：tar)
+<!--rehype:className=style-none-->
+
+使用 `pg_dump -?` 获取完整的选项列表
+
+### 恢复
+
+使用 psql 恢复数据库
+
+```shell
+$ psql -U user mydb < mydb_backup.sql
+```
+
+使用 pg_restore 恢复数据库
+
+```shell
+$ pg_restore -d mydb mydb_backup.sql -c
+```
+
+- &nbsp; `-U` &nbsp; 指定数据库用户
+- &nbsp; `-c` &nbsp; 在重新创建之前删除数据库
+- &nbsp; `-C` &nbsp; 还原前创建数据库
+- &nbsp; `-e` &nbsp; 如果遇到错误退出
+- &nbsp; `-F` &nbsp; 格式(`c`:自定义，`d`:目录，`t`:tar，`p`:纯文本sql(默认))
+<!--rehype:className=style-none-->
+
+使用 `pg_restore -?` 获取完整的选项列表
+
+### 远程访问
+
+获取 postgresql.conf 的位置
+
+```shell
+$ psql -U postgres -c 'SHOW config_file'
+```
+
+附加到 postgresql.conf
+
+```shell
+listen_addresses = '*'
+```
+
+附加到 pg_hba.conf(与 postgresql.conf 相同的位置)
+
+```shell
+host  all  all  0.0.0.0/0  md5
+host  all  all  ::/0       md5
+```
+
+重启 PostgreSQL 服务器
+
+```shell
+$ sudo systemctl restart postgresql
+```
+
+### 导入/导出 CSV
+
+将表格导出为 CSV 文件
+
+```sql
+\copy table TO '<path>' CSV
+\copy table(col1,col1) TO '<path>' CSV
+\copy (SELECT...) TO '<path>' CSV
+```
+
+将 CSV 文件导入表格
+
+```sql
+\copy table FROM '<path>' CSV
+\copy table(col1,col1) FROM '<path>' CSV
+```
+
+另见：[复制](https://www.postgresql.org/docs/current/sql-copy.html)
+
+Also see
+--------
+
+- [Posgres-cheatsheet](https://gist.github.com/apolloclark/ea5466d5929e63043dcf#posgres-cheatsheet) _(gist.github.com)_

docs/python.md

@@ -57,6 +57,7 @@ llo
 查看: [Strings](#python-字符串)
 
 ### Lists
+
 ```python
 mylist = []
 mylist.append(1)
@@ -67,7 +68,6 @@ for item in mylist:
 
 查看: [Lists](#python-lists)
 
-
 ### If Else
 
 ```python
@@ -77,6 +77,7 @@ if num > 0:
 else:
     print("num is not greater than 0")
 ```
+
 查看: [流程控制](#python-流程控制)
 
 ### 循环
@@ -88,8 +89,8 @@ for item in range(6):
 else:
     print("Finally finished!")
 ```
-查看: [Loops](#python-循环)
 
+查看: [Loops](#python-循环)
 
 ### 函数
 
@@ -101,7 +102,7 @@ else:
 来自函数的你好
 ```
 
-查看: [Functions](#python-functions)
+查看: [Functions](#函数)
 
 ### 文件处理
 <!--rehype:wrap-class=col-span-2-->
@@ -151,7 +152,7 @@ message += "Part 2."
 '10 + 10 = 20'
 ```
 
-查看: [Python F-Strings](#python-f-strings-since-python)
+查看: [Python F-Strings](#f-字符串(Python 3.6+))
 
 Python 数据类型
 ---------------
@@ -165,6 +166,7 @@ multi_string = """Multiline Strings
 Lorem ipsum dolor sit amet,
 consectetur adipiscing elit """
 ```
+
 查看: [Strings](#python-字符串)
 
 ### 数字
@@ -194,8 +196,8 @@ list2 = [True, False, False]
 list3 = [1, 5, 7, 9, 3]
 list4 = list((1, 5, 7, 9, 3))
 ```
-查看: [Lists](#python-lists)
 
+查看: [Lists](#python-lists)
 
 ### 元组 Tuple
 
@@ -361,6 +363,7 @@ o
 `len()` 函数返回字符串的长度
 
 ### 多份
+
 ```python
 >>> s = '===+'
 >>> n = 8
@@ -396,7 +399,9 @@ True
 name = "John"
 print("Hello, %s!" % name)
 ```
+
 ---
+
 ```python
 name = "John"
 age = 23
@@ -948,6 +953,7 @@ with open("myfile.txt") as file:
     for line in file:
         print(line)
 ```
+
 #### 带行号
 
 ```python
@@ -956,7 +962,6 @@ for i, line in enumerate(file, start=1):
     print("Number %s: %s" % (i, line))
 ```
 
-
 ### 字符串
 
 #### 写一个字符串
@@ -1083,6 +1088,7 @@ class ChildClass(ParentClass):
         # 调用父级的 print_test()
         super().print_test() 
 ```
+
 ---
 
 ```python
@@ -1172,7 +1178,8 @@ Yoki.sound()     # => Woof!
 ```python
 # 这是单行注释
 ```
-----------
+
+---
 
 ```python
 """ 可以写多行字符串
@@ -1180,7 +1187,9 @@ Yoki.sound()     # => Woof!
     作为文档。
 """
 ```
-----------
+
+---
+
 ```python
 ''' 可以写多行字符串
     使用三个'，并且经常使用

docs/quickreference.md

@@ -111,7 +111,6 @@ function () {}
 
 如果代码块内容太长，使用强制换行类(`wrap-text`)解决
 
-
 ### 展示表格表头
 
 ```markdown
@@ -209,6 +208,7 @@ const school = <div>学校</div>;
 :- | -
 :- | -
 `<yel>` | <yel>黄色</yel>
+`<red>` | <yel>红色</yel>
 `<pur>` | <pur>紫色</pur>
 `<code>` 或 <code>\`\`</code> | <code>绿</code>`色`
 `<del>` 或 `~~删除~~` | <del>~~红色~~</del>
@@ -230,7 +230,6 @@ const school = <div>学校</div>;
 `<!--rehype:className=style-timeline-->` | 时间轴样式
 `<!--rehype:className=style-arrow-->` | 箭头标记
 
-
 ### 隐藏卡片标题
 <!--rehype:style=display:none;&wrap-style=padding-top: 0;-->
 
@@ -582,7 +581,6 @@ H2 部分
 
 在 `Title 1` 标题添加 `col-span-2` 和 `row-span-2` 占位类，使用 `空格` 间隔。
 
-
 表格
 ---
 
@@ -699,14 +697,19 @@ H2 部分
 <!--rehype:wrap-class=row-span-2-->
 
 - **重命名为 new_name**
+
   ```bash
   $ git branch -m <new_name>
   ```
+
 - 推送和**重置**
+
   ```bash
   $ git push origin -u <new_name>
   ```
+
 - 删除远程分支
+
   ```bash
   $ git push origin --delete <old>
   ```

docs/react.md

@@ -3,7 +3,6 @@ React 备忘清单
 
 适合初学者的综合 React 备忘清单。
 
-
 入门
 ----
 
@@ -59,7 +58,6 @@ import World, { Hello } from './hello.js';
 
 使用 `import` 导入 `Hello` 组件，在示例中使用。
 
-
 ### React 组件中的 CSS
 
 ```jsx {2,5}
@@ -82,7 +80,6 @@ export const Student = (
 );
 ```
 
-
 ### 属性
 
 ```jsx
@@ -112,7 +109,6 @@ class Student extends React.Component {
 
 `class` 组件使用 `this.props` 访问传递给组件的属性。
 
-
 ### Children
 <!--rehype:wrap-class=row-span-2-->
 
@@ -138,7 +134,7 @@ function AlertBox(props) {
 }
 ```
 
-----
+-----
 
 ```jsx
 {props.children}
@@ -158,7 +154,7 @@ class AlertBox extends React.Component {
 }
 ```
 
-----
+-----
 
 ```jsx
 {this.props.children}
@@ -297,7 +293,7 @@ function Student() {
 
 ### Portals
 
-React 并*没有*创建一个新的 `div`。它只是把子元素渲染到 `domNode` 中。`domNode` 是一个可以在任何位置的有效 DOM 节点。
+React 并_没有_创建一个新的 `div`。它只是把子元素渲染到 `domNode` 中。`domNode` 是一个可以在任何位置的有效 DOM 节点。
 
 ```jsx
 render() {
@@ -438,7 +434,7 @@ function CustomTextInput(props) {
 </div>
 ```
 
-----
+-----
 
 - [识别不安全的生命周期](https://zh-hans.reactjs.org/docs/strict-mode.html#identifying-unsafe-lifecycles)
 - [关于使用过时字符串 ref API 的警告](https://zh-hans.reactjs.org/docs/strict-mode.html#warning-about-legacy-string-ref-api-usage)
@@ -754,7 +750,7 @@ export default function Weather(props) {
 }
 ```
 
-----
+-----
 
 ```js
 {isShow && <div>内容</div>}
@@ -860,7 +856,6 @@ class Welcome extends React.Component {
 `this.props` | 组件接受参数
 `this.state` | 组件内状态
 
-
 ### Pure 组件
 
 ```jsx
@@ -1003,7 +998,7 @@ Menu.Item = ({ children }) => (
 );
 ```
 
-----
+-----
 
 ```jsx
 <Menu>
@@ -1330,7 +1325,7 @@ PropTypes 属性类型检查
 import PropTypes from 'prop-types'
 ```
 
-----
+-----
 
 :- | -
 :- | -
@@ -1354,7 +1349,6 @@ import PropTypes from 'prop-types'
 `oneOf(any)` | 枚举类型
 `oneOfType([type])` | 几种类型中的任意一个类型
 
-
 #### _数组 Array_
 
 :- | -

docs/regex.md

@@ -33,7 +33,6 @@ RegEX 备忘清单
 `[a-zA-Z]`    | 范围内的字符：<br>`a-z` 或 `A-Z`
 `[a-zA-Z0-9]` | 范围内的字符：<br>`a-z`、`A-Z` 或 `0-9`
 
-
 ### 量词
 
 范例 | 说明
@@ -115,7 +114,6 @@ RegEX 备忘清单
 `[\b]`       | 退格字符
 `\`          | 使任何字符文字
 
-
 ### 锚点
 
 范例 | 说明
@@ -129,7 +127,6 @@ RegEX 备忘清单
 `\b`    | 一个词的边界
 `\B`    | 非单词边界
 
-
 ### 替代
 
 范例 | 说明
@@ -285,7 +282,6 @@ RegEX 备忘清单
 
 使用 `\` 搜索这些特殊字符：<br> `[ \ ^ $ . | ? * + ( ) { }`
 
-
 ### 速记类
 
 范例 | 说明
@@ -355,7 +351,6 @@ RegEX 备忘清单
 `^[A-Z]` | 字符串必须以大写字母开头
 `[\.!?"')]$` | 字符串必须以终端标点结尾
 
-
 ### 修饰
 
 范例 | 说明
@@ -421,7 +416,6 @@ RegEX 备忘清单
 `\b\w{3}(?<!pre)\w*?\b` | 不以“pre”开头的词
 `\b\w+(?<!ing)\b`       | 匹配不以“ing”结尾的单词
 
-
 ### If-then-else
 
 匹配 `Mr.` 或 `Ms.` 如果单词 `her` 稍后在字符串中
@@ -664,7 +658,6 @@ Python 中的正则表达式
 import re
 ```
 
-
 ### 实例
 <!--rehype:wrap-class=col-span-2 row-span-3-->
 
@@ -736,11 +729,8 @@ False
 `re.compile`  | 编译正则表达式模式供以后使用
 `re.escape`   | 返回所有非字母数字反斜杠的字符串
 
-
-
 ### Flags 标志
 
-
 :- | - | -
 :- | - | -
 `re.I` | `re.IGNORECASE` | 忽略大小写
@@ -750,8 +740,6 @@ False
 `re.U` | `re.UNICODE`    | 使 `\w`、`\b`、`\d`、`\s` _unicode 依赖_
 `re.X` | `re.VERBOSE`    | 可读风格
 
-
-
 JavaScript 中的正则表达式
 ---------------
 
@@ -894,14 +882,12 @@ text.replaceAll(regex, "mangoes");
 ```
 <!--rehype:className=wrap-text-->
 
-
 PHP中的正则表达式
 ------------
 
 ### 函数
 <!--rehype:wrap-class=col-span-2-->
 
-
 :- | -
 :- | -
 `preg_match()`            | 执行正则表达式匹配
@@ -911,7 +897,6 @@ PHP中的正则表达式
 `preg_split()`            | 按正则表达式模式拆分字符串
 `preg_grep()`             | 返回与模式匹配的数组条目
 
-
 ### preg_replace
 
 ```php
@@ -923,7 +908,6 @@ echo preg_replace($regex, "QuickRef", $str);
 ```
 <!--rehype:className=wrap-text-->
 
-
 ### preg_match
 
 ```php
@@ -933,7 +917,6 @@ $regex = "#quickref#i";
 echo preg_match($regex, $str);
 ```
 
-
 ### preg_matchall
 <!--rehype:wrap-class=col-span-2 row-span-2-->
 
@@ -952,7 +935,6 @@ if (preg_match_all($regex, $input_str, $matches_out)) {
 }
 ```
 
-
 ### preg_grep
 
 ```php
@@ -962,7 +944,6 @@ $regex = "/Jane/";
 echo preg_grep($regex, $arr);
 ```
 
-
 ### preg_split
 <!--rehype:wrap-class=col-span-2-->
 
@@ -973,7 +954,6 @@ $regex = "@\s@";
 print_r(preg_split($regex, $str));
 ```
 
-
 Java 中的正则表达式
 -------------
 
@@ -1003,10 +983,8 @@ boolean s3 = Pattern.matches(".s", "XXXX");
 System.out.println(s3);   // Outputs: false
 ```
 
-
 ### 模式字段
 
-
 :- | -
 :- | -
 `CANON_EQ`         | 规范等价
@@ -1017,7 +995,6 @@ System.out.println(s3);   // Outputs: false
 `UNICODE_CASE`     | Unicode 感知大小写折叠
 `UNIX_LINES`       | Unix 行模式
 
-
 ### 方法
 
 #### Pattern
@@ -1043,7 +1020,6 @@ System.out.println(s3);   // Outputs: false
 
 还有更多方法...
 
-
 ### 例子
 <!--rehype:wrap-class=col-span-2-->
 
@@ -1073,7 +1049,6 @@ while (m.find()) {
 System.out.println(matches);
 ```
 
-
 MySQL中的正则表达式
 -------------
 <!--rehype:body-class=cols-2-->
@@ -1088,9 +1063,8 @@ MySQL中的正则表达式
 `REGEXP_REPLACE()` | 替换匹配正则表达式的子字符串 <br>_（注意：仅限 MySQL 8.0+）_
 `REGEXP_SUBSTR()` | 返回匹配正则表达式的子字符串 <br>_(注意：仅 MySQL 8.0+)_
 
-
-
 ### REGEXP
+
 ```sql
 expr REGEXP pat 
 ```
@@ -1107,7 +1081,6 @@ mysql> SELECT 'a' REGEXP 'A', 'a' REGEXP BINARY 'A';
 1   0
 ```
 
-
 ### REGEXP_REPLACE
 
 ```
@@ -1123,7 +1096,6 @@ mysql> SELECT REGEXP_REPLACE('abc ghi', '[a-z]+', 'X', 1, 2);
 abc X
 ```
 
-
 ### REGEXP_SUBSTR
 
 ```
@@ -1139,7 +1111,6 @@ mysql> SELECT REGEXP_SUBSTR('abc def ghi', '[a-z]+', 1, 3);
 ghi
 ```
 
-
 ### REGEXP_LIKE
 
 ```
@@ -1161,7 +1132,6 @@ mysql> SELECT regexp_like('a\nb\nc', '^b$', 'm');
 1
 ```
 
-
 ### REGEXP_INSTR
 
 ```

docs/resolutions.md

@@ -133,7 +133,6 @@ Resolutions 备忘清单
 | Xiaomi Redmi Note 8 Pro (2019)     | 6.53 <sub>inch</sub> | 1080 x 2340 <sub>px</sub> | 393 x 851 <sub>px</sub>  | 395 <sub>ppi</sub> | 144 <sub>ppi</sub> | 2.75 <sub>xxhdpi</sub>  | Android 9.0   |
 <!--rehype:className=show-header-->
 
-
 ### 平板
 <!--rehype:wrap-class=col-span-3-->
 
@@ -159,7 +158,6 @@ Resolutions 备忘清单
 | Google Pixel C (2015)       | 10.2 <sub>inch</sub> | 2560x1800 <sub>px</sub>   | 1280 x 900 <sub>px</sub>  | 308 <sub>ppi</sub> | 154 <sub>ppi</sub> | 2 <sub>xhdpi</sub>   | Android 6.0.1  |
 <!--rehype:className=show-header-->
 
-
 ### 笔记本电脑
 <!--rehype:wrap-class=col-span-3-->
 

docs/rust.md

@@ -13,6 +13,7 @@ fn main() {
   println!("Hello, World!");
 }
 ```
+
 #### 编译运行
 
 ```shell
@@ -176,8 +177,8 @@ let p: Point = (41, 68);
 
 ```rust
 let mut a: u32 = 8;
-let b: u64 = 877;
-let c: i64 = 8999;
+let b = 877_u64;
+let c = 8999i64;
 let d = -90;
 ```
 
@@ -226,6 +227,7 @@ println!("社区的名称是 {community_name}，它有 {no_of_members} 个成员
 └─────┴─────┴─────┴─────┴─────┴─────┘
    0     1     2     3     4     5
 ```
+
 ----
 
 ```rust
@@ -243,6 +245,7 @@ i0 | 1  | 2  | 3  | 4  | 5  | 6  |
 i1 | 6  | 5  | 4  | 3  | 2  | 1  |
    └────┴────┴────┴────┴────┴────┘
 ```
+
 ----
 
 ```rust
@@ -341,6 +344,91 @@ hi.push_str("How are you doing??");
 println!("{hi}");
 ```
 
+### 原生字符串
+
+```rust
+let str1 = r#"\hello"#;
+println!("{}", str1);
+// \hello
+```
+
+原生字符串，无需增加转义字符（`\`）转义
+
+### 字节和字节串
+
+```rust
+let str2 = b'a';
+println!("{}", str2);
+// 97
+let str3 = b"\\hello";
+println!("{:?}", str3);
+// [92, 104, 101, 108, 108, 111]
+let str4 = br#"\hello"#;
+println!("{:?}", str4);
+// [92, 104, 101, 108, 108, 111]
+```
+
+Rust 动态数组
+-----------
+
+### 创建动态数组
+
+```rust
+let v: Vec<i32> = Vec::new();
+// 使用宏
+let v1 = vec![1, 2, 3];
+```
+
+### 读取元素
+
+```rust
+let v = vec![1, 2, 3, 4, 5];
+
+let element = &v[100];
+// panic，越界
+let element2 = v.get(100);
+println!("{:?}", element2);
+//None
+```
+
+### 遍历数组
+
+1. 只读取数组中的元素
+
+   ```rust
+   let v = vec![1, 2, 3];
+   for i in &v {
+       println!("{}", i);
+   }
+   ```
+
+2. 遍历的同时修改数组中的元素
+
+   ```rust
+   let mut v = vec![1, 2, 3];
+   for i in &mut v {
+       *i += 10
+   }
+   ```
+
+### 常用方法
+<!--rehype:wrap-class=col-span-3-->
+
+-|:-
+-|:-
+`len()`                   | 返回 `vec` 的长度
+`is_empty()`              | `vec` 是否为空
+`push(value)`             | 在 `vec` 尾部插入元素
+`pop()`                   | 删除并返回 `vec` 尾部的元素或者返回 `None`
+`insert(index,element)`   | 在指定索引处插入元素
+`remove(index)`           | 删除指定索引处的元素并返回被删除的元素，索引越界将 panic 报错退出
+`clear()`                 | 清空 `vec`
+`append(vec)`             | 将另一个 `vec` 中的所有元素追加移入 `vec` 中，移动的 `vec` 变为空
+`truncate(len)`           | 将 `vec` 截断到指定长度,多余的元素被删除
+`retain(f)`               | 根据给定的函数，保留满足条件的元素
+`drain(range)`            | 删除 `vec` 中指定范围的元素,同时返回一个迭代该范围所有元素的迭代器
+`split_off(index)`        | 切分 `vec`，索引左边的元素保留在原 `vec` 中(含索引)，索引右边的元素(不含索引)在返回的 `vec` 中
+
 Rust 运算符
 -----------
 
@@ -355,7 +443,7 @@ Rust 运算符
 `e <= f` | `e` 小于或等于 `f`
 `e >= f` | `e` 大于或等于 `f`
 
----------
+----
 
 ```rust
 let (e, f) = (1, 100);
@@ -377,7 +465,7 @@ let not_equal_to = e != f;  // => true
 `a % b`  | 通过与 `b` 相除得到 `a` 的余数
 `a * b`  | `a` 与 `b` 相乘
 
-------
+----
 
 ```rust
 let (a, b) = (4, 5);
@@ -393,13 +481,13 @@ let modulus: i32 = a % b;        // => 4
 运算符 | 描述
 :- | :-
 `g & h`  | 二进制与
-`g | h`  | 二进制或
+`g \| h`  | 二进制或
 `g ^ h`  | 二进制异或
 `g ~ h`  | 二进制补码
 `g << h` | 二进制左移
 `g >> h` | 二进制右移
 
------
+----
 
 ```rust
 let (g, h) = (0x1, 0x2);
@@ -418,7 +506,7 @@ let left_shift = h << 4;  // => 32
 `c || d` | 要么是真的_(OR)_
 `!c`     | `c` 为假 _(NOT)_
 
-------
+----
 
 ```rust
 let (c, d) = (true, false);
@@ -498,7 +586,9 @@ if let["Apple", _] = arr2{
     println!("也适用于 str 数组");
 }
 ```
+
 ----
+
 ```rust
 let tuple_1 = ("India", 7, 90, 90.432);
 if let(_, 7, 9, 78.99) = tuple_1{
@@ -548,7 +638,6 @@ let day_of_week = 2;
     println!("默认!")
   }
 };
-}
 ```
 
 ### 嵌套...If 表达式
@@ -744,7 +833,9 @@ let a_int = 90; // int
 // int 到 float
 let mut type_cast = (a_int as f64);
 ```
-------
+
+----
+
 ```rust
 let orginal: char = 'I';
 // char 到 int => 73
@@ -760,7 +851,9 @@ let mut foo = 4;
 let mut borrowed_foo = &foo;
 println!("{borrowed_foo}");
 ```
-------
+
+----
+
 ```rust
 let mut bar = 3;
 let mut mutable_borrowed_bar = &mut bar;
@@ -769,7 +862,7 @@ println!("{mutable_borrowed_bar}");
 
 这里借用的值使用 `&` 运算符从值一中借用值
 
-### 取消引用
+### 解引用
 
 ```rust
 let mut borrow = 10;
@@ -777,9 +870,9 @@ let deref = &mut borrow;
 println!("{}", *deref);
 ```
 
-可以使用 `*` 操作符在 rust 中取消引用
+`*` 操作符用于解引用
 
-### 变量范围
+### 作用域
 
 ```rust
 {
@@ -789,8 +882,7 @@ println!("{}", *deref);
 println!("{a_number}");
 ```
 
-这将产生错误，因为变量 `a_number` 的范围在大括号处结束
-
+这将产生错误，因为变量 `a_number` 的生命周期在大括号处结束
 
 另见
 --------

docs/sass.md

@@ -156,7 +156,6 @@ h1 {
 Sass 混合(Mixins)
 ------
 
-
 ### 参数
 
 ```scss
@@ -264,7 +263,7 @@ green($color)
 blue($color)
 ```
 
----
+----
 
 :- | :-
 :- | :-

docs/screen.md

@@ -30,7 +30,6 @@ $ screen -ls
 $ screen -r <name/pid>
 ```
 
-
 ### 选项
 <!--rehype:wrap-class=col-span-2-->
 
@@ -45,7 +44,6 @@ $ screen -r <name/pid>
 `-X`    | screen -X -S debug kill               | 终止正在运行的会话
 <!--rehype:className=show-header-->
 
-
 ### 进入
 
 Command | Description
@@ -108,7 +106,6 @@ Command | Description
 `Ctrl-A` `H`      | 在屏幕会话中启用日志记录
 <!--rehype:className=shortcuts-->
 
-
 ### 分屏
 
 Command | Description
@@ -121,7 +118,6 @@ Command | Description
 `Ctrl-A` `Q`   | 删除除当前区域之外的所有区域
 <!--rehype:className=shortcuts-->
 
-
 ### 滚动
 
 Command | Description

docs/sed.md

@@ -109,7 +109,6 @@ $ sed 's/old/new/[flags]' [input-file]
 | `I`      | 搜索时忽略大小写  |
 | `e`      | 在命令行中替换并执行  |
 
-
 ### 循环命令
 
 | Command   | Description                                                        |

docs/semver.md

@@ -142,7 +142,6 @@ Semver 备忘清单
 1.1.2-prerelease+meta
 ```
 
-
 另见
 ----
 

docs/sketch.md

@@ -22,7 +22,6 @@ Sketch 备忘清单
 | `t` | (Text) 文本 |
 <!--rehype:className=shortcuts-->
 
-
 ### 类型
 <!--rehype:wrap-class=row-span-2-->
 
@@ -131,7 +130,6 @@ Sketch 备忘清单
 | `Fn + ↓` | 选择下面的页面 |
 <!--rehype:className=shortcuts-->
 
-
 另见
 ----
 

docs/ssh.md

@@ -99,7 +99,6 @@ $ scp user@server:/dir/* .
 `~/.ssh/known_hosts`     | 登录主机
 `~/.ssh/authorized_keys` | 授权登录密钥
 
-
 ### SCP 选项
 
 选项 | 说明
@@ -111,7 +110,6 @@ scp `-P` 8080 | 使用特定端口
 scp `-B`      | 批处理模式_（防止密码）_
 scp `-p`      | 保留时间和模式
 
-
 ### 配置示例
 
 ```toml
@@ -148,7 +146,6 @@ $ ssh -J user@proxy_host1:port1,user@proxy_host2:port2 user@remote_host3
 ```
 <!--rehype:className=wrap-text -->
 
-
 ### ssh-copy-id
 
 ```shell
@@ -229,7 +226,6 @@ $ ssh-keygen -p -f ~/.ssh/id_rsa
 - dsa
 - ecdsa
 
-
 ### known_hosts
 <!--rehype:wrap-class=col-span-2-->
 

docs/styled-components.md

@@ -3,7 +3,6 @@ styled-components 备忘清单
 
 此快速参考备忘单提供了使用 CSS in JS 工具的各种方法。
 
-
 入门
 ----
 
@@ -29,6 +28,7 @@ import styled from 'styled-components';
 ```
 
 创建一个 Title 组件
+
 ```jsx
 // 该组件将呈现具有样式的 <h1> 标签
 const Title = styled.h1`
@@ -236,7 +236,6 @@ const Demo = () => (
 );
 ```
 
-
 ### 样式对象
 
 ```jsx {2,5}

docs/stylus.md

@@ -84,6 +84,7 @@ h5 {
 }
 ```
 
+<!-- markdownlint-disable MD051 -->
 另见：下面[Mixins](#混合-Mixins)
 
 ### 变量 Variables
@@ -388,6 +389,7 @@ for i in 1..3
   .text-{i}
     font-size: lookup('font-size-' + i)
 ```
+
 ### 定义检查
 
 ```stylus {1}

docs/swift.md

@@ -444,7 +444,7 @@ switch num {
 // 打印: 7 奇数
 ```
 
-### 逻辑运算符！
+### 逻辑运算符
 
 ```swift
 !true          // false
@@ -480,6 +480,7 @@ false || false  // false
 ```swift
 false || true && false  // false
 ```
+
 `true && false` 首先计算返回 `false` 然后，表达式，`false` || `false` 评估并返回最终结果 `false`
 
 ### 控制执行顺序

docs/swiftui.md

@@ -53,7 +53,7 @@ struct AlbumDetail: View {
 - [Picker](#picker-选择控件) _(UISegmentedControl)_
 - [Stepper](#stepper-执行语义递增和递减操作的控件) _(UIStepper)_
 - [DatePicker](#datepicker-日期控件) _(UIDatePicker)_
-- [Text](#text-文本) _(NSAttributedString)无等效项)_
+- [Text](#text) _(NSAttributedString)无等效项)_
 - [Map](#map-地图界面的视图) _(MapKit)_
 - [ProgressView](#progressview-进度视图) _(UIProgressView)_
 - [Shape](#shape) / [Rectangle](#shape) / [Circle](#shape)
@@ -230,7 +230,6 @@ Map(coordinateRegion: $region,
 
 文档 - [Map](https://developer.apple.com/documentation/mapkit/map)
 
-
 Layout(布局)
 ----
 
@@ -620,7 +619,6 @@ DatePicker("Maximum Date", selection: $selectedDate,
 
 文档 - [DatePicker](https://developer.apple.com/documentation/swiftui/datepicker)
 
-
 ### Slider 滑动输入条
 
 用于从值的有界线性范围中选择一个值的控件。
@@ -673,6 +671,7 @@ NavigationView {
   }
 }
 ```
+
 您可以使用 `.pickerStyle(WheelPickerStyle())` 覆盖样式。
 
 ```swift
@@ -1200,7 +1199,6 @@ struct SheetDetail: Identifiable {
 
 文档 - [ActionSheet](https://developer.apple.com/documentation/swiftui/actionsheet)
 
-
 另见
 ---
 

docs/systemd.md

@@ -0,0 +1,110 @@
+Systemd
+===
+
+最常用的 [Systemd](https://systemd.io/) 命令备忘单快速参考
+
+命令
+----
+
+### 查看系统信息
+
+:- | -
+:- | -
+`systemctl list-dependencies` | 显示单元的依赖关系
+`systemctl list-sockets` | 列出套接字和激活的内容
+`systemctl list-jobs` | 查看活动的 systemd 作业
+`systemctl list-unit-files` | 查看单元文件及其状态
+`systemctl list-units` | 显示单位是否已加载/活动
+`systemctl get-default` | 列出默认目标(如运行级别)
+<!--rehype:className=style-list-->
+
+### 改变系统状态
+
+:- | -
+:- | -
+`systemctl reboot` | 重启系统(reboot.target)
+`systemctl poweroff` | 关闭系统(poweroff.target)
+`systemctl emergency` | 进入紧急模式(emergency.target)
+`systemctl default` | 返回默认目标(multi-user.target)
+<!--rehype:className=style-list-->
+
+### 使用服务
+<!--rehype:wrap-class=row-span-2-->
+
+:- | -
+:- | -
+`systemctl stop service` | <red>停止</red>正在运行的服务
+`systemctl start service` | 启动服务
+`systemctl restart service` | 重新启动正在运行的服务
+`systemctl reload service` | 重新加载服务中的所有配置文件
+`systemctl daemon-reload` | 必须运行以重新加载更改的单元文件
+`systemctl status` | service 查看服务是否正在运行/启用
+`systemctl --failed` | 显示未能运行的服务
+`systemctl reset-failed` | 将任何单位从失败状态重置
+`systemctl enable service` | 使服务在启动时启动
+`systemctl disable service` | 禁用服务 - 不会在启动时启动
+`systemctl show service` | 显示服务(或其他单元)的属性
+`systemctl edit service` | 创建片段以放入单元文件
+`systemctl edit --full service` | 编辑整个单元文件以进行服务
+`systemctl -H host status network` | 远程运行任何 systemctl 命令
+<!--rehype:className=style-list-->
+
+### 查看日志消息
+<!--rehype:wrap-class=col-span-2-->
+
+:- | -
+:- | -
+`journalctl` | 显示所有收集的日志消息
+`journalctl -u network.service` | 查看网络服务消息
+`journalctl -f` | 关注出现的消息
+`journalctl -k` | 仅显示内核消息
+
+### SysVinit 到 Systemd
+<!--rehype:wrap-class=col-span-3-->
+
+SysVinit | Systemd | 说明
+:- | - | -
+`service SERVICE_NAME start` | `systemctl start SERVICE_NAME` | 用于启动服务(不重启持久)
+`service SERVICE_NAME stop` | `systemctl stop SERVICE_NAME` | 用于停止服务(不永久重启)
+`service SERVICE_NAME restart` | `systemctl restart SERVICE_NAME` | 用于停止然后启动服务
+`service SERVICE_NAME reload` | `systemctl reload SERVICE_NAME` | 重新加载配置文件而不中断挂起的操作
+`service SERVICE_NAME condrestart` | `systemctl condrestart SERVICE_NAME` | 如果服务已在运行，则重新启动
+`service SERVICE_NAME status` | `systemctl status SERVICE_NAME` | 判断服务当前是否正在运行
+`chkconfig SERVICE_NAME on` | `systemctl enable SERVICE_NAME` | 打开服务，以便在下次启动时启动，或其他触发器
+`chkconfig SERVICE_NAME off` | `systemctl disable SERVICE_NAME` | 为下次重新启动或任何其他触发器关闭服务
+`chkconfig SERVICE_NAME` | `systemctl is-enabled SERVICE_NAME` | 用于检查服务是否配置为在当前环境中启动
+`chkconfig –list` | `systemctl list-unit-files –type=service` (or) <br/>`ls /etc/systemd/system/*.wants/` | 打印一个服务表，列出每个配置的运行级别打开或关闭
+`chkconfig –list \| grep 5:on` | `systemctl list-dependencies graphical.target` | 打印启动到图形模式时将启动的服务表
+`chkconfig SERVICE_NAME –list` | `ls /etc/systemd/system/*.wants/SERVICE_NAME.service` | 用于列出此服务配置为打开或关闭的级别
+`chkconfig SERVICE_NAME –add` | `systemctl daemon-reload` | 在创建新服务文件或修改任何配置时使用
+<!--rehype:className=show-header-->
+
+### 目标运行级别
+<!--rehype:wrap-class=col-span-3-->
+
+SysVinit | Systemd | 说明
+:- | - | -
+`0` | `runlevel0.target`, `poweroff.target` | 停止系统
+`1`, `s`, `single` | `runlevel1.target`, `rescue.target` | 单用户模式
+`2`, `4` | `runlevel2.target`, `runlevel4.target`, `multi-user.target` | 用户定义/站点特定的运行级别。 默认情况下，与 3 相同
+`3` | `runlevel3.target`, `multi-user.target` | 多用户，非图形。 用户通常可以通过多个控制台或通过网络登录
+`5` | `runlevel5.target`, `graphical.target` | 多用户，图形。 通常具有运行级别 3 的所有服务以及图形登录
+`6` | `runlevel6.target`, `reboot.target` | 重启
+`emergency` | `emergency.target` | 应急外壳
+<!--rehype:className=show-header-->
+
+### 更改运行级别
+<!--rehype:wrap-class=col-span-3-->
+
+SysVinit | Systemd | 说明
+:- | - | -
+`telinit 3` | `systemctl isolate multi-user.target` <br/>OR `systemctl isolate runlevel3.target`<br/>OR `telinit 3` | 更改为多用户运行级别
+`sed s/^id:.*:initdefault:/id:3:initdefault:/` | `ln -sf /lib/systemd/system/multi-user.target /etc/systemd/system/default.target` | 设置为在下次重新启动时使用多用户运行级别
+<!--rehype:className=show-header-->
+
+另见
+---
+
+- [Systemd 官网](https://systemd.io/) _(systemd.io)_
+- [Systemd Cheat Sheet](https://access.redhat.com/sites/default/files/attachments/12052018_systemd_6.pdf) _(access.redhat.com)_
+- [Systemd Cheat Sheet](https://www.linuxtrainingacademy.com/systemd-cheat-sheet/) _(linuxtrainingacademy.com)_

docs/tmux.md

@@ -0,0 +1,243 @@
+Tmux 备忘清单
+===
+
+最常用的快捷键和命令的 tmux 备忘单快速参考
+
+Tmux CLI
+-------
+
+### 新会话
+<!--rehype:wrap-class=row-span-2-->
+
+开始一个新的会话
+
+```bash
+$ tmux
+$ tmux new
+$ tmux new-session
+
+:new
+```
+
+开始一个名为 myname 的新会话
+
+```bash
+$ tmux new -s myname
+
+:new -s myname
+```
+
+显示所有会话，或者 <kbd>Ctrl</kbd> + <kbd>b</kbd> + <kbd>s</kbd> 快捷键
+
+```bash
+$ tmux ls
+$ tmux list-sessions
+```
+
+### 附加会话
+<!--rehype:wrap-class=row-span-2-->
+
+附加到上一个会话
+
+```bash
+$ tmux a
+$ tmux at
+$ tmux attach
+$ tmux attach-session
+```
+
+附加到命名
+
+```bash
+$ tmux a -t myname
+```
+
+附加到名为 myname 的会话
+
+```bash
+$ tmux a -t myname
+$ tmux at -t myname
+$ tmux attach -t myname
+$ tmux attach-session -t myname
+```
+
+### 终止会话
+
+按名称终止会话
+
+```bash
+$ tmux kill-ses -t myname # 杀死/删除会话
+$ tmux kill-session -t myname
+```
+
+杀死/删除除当前会话之外的所有会话
+
+```bash
+$ tmux kill-ses -a
+```
+
+杀死/删除除 myname 之外的所有会话
+
+```bash
+$ tmux kill-ses -a -t myname
+```
+
+### Tmux 帮助
+
+```bash
+$ tmux info
+```
+
+### 配置
+
+重新加载配置
+
+```bash
+$ tmux source-file ~/.tmu­x.conf
+```
+
+显示配置
+
+```bash
+$ tmux show-options -g
+```
+
+### 复制模式
+
+命令 | 描述
+:- | -
+`Ctrl+b` `[` | 进入复制模式
+`<Space>`    | 开始选择
+`Enter`      | 复制选择
+`q`          | 退出复制模式
+`Ctrl+b` `]` | 粘贴 buffer_0 的内容
+<!--rehype:className=shortcuts-->
+
+主要作用类似于在 [Vim](./vim.md#动作) 中选择文本
+
+Tmux 快捷键
+----------
+
+### 入门
+<!--rehype:style=background:rgb(245 158 11/1);-->
+
+快捷键/命令 | 描述
+:- | -
+| `Ctrl+b` `?` | List all shortcuts |
+<!--rehype:className=shortcuts show-header-->
+
+----
+
+显示每个会话、窗口、窗格等
+
+```bash
+$ tmux info
+```
+
+### 窗格（拆分）
+<!--rehype:wrap-class=row-span-2-->
+
+快捷键/命令 | 描述
+:- | -
+`Ctrl+b` `"` _/_ `%`   | 水平分割/垂直
+`Ctrl+b` `!`           | 窗格 -> 窗口
+`Ctrl+b` `x`           | 杀死窗格
+`Ctrl+b` \<Arrow>      | 导航窗格
+`Ctrl+b` \<Space>      | 切换布局
+`Ctrl+b` `{` _/_ `}`   | 向左/向右移动
+`Ctrl+b` `o`           | 转到下一个窗格
+`Ctrl+b` `z`           | 切换全屏
+`Ctrl+b` `;`           | 切换最后一个窗格
+`Ctrl+b` `q`           | 显示号码
+`Ctrl+b` `q` `0`...`9` | 转到 # 窗格
+<!--rehype:className=shortcuts-->
+
+### Window (Tabs)
+<!--rehype:wrap-class=row-span-2-->
+
+快捷键/命令 | 描述
+:- | -
+`Ctrl+b` `c`         | 创建窗口
+`Ctrl+b` `p` _/_ `n` | 上一个/下一个窗口
+`Ctrl+b` `"` _/_ `%` | 水平分割/垂直
+`Ctrl+b` `w`         | 列表窗口
+`Ctrl+b` `,`         | 重命名窗口
+`Ctrl+b` `f`         | 查找窗口
+`Ctrl+b` `l`         | 最后一个窗口
+`Ctrl+b` `.`         | 移动窗口
+`Ctrl+b` `&`         | 关闭窗口
+`Ctrl+b` `0`...`9`   | 转到#窗口
+<!--rehype:className=shortcuts-->
+
+### 会话（Windows 组）
+
+快捷键/命令 | 描述
+:- | -
+`Ctrl+b` `d`         | <red>从会话中分离</red>
+`Ctrl+b` `s`         | 显示所有会话
+`Ctrl+b` `$`         | 重命名会话
+`Ctrl+b` `(` _/_ `)` | 上一届/下一届
+<!--rehype:className=shortcuts-->
+
+Tmux 命令模式
+-----------
+
+### 用法
+<!--rehype:style=background:rgb(245 158 11/1);-->
+
+快捷键/命令 | 描述
+:- | -
+`Ctrl+b` `:` | 进入命令模式
+<!--rehype:className=shortcuts-->
+
+### 调整大小
+
+快捷键/命令 | 描述
+:- | -
+`resize-pane -D 20` | 缩小尺寸
+`resize-pane -U 20` | 调整大小
+`resize-pane -L 20` | 向左调整大小
+`resize-pane -R 20` | 向右调整大小
+
+### 清单
+
+快捷键/命令 | 描述
+:- | -
+`list-keys`    | 所有命令
+`list-panes`   | 所有窗格
+`list-windows` | 所有窗口
+
+### 复印
+
+快捷键/命令 | 描述
+:- | -
+`list-buffers`       | 列出所有缓冲区
+`show-buffer`        | 显示 #0 内容
+`capture-pane`       | 窗格的副本
+`choose-buffer`      | 显示和粘贴
+`save-buffer a.txt`  | 保存到文件
+`delete-buffer -b 1` | 删除缓冲区 1
+
+### 环境
+
+快捷键/命令 | 描述
+:- | -
+`set -g OPTION`        | 为所有会话设置
+`setw -g OPTION`       | 为所有窗口设置
+`setw -g mode-keys vi` | 启用 vi 模式
+`set -g prefix C-a`    | 设置前缀
+
+### 杂项
+
+快捷键/命令 | 描述
+:- | -
+`swap-pane -s 3 -t 1`    | 交换窗格
+`swap-window -t -1`      | 向左移动
+`setw synchronize-panes` | 同步窗格
+`join-pane -t :#`        | 加入窗格
+
+另见
+---
+
+- [Tmux 开源仓库](https://github.com/tmux/tmux) _(github.com)_
+- [Tmux Cheat Sheet & Quick Reference](https://tmuxcheatsheet.com/) _(tmuxcheatsheet.com)_

docs/toml.md

@@ -44,7 +44,6 @@ int3 = -21
 integerRange = 64
 ```
 
-
 ### 浮点数
 
 ```toml
@@ -80,7 +79,7 @@ str2 = "You can \"quote\" me."
 str3 = "Name\tJos\u00E9\nLoc\tSF."
 ```
 
-See: [Strings](#toml-strings)
+See: [Strings](#字符串)
 
 ### Table
 
@@ -224,6 +223,7 @@ type = "pug"
 [foo.bar.baz]
 bat = "hi"
 ```
+
 #### ↓ 等效的 JSON
 
 ```json
@@ -247,7 +247,7 @@ bat = "hi"
 [ j . "ʞ" .'l' ] # same as [j."ʞ".'l']
 ```
 
-### Inline Table
+### 内联表
 <!--rehype:wrap-class=col-span-2-->
 
 ```toml
@@ -263,6 +263,5 @@ animal = { type.name = "pug" }
 - [Learn X in Y minutes](https://learnxinyminutes.com/docs/toml/) _(learnxinyminutes.com)_
 - [Better TOML VSCode 插件](https://marketplace.visualstudio.com/items?itemName=bungcip.better-toml) _(visualstudio.com)_
 
-
 - [INI 格式配置文件备忘清单](./ini.md) _(jaywcjlove.github.io)_
 - [YAML 格式配置文件备忘清单](./yaml.md) _(jaywcjlove.github.io)_

docs/typescript.md

@@ -240,7 +240,6 @@ type Data = typeof data
 
 通过 typeof 运算符重用来自现有 JavaScript 运行时值的类型。
 
-
 ### 从函数返回类型
 
 ```ts
@@ -1077,11 +1076,9 @@ console.log(fiveToHex());
 
 从 Type 中移除 this 参数。 如果 Type 没有显式声明此参数，则结果只是 Type。 否则，从 Type 创建一个不带此参数的新函数类型。 泛型被删除，只有最后一个重载签名被传播到新的函数类型中。
 
-
 JSX
 ----
 
-
 ### JSX 介绍
 
 JSX 规范是对 ECMAScript 的类似 XML 的语法扩展。
@@ -1233,7 +1230,6 @@ function NotAValidFactoryFunction() {
 
 默认情况下，`JSX.ElementClass` 是 {}，但可以对其进行扩展，以将 `JSX` 的使用限制为仅限于符合适当接口的类型。
 
-
 ### 类组件
 <!--rehype:wrap-class=col-span-2-->
 

docs/vim.md

@@ -276,7 +276,6 @@ Vim 文本对象
 ### 用法
 <!--rehype:style=background:#d7a100;-->
 
-
 快捷方式 | 说明
 :- | -
 `v`      | &nbsp; &nbsp; &nbsp; &nbsp; <pur>i</pur> _/_ <pur>a</pur> | <yel>p</yel>
@@ -435,6 +434,7 @@ Vim 搜索和替换
 ```vim
 :%s/{pattern}/{str}/[flags]
 ```
+
 ---
 
 :- | -
@@ -516,7 +516,6 @@ Vim 搜索和替换
 ### 例子
 <!--rehype:wrap-class=col-span-2-->
 
-
 ```shell
 :s/a\|b/xxx\0xxx/g               # 将 "a b"      修改为 "xxxaxxx xxxbxxx"
 :s/test/\U& file/                # 将 "test"     修改为 "TEST FILE"

docs/vscode.md

@@ -65,7 +65,6 @@ VSCode 备忘清单
 | `Ctrl` `M`           | 切换 Tab 移动焦点   |
 <!--rehype:className=shortcuts-->
 
-
 ### 搜索和替换
 
 | -                         | -                               |
@@ -115,7 +114,6 @@ VSCode 备忘清单
 | `Ctrl` `K` `M`              | 更改文件语言      |
 <!--rehype:className=shortcuts-->
 
-
 ### 编辑管理
 
 | -                                | -                        |
@@ -170,7 +168,6 @@ VSCode 备忘清单
 | `Ctrl` `K` `Z`     | Zen 模式（Esc Esc 退出）                    |
 <!--rehype:className=shortcuts-->
 
-
 ### 调试
 
 | -                              | -                             |

docs/vue.md

@@ -3,7 +3,6 @@ Vue 3 备忘清单
 
 渐进式 JavaScript 框架 [Vue 3](https://cn.vuejs.org/) 备忘清单的快速参考列表，包含常用 API 和示例。
 
-
 入门
 ---
 
@@ -209,7 +208,6 @@ data() {
 </span>
 ```
 
-
 ### 指令 Directives
 
 ```html

docs/vue2.md

@@ -550,7 +550,6 @@ data: {
 </ul>
 ```
 
-
 ```js
 var example1 = new Vue({
   el: '#example-1',
@@ -1195,6 +1194,7 @@ vm.selected.number // => 123
 <!--rehype:wrap-class=row-span-3-->
 
 - 将 `HTML`/`CSS`/`JS` 三部分存放到一个 `Hello.vue` 文件中
+
   ```html
   <template>
     <p>{{ title }} World!</p>
@@ -1222,7 +1222,9 @@ vm.selected.number // => 123
     }
   </style>
   ```
+
 - 使用 `Hello.vue` 组件
+
   ```html
   <script>
     import Vue from "vue";
@@ -1681,7 +1683,7 @@ Vue.component('alert-box', {
 `leave-active-class` | [#](https://v2.cn.vuejs.org/v2/guide/transitions.html#自定义过渡的类名)
 `leave-to-class` _(2.1.8+)_ | [#](https://v2.cn.vuejs.org/v2/guide/transitions.html#自定义过渡的类名)
 
-----
+---
 
 ```html
 <transition
@@ -2026,7 +2028,6 @@ Vue 2 API 参考
 `v-on:click.passive` _(2.3.0)_ [#](https://v2.cn.vuejs.org/v2/api/#v-on) | 以 { passive: true } 模式添加侦听器
 <!--rehype:className=style-list-->
 
-
 ### v-on (鼠标)修饰符
 
 :- | :-

docs/xcode.md

@@ -25,7 +25,6 @@ Xcode
 `Cmd + {`  | 下一个选项卡
 <!--rehype:className=shortcuts-->
 
-
 ### 导航
 <!--rehype:wrap-class=row-span-2-->
 
@@ -55,7 +54,6 @@ Xcode
 `Cmd + K`           | 清除控制台
 <!--rehype:className=shortcuts-->
 
-
 ### 导航器（左侧面板）
 
 快捷键 | 描述
@@ -67,7 +65,6 @@ Xcode
 `double click`               | 在新窗口中打开
 <!--rehype:className=shortcuts-->
 
-
 ### 编辑
 
 快捷键 | 描述
@@ -83,8 +80,6 @@ Xcode
 `Cmd + Option + ]`      | 下移线
 <!--rehype:className=shortcuts-->
 
-
-
 ### 实用程序（右面板）
 
 快捷键 | 描述
@@ -93,7 +88,6 @@ Xcode
 `Cmd + Option + 1-9`   | 转到选项卡
 <!--rehype:className=shortcuts-->
 
-
 ### 调试和运行
 
 快捷键 | 描述

docs/xpath.md

@@ -118,7 +118,6 @@ $x('//a[text()="XPath"]')[0].click()
 ### 运算符
 <!--rehype:wrap-class=col-span-2-->
 
-
 运算符 | 说明  | 示例
 :- | - | -
 `\|`  | 计算两个节点集 | `//book \| //cd`
@@ -137,8 +136,6 @@ $x('//a[text()="XPath"]')[0].click()
 `mod` | 模数（除法余数） | `5` mod `2`
 <!--rehype:className=show-header-->
 
-
-
 XPath 表达式
 -----------
 
@@ -149,7 +146,6 @@ XPath 表达式
 | `//` | `ul` | `/`  | `a[@id='link']` |
 | Axis | Step | Axis | Step            |
 
-
 ### 前缀
 
 | 前缀    | 例子                  | 意思是    |
@@ -202,6 +198,7 @@ XPath Predicates(谓词)
 //ul[count(li) > 2]
 //ul[count(li[@class='hide']) > 0]
 ```
+
 ```bash
 # 返回具有 `<li>` 子级的 `<ul>`
 //ul[li]
@@ -251,6 +248,7 @@ text()            # //button[text()="Submit"]
 lang(str)
 namespace-uri()
 ```
+
 ```bash
 count()           # //table[count(tr)=1]
 position()        # //ol/li[position()=2]
@@ -429,5 +427,5 @@ count(//*)          # 计算所有元素
 另见
 --------
 
-* [Devhints](https://devhints.io/xpath) _(devhints.io)_
-* [Xpath test bed](http://www.whitebeam.org/library/guide/TechNotes/xpathtestbed.rhtm) _(whitebeam.org)_
+- [Devhints](https://devhints.io/xpath) _(devhints.io)_
+- [Xpath test bed](http://www.whitebeam.org/library/guide/TechNotes/xpathtestbed.rhtm) _(whitebeam.org)_

docs/yaml.md

@@ -18,7 +18,6 @@ YAML 备忘清单
 - Ansible playbook 是 YAML 文件
 <!--rehype:className=style-round-->
 
-
 ### 标量类型
 <!--rehype:wrap-class=row-span-2-->
 
@@ -350,7 +349,6 @@ set2: !!set {'one', "two"}
 
 集合表示为一个映射，其中每个键都与一个空值相关联
 
-
 ### 有序映射
 
 ```yaml
@@ -450,7 +448,6 @@ YAML 参考
 | `#` | 一次性评论指示器 |
 | <code>\`@</code> | 两者都保留供将来使用 |
 
-
 ### 核心类型（默认自动标签）
 <!--rehype:wrap-class=row-span-2-->
 
@@ -479,6 +476,7 @@ YAML 参考
 <!--rehype:className=cols-3 style-none-->
 
 #### C
+
 - `\0` (NUL)
 - `\a` (BEL)
 - `\b` (BS)

docs/yum.md

@@ -394,7 +394,7 @@ yum list available --disablerepo=epel
 yum install --downloadonly vsftpd
 ```
 
----
+----
 
 :- | -
 :- | -

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcj/reference",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "为开发人员分享快速参考备忘单(主要是方便自己)。",
   "author": "jaywcjlove",
   "license": "MIT",
@@ -10,7 +10,8 @@
     "prepare": "husky install",
     "build": "node scripts/build.mjs",
     "start": "node scripts/watch.mjs",
-    "prettier": "prettier --write '**/*.{mjs,css,json,prettierrc,lintstagedrc}'"
+    "prettier": "prettier --write '**/*.{mjs,css,json,prettierrc,lintstagedrc}'",
+    "markdownlint": "npx markdownlint-cli --fix ./docs/*.md"
   },
   "repository": {
     "type": "git",
@@ -26,12 +27,19 @@
     "fs-extra": "^10.1.0",
     "husky": "^8.0.1",
     "lint-staged": "^13.0.3",
+    "markdownlint-cli": "^0.32.2",
     "prettier": "^2.7.1",
     "recursive-readdir-files": "^2.3.0",
     "rehype-autolink-headings": "^6.1.1",
     "rehype-document": "^6.1.0",
+    "rehype-parse": "^8.0.4",
+    "rehype-raw": "^6.1.1",
+    "rehype-rewrite": "^3.0.6",
     "rehype-slug": "^5.0.1",
-    "remark-gemoji": "^7.0.1"
+    "remark-gemoji": "^7.0.1",
+    "unified": "^10.1.2",
+    "unist-util-visit": "^4.1.1",
+    "vfile": "^5.3.5"
   },
   "engines": {
     "node": ">=16.0.0"

scripts/assets/graphql.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg" height="1em" width="1em">
+  <path d="m2.61 4.432 4.142-2.417-.504-.864-4.143 2.417.504.864ZM2 9.5v-4H1v4h1Zm6.248-7.485 4.143 2.417.504-.864-4.143-2.417-.504.864ZM13 5.5v4h1v-4h-1Zm-.252 4.86-4.5 2.625.504.864 4.5-2.625-.504-.864Zm-5.996 2.625-4.143-2.417-.504.864 4.143 2.417.504-.864ZM6.584 1.973l-5 7.5.832.554 5-7.5-.832-.554Zm6.832 7.5-5-7.5-.832.554 5 7.5.832-.554ZM2.5 11h10v-1h-10v1Zm5-9a.5.5 0 0 1-.5-.5H6A1.5 1.5 0 0 0 7.5 3V2Zm.5-.5a.5.5 0 0 1-.5.5v1A1.5 1.5 0 0 0 9 1.5H8ZM7.5 1a.5.5 0 0 1 .5.5h1A1.5 1.5 0 0 0 7.5 0v1Zm0-1A1.5 1.5 0 0 0 6 1.5h1a.5.5 0 0 1 .5-.5V0Zm6 5a.5.5 0 0 1-.5-.5h-1A1.5 1.5 0 0 0 13.5 6V5Zm.5-.5a.5.5 0 0 1-.5.5v1A1.5 1.5 0 0 0 15 4.5h-1Zm-.5-.5a.5.5 0 0 1 .5.5h1A1.5 1.5 0 0 0 13.5 3v1Zm0-1A1.5 1.5 0 0 0 12 4.5h1a.5.5 0 0 1 .5-.5V3Zm0 8a.5.5 0 0 1-.5-.5h-1a1.5 1.5 0 0 0 1.5 1.5v-1Zm.5-.5a.5.5 0 0 1-.5.5v1a1.5 1.5 0 0 0 1.5-1.5h-1Zm-.5-.5a.5.5 0 0 1 .5.5h1A1.5 1.5 0 0 0 13.5 9v1Zm0-1a1.5 1.5 0 0 0-1.5 1.5h1a.5.5 0 0 1 .5-.5V9Zm-6 5a.5.5 0 0 1-.5-.5H6A1.5 1.5 0 0 0 7.5 15v-1Zm.5-.5a.5.5 0 0 1-.5.5v1A1.5 1.5 0 0 0 9 13.5H8Zm-.5-.5a.5.5 0 0 1 .5.5h1A1.5 1.5 0 0 0 7.5 12v1Zm0-1A1.5 1.5 0 0 0 6 13.5h1a.5.5 0 0 1 .5-.5v-1Zm-6-1a.5.5 0 0 1-.5-.5H0A1.5 1.5 0 0 0 1.5 12v-1Zm.5-.5a.5.5 0 0 1-.5.5v1A1.5 1.5 0 0 0 3 10.5H2Zm-.5-.5a.5.5 0 0 1 .5.5h1A1.5 1.5 0 0 0 1.5 9v1Zm0-1A1.5 1.5 0 0 0 0 10.5h1a.5.5 0 0 1 .5-.5V9Zm0-4a.5.5 0 0 1-.5-.5H0A1.5 1.5 0 0 0 1.5 6V5Zm.5-.5a.5.5 0 0 1-.5.5v1A1.5 1.5 0 0 0 3 4.5H2ZM1.5 4a.5.5 0 0 1 .5.5h1A1.5 1.5 0 0 0 1.5 3v1Zm0-1A1.5 1.5 0 0 0 0 4.5h1a.5.5 0 0 1 .5-.5V3Z" fill="currentColor" />
+</svg>

scripts/assets/ruby.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="currentColor" height="1em" width="1em">
+  <path d="M26.875.109c4.043.703 5.193 3.464 5.104 6.36L32 6.426l-1.817 23.855-23.641 1.62c-1.963-.084-6.344-.261-6.541-6.38l2.193-4 3.76 8.781.672 1.561 3.739-12.192-.041.011.021-.043 12.339 3.944-1.86-7.245-1.317-5.199 11.755-.76-.817-.677-8.443-6.885 4.88-2.719zM0 25.453v.031-.036zM6.839 6.765c4.749-4.713 10.875-7.495 13.229-5.12 2.348 2.371-.141 8.141-4.896 12.844-4.751 4.713-10.803 7.647-13.151 5.276-2.355-2.364.057-8.287 4.817-13z"/>
+</svg>

scripts/assets/systemd.svg

@@ -0,0 +1,2 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" height="1em" width="1em" viewBox="0 0 86 26">
+<path d="M10,0 L10,4 L4,4 L4,22 L10,22 L10,26 L0,26 L0,0 L10,0 Z M86,0 L86,26 L76,26 L76,22 L82,22 L82,4 L76,4 L76,0 L86,0 Z M63,3 L63,23 L45,13 L63,3 Z M30,4 C34.9705627,4 39,8.02943725 39,13 C39,17.9705627 34.9705627,22 30,22 C25.0294373,22 21,17.9705627 21,13 C21,8.02943725 25.0294373,4 30,4 Z"/></svg>

scripts/assets/tmux.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" fill="currentColor" height="1em" width="1em">
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M13.5 1h-12l-.5.5v13l.5.5h12l.5-.5v-13l-.5-.5zM7 7.5V13H2V2h5v5.5zm6 5.5H8V8h5v5zm0-6H8V2h5v5z"/>
+</svg>

scripts/style/style.css

@@ -165,6 +165,9 @@ menu {
 yel {
   color: var(--color-prettylights-syntax-variable);
 }
+red {
+  color: var(--color-danger-fg);
+}
 pur {
   color: var(--color-prettylights-syntax-entity);
 }
@@ -705,7 +708,7 @@ body:not(.home) .h2wrap-body > .wrap:hover .h3wrap > h3 a::after {
   letter-spacing: 0.05em;
 }
 
-.wrap-header.h3wrap > .wrap-body p,
+.wrap-header.h3wrap > .wrap-body > p,
 .h3wrap-body p {
   margin: 0px;
   width: 100%;
@@ -717,7 +720,7 @@ body:not(.home) .h2wrap-body > .wrap:hover .h3wrap > h3 a::after {
   background-color: var(--color-bg-subtle);
 }
 
-.wrap-header.h3wrap > .wrap-body p:first-child:before {
+.wrap-header.h3wrap > .wrap-body > p:first-child:before {
   background-color: var(--color-bg-subtle);
   color: rgb(30 41 59/0);
   content: '-';
@@ -729,13 +732,13 @@ body:not(.home) .h2wrap-body > .wrap:hover .h3wrap > h3 a::after {
   border-radius: 0.5rem 0.5rem 0 0;
 }
 
-.wrap-header.h3wrap > .wrap-body p:not(:first-child):last-child,
+.wrap-header.h3wrap > .wrap-body > p:not(:first-child):last-child,
 .h3wrap-body p:not(:first-child):last-child {
   margin-top: auto;
   border-radius: 0 0 0.5rem 0.5rem;
 }
 
-.wrap-header.h3wrap > .wrap-body :not(:first-child):last-child {
+.wrap-header.h3wrap > .wrap-body > :not(:first-child):last-child {
   border-radius: 0 0 0.5rem 0.5rem;
 }