Skip to content

Commit e3533a0

Browse files
committed
docs: update manual pages links to manned.org 📚
1 parent 8f2487e commit e3533a0

File tree

3 files changed

+11
-11
lines changed

3 files changed

+11
-11
lines changed

README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -136,13 +136,13 @@ PS:
136136

137137
在这个库中的`Shell`脚本:
138138

139-
- 统一使用`Bash 3+`
139+
- 统一使用`Bash 3.2+`
140140
- 面向生产环境,尽可能使用严谨安全的开发方式。
141141

142142
`Shell``Bash`的原因是:
143143

144144
- 目前仍然是主流的`Shell`,并且在不同环境基本上都缺省部署了。
145-
-[`Google``Shell`风格指南](https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/background/)中,明确说到了:`Bash`**唯一**被允许执行的`shell`脚本语言。
145+
-[`Google``Shell`风格指南](https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/background.html#shell)中,明确说到了:`Bash`**唯一**被允许执行的`shell`脚本语言。
146146
- 统一用`Bash`,可以避免不同`Shell`之间差异所带来的风险与没有收益的复杂性。
147147
- 有大量的`Shell`实现,`sh``bash``zsh``fish``csh``tcsh``ksh``ash``dash`……
148148
- 不同的`Shell`有各种差异,深坑勿入。
@@ -155,7 +155,7 @@ PS: 虽然交互`Shell`个人已经使用`Zsh` + [`oh-my-zsh`](https://ohmyz.sh/
155155
> 更多资料参见 [子文档](docs/developer-guide.md)
156156
157157
- 🛠️ 开发规范与工具
158-
- [`Google Shell Style Guide`](https://google.github.io/styleguide/shell.xml) | [中文版](https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/background/)
158+
- [`Google Shell Style Guide`](https://google.github.io/styleguide/shell.xml) | [中文版](https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/contents.html)
159159
- [`koalaman/shellcheck`](https://github.com/koalaman/shellcheck): `ShellCheck`, a static analysis tool for shell scripts
160160
- [`mvdan/sh(shfmt)`](https://github.com/mvdan/sh): `shfmt` formats shell programs
161161
- 👷 **`Bash/Shell`最佳实践与安全编程**文章
@@ -172,7 +172,7 @@ PS: 虽然交互`Shell`个人已经使用`Zsh` + [`oh-my-zsh`](https://ohmyz.sh/
172172
力荐!说明简单直接结构体系的佳作,专业`Bash`编程必备!且16年的第二版更新到了新版的`Bash 4`
173173
- [《学习bash》](https://book.douban.com/subject/1241361/) 上面那本的展开版
174174
- 官方资料
175-
- [`bash man`](https://linux.die.net/man/1/bash) | [中文版](http://ahei.info/chinese-bash-man.htm)
175+
- [`bash man`](https://manned.org/bash) | [中文版](http://ahei.info/chinese-bash-man.htm)
176176
- [Bash Reference Manual - gnu.org](http://www.gnu.org/software/bash/manual/) | [中文版](https://yiyibooks.cn/Phiix/bash_reference_manual/bash%E5%8F%82%E8%80%83%E6%96%87%E6%A1%A3.html)
177177
Bash参考手册,讲得全面且有深度,比如会全面地讲解不同转义的区别、命令的解析过程,这有助统一深入的方式认识Bash整个执行方式和过程。这些内容在其它书中往往不会讲(因为复杂难于深入浅出的讲解),但却一通百通的关键。
178178
- [Advanced Bash-Scripting Guide](https://hangar118.sdf.org/p/bash-scripting-guide/index.html): An in-depth exploration of the art of shell scripting.

docs/developer-guide.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# 📚 `Shell`学习与开发的资料
22

3-
- 开发规范与工具
4-
- [**_`Google Shell Style Guide`_**](https://google.github.io/styleguide/shell.xml) | [中文版](https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/background/)
3+
- 🛠️ 开发规范与工具
4+
- [`Google Shell Style Guide`](https://google.github.io/styleguide/shell.xml) | [中文版](https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/contents.html)
55
- [`koalaman/shellcheck`](https://github.com/koalaman/shellcheck): `ShellCheck`, a static analysis tool for shell scripts
66
- [`mvdan/sh(shfmt)`](https://github.com/mvdan/sh): `shfmt` formats shell programs
77
- 👷 **`Bash/Shell`最佳实践与安全编程**文章
@@ -10,7 +10,7 @@
1010
- [编写可靠shell脚本的八个建议 - xshell.net](https://www.xshell.net/shell/1577.html)
1111
- [Shell 编码风格 - 团子的小窝](http://kodango.com/shell-script-style)
1212
- [Bash 优良编程实践](https://www.techug.com/post/bash-practice.html)
13-
- [不要自己去指定sh的方式去执行脚本](https://github.com/oldratlee/useful-scripts/issues/57#issuecomment-326485965)
13+
- [不要自己去指定`sh`的方式去执行脚本](https://github.com/oldratlee/useful-scripts/issues/57#issuecomment-326485965)
1414
- 🎶 **Tips**
1515
- [让你提升命令行效率的 Bash 快捷键 【完整版】](https://linuxtoy.org/archives/bash-shortcuts.html)
1616
补充:`ctrl + x, ctrl + e` 就地打开文本编辑器来编辑当前命令行,对于复杂命令行特别有用
@@ -32,7 +32,7 @@
3232
力荐!说明简单直接结构体系的佳作,专业`Bash`编程必备!且16年的第二版更新到了新版的`Bash 4`
3333
- [《学习bash》](https://book.douban.com/subject/1241361/) 上面那本的展开版
3434
- 官方资料
35-
- [`bash man`](https://linux.die.net/man/1/bash) | [中文版](http://ahei.info/chinese-bash-man.htm)
35+
- [`bash man`](https://manned.org/bash) | [中文版](http://ahei.info/chinese-bash-man.htm)
3636
- [Bash Reference Manual - gnu.org](http://www.gnu.org/software/bash/manual/) | [中文版](https://yiyibooks.cn/Phiix/bash_reference_manual/bash%E5%8F%82%E8%80%83%E6%96%87%E6%A1%A3.html)
3737
Bash参考手册,讲得全面且有深度,比如会全面地讲解不同转义的区别、命令的解析过程,这有助统一深入的方式认识Bash整个执行方式和过程。这些内容在其它书中往往不会讲(因为复杂难于深入浅出的讲解),但却一通百通的关键。
3838
- [Advanced Bash-Scripting Guide](https://hangar118.sdf.org/p/bash-scripting-guide/index.html): An in-depth exploration of the art of shell scripting.

docs/shell.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ Options:
122122
彩色`cat`/`tac`出文件行,方便人眼区分不同的行。
123123
支持`Linux``Mac``Windows``cygwin``MSSYS`)。
124124
125-
命令支持选项、功能和使用方式与[`cat`](https://linux.die.net/man/1/cat)/[`tac`](https://linux.die.net/man/1/cat)命令完全一样。
125+
命令支持选项、功能和使用方式与[`cat`](https://manned.org/cat)/[`tac`](https://manned.org/tac)命令完全一样。
126126
文件操作在实现上完全代理给了`cat`/`tac`命令。
127127
128128
- 命令名`coat`的意思是`COlorful cAT`;同时单词`coat`是外套,而彩色的输出行就像件漂亮的外套~ 🌈 😆
@@ -552,9 +552,9 @@ colorEchoWithoutNewLine "4;33;40" "Hello world!" "Hello Hell!"
552552
命令行选项解析库,加强支持选项有多个值(即数组)。
553553
支持`Linux``Mac``Windows``cygwin``MSSYS`)。
554554
555-
自己写一个命令行选项解析函数,是因为[`bash`](http://linux.die.net/man/1/bash)的`builtin`命令[`getopts`](http://linux.die.net/man/1/getopts)和加强版本命令[`getopt`](http://linux.die.net/man/1/getopt)都不支持数组的值。
555+
自己写一个命令行选项解析函数,是因为[`bash`](https://manned.org/bash)的`builtin`命令[`getopts`](https://manned.org/man/getopts.1)和加强版本命令[`getopt`](https://manned.org/getopt)都不支持数组的值。
556556
557-
指定选项的多个值(即数组)的风格模仿[`find`](http://linux.die.net/man/1/find)命令的`-exec`选项:
557+
指定选项的多个值(即数组)的风格模仿[`find`](https://manned.org/find)命令的`-exec`选项:
558558
559559
```bash
560560
$ find . -name \*.txt -exec echo "find file: " {} \;

0 commit comments

Comments
 (0)