From 34458c1c1cdc424d5d933c34b2401ce7c32e643c Mon Sep 17 00:00:00 2001 From: Zhang Peng Date: Thu, 24 Oct 2019 18:13:48 +0800 Subject: [PATCH] update docs --- .editorconfig | 25 +- .gitattributes | 2 + .gitignore | 40 +- README.md | 4 +- docs/README.md | 4 +- docs/coverpage.md | 2 +- docs/git/README.md | 2 +- docs/index.html | 465 +++++++++++----------- docs/linux/cli/Linux文件目录管理.md | 2 +- docs/linux/cli/Linux软件管理.md | 2 +- docs/linux/ops/linux典型运维应用.md | 2 +- docs/linux/ops/shell.md | 50 +-- docs/linux/soft/nexus-ops.md | 2 +- docs/mac.md | 2 +- 14 files changed, 317 insertions(+), 287 deletions(-) diff --git a/.editorconfig b/.editorconfig index 610df05..c7ca29b 100644 --- a/.editorconfig +++ b/.editorconfig @@ -1,30 +1,27 @@ -# EditorConfig helps developers define and maintain consistent -# coding styles between different editors and IDEs -# http://editorconfig.org -# 所有文件换行以 Unix like 风格(LF),win 格式特定的除外(bat) -# 缩进 java 4 个空格,其他所有文件 2 个空格 +# EditorConfig 用于在 IDE 中检查代码的基本 Code Style +# @see: https://editorconfig.org/ + +# 配置说明: +# 所有文件换行使用 Unix 风格(LF),*.bat 文件使用 Windows 风格(CRLF) +# java / sh 文件缩进 4 个空格,其他所有文件缩进 2 个空格 root = true [*] -# Unix-style newlines with a newline ending every file end_of_line = lf - -# Change these settings to your own preference -indent_style = space indent_size = 2 - -# We recommend you to keep these unchanged +indent_style = tab +max_line_length = 120 charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true -[*.bat] +[*.{bat, cmd}] end_of_line = crlf -[*.{java, sh}] -indent_style = tab +[*.{java, groovy, kt, sh}] indent_size = 4 [*.md] +max_line_length = 0 trim_trailing_whitespace = false diff --git a/.gitattributes b/.gitattributes index 1e3aabc..07962a1 100644 --- a/.gitattributes +++ b/.gitattributes @@ -70,6 +70,8 @@ *.pdf binary *.doc binary *.docx binary +*.ppt binary +*.pptx binary *.xls binary *.xlsx binary *.xmind binary diff --git a/.gitignore b/.gitignore index a684e5e..b887576 100644 --- a/.gitignore +++ b/.gitignore @@ -1,8 +1,42 @@ -################ JAVASCRIPT ################ +# --------------------------------------------------------------------- +# more gitignore templates see https://github.com/github/gitignore +# --------------------------------------------------------------------- + +# ------------------------------- java ------------------------------- +# compiled folders +classes +target +logs +.mtj.tmp/ + +# compiled files +*.class + +# bluej files +*.ctxt + +# package files # +*.jar +*.war +*.nar +*.ear +*.zip +*.tar.gz +*.rar + +# virtual machine crash logs +hs_err_pid* + +# maven plugin temp files +.flattened-pom.xml + + +# ------------------------------- javascript ------------------------------- # dependencies node_modules # temp folders +build dist _book _jsdoc @@ -15,11 +49,11 @@ yarn-error.log* bundle*.js -################ IDEA ################ +# ------------------------------- intellij ------------------------------- .idea *.iml -################ Eclipse ################ +# ------------------------------- eclipse ------------------------------- .classpath .project diff --git a/README.md b/README.md index e23af50..5a3349a 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ # Linux 教程 -> :keyboard: 项目同步维护在 [github](https://github.com/dunwu/linux-tutorial) | [gitee](https://gitee.com/turnon/linux-tutorial) +> 🔁 项目同步维护在 [github](https://github.com/dunwu/linux-tutorial) | [gitee](https://gitee.com/turnon/linux-tutorial) > > 📖 [电子书](https://dunwu.github.io/linux-tutorial/) | [电子书(国内)](http://turnon.gitee.io/linux-tutorial/) -| :wrench: | :shell: | :memo: | :books: | +| :wrench: | :shell: | :memo: | 📚 | | :-------------------: | :-------------------: | :---------------: | :-------------------: | | [软件运维](#软件运维) | [运维和脚本](#运维和脚本) | [知识点](#知识点) | [学习资源](#学习资源) | diff --git a/docs/README.md b/docs/README.md index 8b2f574..04ce5d0 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,10 +1,10 @@ # Linux 教程 -> :keyboard: 项目同步维护在 [github](https://github.com/dunwu/linux-tutorial) | [gitee](https://gitee.com/turnon/linux-tutorial) +> 🔁 项目同步维护在 [github](https://github.com/dunwu/linux-tutorial) | [gitee](https://gitee.com/turnon/linux-tutorial) > > 📖 [电子书](https://dunwu.github.io/linux-tutorial/) | [电子书(国内)](http://turnon.gitee.io/linux-tutorial/) -| :wrench: | :shell: | :memo: | :books: | +| :wrench: | :shell: | :memo: | 📚 | | :-------------------: | :-------------------: | :---------------: | :-------------------: | | [软件运维](#软件运维) | [运维和脚本](#运维和脚本) | [知识点](#知识点) | [学习资源](#学习资源) | diff --git a/docs/coverpage.md b/docs/coverpage.md index 881c708..0b92b57 100644 --- a/docs/coverpage.md +++ b/docs/coverpage.md @@ -1,6 +1,6 @@
-# Linux Tutorial +# linux-tutorial > Linux 教程 diff --git a/docs/git/README.md b/docs/git/README.md index 16a7088..3313a48 100644 --- a/docs/git/README.md +++ b/docs/git/README.md @@ -7,7 +7,7 @@ - [git-flow 工作流](git-flow.md) - [Git 常见问题](git-faq.md) -## :books: 学习资源 +## 📚 学习资源 ### 官方资源 diff --git a/docs/index.html b/docs/index.html index c50503e..4169736 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,245 +1,242 @@ - - - Linux Tutorial - - - - - - + + + - + + +
正在加载...
+ + + + + - .cover-main blockquote p { - color: #5c5869; - font-family: "Arial", 隶书, serif; - } - - .cover-main ul a:hover { - color: #fe4165 !important; - } - - .cover-main p a:hover { - text-align: center; - background-image: -webkit-linear-gradient(left, #ffdcb4, #b96972 25%, #e88a57 50%, #804170 75%, #a596cd); - -webkit-text-fill-color: transparent; - -webkit-background-clip: text; - -webkit-background-size: 200% 100%; - -webkit-animation: masked-animation 1.5s infinite linear; - } - - /* content 样式内容 */ - .sidebar a, - .content a { - color: #399ab2 !important; - text-decoration: none !important; - } - - .sidebar a:hover, - .content a:hover { - color: #fe4165 !important; - text-decoration: underline !important; - } - - .content h1 :hover, - .content h2 :hover, - .content h3 :hover, - .content h4 :hover { - text-align: center; - background-image: -webkit-linear-gradient(left, #ffdcb4, #b96972 25%, #e88a57 50%, #804170 75%, #a596cd); - -webkit-text-fill-color: transparent; - -webkit-background-clip: text; - -webkit-background-size: 200% 100%; - -webkit-animation: masked-animation 1.5s infinite linear; - font-family: "微软雅黑", serif; - font-weight: bold; - } - - @-webkit-keyframes masked-animation { - 0% { - background-position: 0 0; - } - 100% { - background-position: -100% 0; - } - } - - .content h1 a, - .content h1 span { - color: #399ab2 !important; - font-size: 30px; - text-shadow: 2px 2px 5px grey; - } - - .content h2 a, - .content h2 span { - color: #60497c !important; - font-size: 26px; - text-shadow: 2px 2px 5px grey; - } - - .content h3 a, - .content h3 span { - color: #346093 !important; - font-size: 22px; - text-shadow: 2px 2px 5px grey; - } - - .content h4 a, - .content h4 span { - font-size: 18px; - color: #78943a; - text-shadow: 2px 2px 5px grey; - } - - img.emoji { - border: none; - border-radius: 0; - box-shadow: none; - } - - - - - -
正在加载...
- - - - - - - - - - - - + + + + + + + diff --git a/docs/linux/cli/Linux文件目录管理.md b/docs/linux/cli/Linux文件目录管理.md index 5431a4d..6e062ad 100644 --- a/docs/linux/cli/Linux文件目录管理.md +++ b/docs/linux/cli/Linux文件目录管理.md @@ -250,7 +250,7 @@ touch ex2 > ln 命令用来为文件创建连接,连接类型分为硬连接和符号连接两种,默认的连接类型是硬连接。如果要创建符号连接必须使用"-s"选项。 > -> 注意:符号链接文件不是一个独立的文件,它的许多属性依赖于源文件,所以给符号链接文件设置存取权限是没有意义的。 +> 🔔 注意:符号链接文件不是一个独立的文件,它的许多属性依赖于源文件,所以给符号链接文件设置存取权限是没有意义的。 > > 参考:http://man.linuxde.net/ln diff --git a/docs/linux/cli/Linux软件管理.md b/docs/linux/cli/Linux软件管理.md index ad250ce..7292493 100644 --- a/docs/linux/cli/Linux软件管理.md +++ b/docs/linux/cli/Linux软件管理.md @@ -150,7 +150,7 @@ yum 的默认源是国外的,下载速度比较慢,所以最好替换为一 | | Centos6:http://mirrors.aliyun.com/repo/Centos-6.repo
Centos7:http://mirrors.aliyun.com/repo/Centos-7.repo | | | Centos6:http://mirrors.163.com/.help/CentOS6-Base-163.repo
Centos7:http://mirrors.163.com/.help/CentOS7-Base-163.repo | -> 注意:Cento5 已废弃,只能使用 http://vault.centos.org/ 替换,但由于是国外镜像,速度较慢。 +> 🔔 注意:Cento5 已废弃,只能使用 http://vault.centos.org/ 替换,但由于是国外镜像,速度较慢。 替换方法,以 aliyun CentOS7 为例: diff --git a/docs/linux/ops/linux典型运维应用.md b/docs/linux/ops/linux典型运维应用.md index 1e5bd3b..f8ed21f 100644 --- a/docs/linux/ops/linux典型运维应用.md +++ b/docs/linux/ops/linux典型运维应用.md @@ -5,7 +5,7 @@ date: 2019-03-06 # Linux 典型运维应用 -> :bulb: 如果没有特殊说明,本文的案例都是针对 Centos 发行版本。 +> 💡 如果没有特殊说明,本文的案例都是针对 Centos 发行版本。 ## 网络操作 diff --git a/docs/linux/ops/shell.md b/docs/linux/ops/shell.md index 43cfd6c..b8b5c98 100644 --- a/docs/linux/ops/shell.md +++ b/docs/linux/ops/shell.md @@ -5,7 +5,7 @@ > 本文主要介绍 bash 的语法,对于 linux 指令不做任何介绍。 > > :notebook: 本文已归档到:「[blog](https://github.com/dunwu/blog)」 -> :keyboard: 本文的源码已归档到 [linux-tutorial](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos) +> 🔁 本文的源码已归档到 [linux-tutorial](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos) ``` ███████╗██╗ ██╗███████╗██╗ ██╗ @@ -173,7 +173,7 @@ chmod +x /path/to/script.sh #使脚本具有执行权限 这种方式要求脚本文件的第一行必须指明运行该脚本的程序,比如: -**:keyboard: 『示例源码』** [helloworld.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos/helloworld.sh) +**🔁 『示例源码』** [helloworld.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos/helloworld.sh) ```bash #!/usr/bin/env bash @@ -207,7 +207,7 @@ shell 语法中,注释是特殊的语句,会被 shell 解释器忽略。 - 单行注释 - 以 `#` 开头,到行尾结束。 - 多行注释 - 以 `:< > `continue`语句用来跳过某次迭代。 -**:keyboard: 『示例源码』** [break-demo.sh](https://github.com/dunwu/linux-tutorial/blob/master/codes/shell/demos/statement/break-demo.sh) +**🔁 『示例源码』** [break-demo.sh](https://github.com/dunwu/linux-tutorial/blob/master/codes/shell/demos/statement/break-demo.sh) ```bash # 查找 10 以内第一个能整除 2 和 3 的正整数 @@ -1244,7 +1244,7 @@ done # Output: 6 ``` -**:keyboard: 『示例源码』** [continue-demo.sh](https://github.com/dunwu/linux-tutorial/blob/master/codes/shell/demos/statement/continue-demo.sh) +**🔁 『示例源码』** [continue-demo.sh](https://github.com/dunwu/linux-tutorial/blob/master/codes/shell/demos/statement/continue-demo.sh) ```bash # 打印10以内的奇数 @@ -1273,14 +1273,14 @@ bash 函数定义语法如下: } ``` -> :bulb: 说明: +> 💡 说明: > > 1. 函数定义时,`function` 关键字可有可无。 > 2. 函数返回值 - return 返回函数返回值,返回值类型只能为整数(0-255)。如果不加 return 语句,shell 默认将以最后一条命令的运行结果,作为函数返回值。 > 3. 函数返回值在调用该函数后通过 `$?` 来获得。 > 4. 所有函数在使用前必须定义。这意味着必须将函数放在脚本开始部分,直至 shell 解释器首次发现它时,才可以使用。调用函数仅使用其函数名即可。 -**:keyboard: 『示例源码』** [function-demo.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos//function/function-demo.sh) +**🔁 『示例源码』** [function-demo.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos//function/function-demo.sh) ```bash #!/usr/bin/env bash @@ -1346,7 +1346,7 @@ the result is: 100 | `$#` | 不包括`$0`在内的位置参数的个数 | | `$FUNCNAME` | 函数名称(仅在函数内部有值) | -**:keyboard: 『示例源码』** [function-demo2.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos//function/function-demo2.sh) +**🔁 『示例源码』** [function-demo2.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos//function/function-demo2.sh) ```bash #!/usr/bin/env bash @@ -1406,7 +1406,7 @@ $ ./function-demo2.sh 10 20 | `$-` | 返回 Shell 使用的当前选项,与 set 命令功能相同。 | | `$?` | 函数返回值 | -**:keyboard: 『示例源码』** [function-demo3.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos//function/function-demo3.sh) +**🔁 『示例源码』** [function-demo3.sh](https://github.com/dunwu/linux-tutorial/tree/master/codes/shell/demos//function/function-demo3.sh) ```bash runner() { @@ -1644,7 +1644,7 @@ $ ./my_script 有时我们值需要 debug 脚本的一部分。这种情况下,使用`set`命令会很方便。这个命令可以启用或禁用选项。使用`-`启用选项,`+`禁用选项: -**:keyboard: 『示例源码』** [debug-demo.sh](https://github.com/dunwu/linux-tutorial/blob/master/codes/shell/demos/debug-demo.sh) +**🔁 『示例源码』** [debug-demo.sh](https://github.com/dunwu/linux-tutorial/blob/master/codes/shell/demos/debug-demo.sh) ```bash # 开启 debug diff --git a/docs/linux/soft/nexus-ops.md b/docs/linux/soft/nexus-ops.md index 466416d..fa65f4f 100644 --- a/docs/linux/soft/nexus-ops.md +++ b/docs/linux/soft/nexus-ops.md @@ -190,7 +190,7 @@ Nexus 中的仓库有以下类型: ``` -> 注意: +> 🔔 注意: > > - `` 和 `` 的 id 必须和 `settings.xml` 配置文件中的 `` 标签中的 id 匹配。 > - `` 标签的地址需要和 maven 私服的地址匹配。 diff --git a/docs/mac.md b/docs/mac.md index 0637f62..146d475 100644 --- a/docs/mac.md +++ b/docs/mac.md @@ -314,7 +314,7 @@ Cmd+C、Cmd+V、Cmd+X、Cmd+A、Cmd+Z。 打开 CheatSheet 后,长按 command 键,会弹出当前应用程序的所有快捷键。我们还可以对这些快捷键进行保存。 -## :books: 学习资源 +## 📚 学习资源 - [Awesome Mac](https://github.com/jaywcjlove/awesome-mac) - [awesome-macos-command-line](https://github.com/herrbischoff/awesome-macos-command-line)