docs：更改组织方式
Log：
This commit is contained in:
xiangzelong
parent
a3007eaeb7
commit
710ce6d6fa
@ -11,14 +11,25 @@ export default {
|
||||
],
|
||||
},
|
||||
{
|
||||
text: "GNU/Linux教程",
|
||||
text: "deepin进阶教程",
|
||||
items: [
|
||||
{ text: "简介", link: "/GNU-linux教程/简介" },
|
||||
{ text: "1.1.控制台基础", link: "/GNU-linux教程/1.1.控制台基础" },
|
||||
{ text: "1.2.类Unix系统", link: "/GNU-linux教程/1.2.类Unix系统" },
|
||||
{ text: "1.4.类Unix工作环境基础", link: "/GNU-linux教程/1.4.类Unix工作环境基础" },
|
||||
{ text: "1.5.简单shell命令", link: "/GNU-linux教程/1.5.简单shell命令" },
|
||||
{ text: "1.6.类Unix的文本处理", link: "/GNU-linux教程/1.6.类Unix的文本处理" },
|
||||
{
|
||||
text: "1.GNU/Linux教程",
|
||||
items: [
|
||||
{ text: "简介", link: "/deepin进阶教程/1.GNU-linux教程/简介" },
|
||||
{ text: "1.1.控制台基础", link: "/deepin进阶教程/1.GNU-linux教程/1.1.控制台基础" },
|
||||
{ text: "1.2.类Unix系统", link: "/deepin进阶教程/1.GNU-linux教程/1.2.类Unix系统" },
|
||||
{ text: "1.4.类Unix工作环境基础", link: "/deepin进阶教程/1.GNU-linux教程/1.4.类Unix工作环境基础" },
|
||||
{ text: "1.5.简单shell命令", link: "/deepin进阶教程/1.GNU-linux教程/1.5.简单shell命令" },
|
||||
{ text: "1.6.类Unix的文本处理", link: "/deepin进阶教程/1.GNU-linux教程/1.6.类Unix的文本处理" },1
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
text: "文档贡献指南",
|
||||
items: [
|
||||
{ text: "文档贡献指南", link: "/文档贡献指南/文档贡献指南" },
|
||||
],
|
||||
},
|
||||
],
|
||||
|
||||
@ -1,61 +0,0 @@
|
||||
# 1.6. 类 Unix 的文本处理
|
||||
|
||||
在类 Unix 的工作环境中，文本处理是通过使用管道组成的标准文本处理工具链完成的。这是另一个重要的 Unix 创新。
|
||||
|
||||
## 1.6.1. Unix 文本工具
|
||||
|
||||
这里有一些在类 Unix 系统中经常使用到的标准文本处理工具。
|
||||
|
||||
- 没有使用正则表达式：
|
||||
|
||||
- cat(1) 连接文件并输出全部的内容。
|
||||
|
||||
- tac(1) 连接文件并反向输出。
|
||||
|
||||
- cut(1) 选择行的一部分并输出。
|
||||
|
||||
- head(1) 输出文件的开头。
|
||||
|
||||
- tail(1) 输出文件的末尾。
|
||||
|
||||
- sort(1) 对文本文件的行进行排序。
|
||||
|
||||
- uniq(1) 从已排序的文件中移除相同的行。
|
||||
|
||||
- tr(1) 转换或删除字符。
|
||||
|
||||
- diff(1) 对文件的行进行对比。
|
||||
|
||||
- 默认使用基础正则表达式（ BRE ）：
|
||||
|
||||
- ed(1) 是一个原始行编辑器。
|
||||
|
||||
- sed(1) 是一个流编辑器。
|
||||
|
||||
- grep(1) 匹配满足 pattern 的文本。
|
||||
|
||||
- vim(1) 是一个屏幕编辑器。
|
||||
|
||||
- emacs(1) 是一个屏幕编辑器。（有些扩展的 BRE ）
|
||||
|
||||
使用扩展的正则表达式（ ERE ）：
|
||||
|
||||
- 使用扩展的正则表达式（ ERE ）：
|
||||
|
||||
- awk(1) 进行简单的文本处理。
|
||||
|
||||
- egrep(1) 匹配满足多个 pattern 的文本。
|
||||
|
||||
- tcl(3tcl) 可以进行任何你想得到的文本处理：参见 re_syntax(3)经常与 tk(3tk) 一起使用。
|
||||
|
||||
- perl(1) 可以进行任何你想得到的文本处理。参见 perlre(1)
|
||||
|
||||
- pcregrep 软件包中的 pcregrep(1) 可以匹配满足 Perl 兼容正则表达式（PCRE） 模式的文本。
|
||||
|
||||
- ripgrep 是对grep最佳的替代，命令是rg
|
||||
|
||||
- 带有 re 模块的 python(1) 可以进行任何你想得到的文本处理。参见“/usr/share/doc/python/html/index.html”。
|
||||
|
||||
- 如果你不确定这些命令究竟做了什么，请使用“man command” 来自己把它搞清楚吧。
|
||||
|
||||
推荐文本工具：neovim batcat ripgrep
|
||||
@ -19,13 +19,17 @@ Password：
|
||||
```
|
||||
|
||||
|
||||
输入用户密码即可，请注意，密码并不会被显示，不要怀疑自己是否输入了密码。
|
||||
输入用户密码即可。
|
||||
|
||||
:::tip
|
||||
请注意，密码并不会被显示，不要怀疑自己是否输入了密码。
|
||||
:::
|
||||
|
||||
遵循 Unix 传统，deepin 系统下的用户名和密码是大小写敏感的。用户名通常由小写字母组成。第一个用户账号通常在安装期间进行创建。额外的用户账号由 root 用户用 adduser(8) 创建。
|
||||
|
||||
系统以保存在 "`/etc/motd`" 中的欢迎信息（Message Of The Day）来开始，同时显示一个命令提示符
|
||||
|
||||
```Plain Text
|
||||
```Shell
|
||||
Linux foo-PC 5.18.17-amd64-desktop-hwe #23.01.00.06 SMP PREEMPT_DYNAMIC Mon Oct 31 17:25:49 CST 2022 x86_64
|
||||
Welcome to Deepin V23 GNU/Linux
|
||||
|
||||
@ -65,7 +69,9 @@ root 账户也被称作超级用户或特权用户。用这个账户，你能够
|
||||
|
||||
无限权力的 root 账户，要求你慎重和负责任的使用。
|
||||
|
||||
::: warning
|
||||
注意：如果有人告诉你形如：`sudo rm -rf /*` ，请谨慎对待，最好你在执行此命令之前了解此命令含义，否则会造成不可挽回的后果。
|
||||
:::
|
||||
|
||||
一个文件（包括硬件设备，如 CD-ROM 等，这些对 Linux 系统来说都只是一个文件）的权限可能会导致非 root 用户无法使用或访问它 。虽然在这种情况下，使用 root 帐户是一个快速的方法，但正确的解决方法应该是对文件权限和用户组的成员进行合适的设置（参见第[ 1.2.3 节 “文件系统权限](https://flowus.cn/16aaa542-96fb-40e1-bfca-d77989d1418b#b6113247-d21b-4ce4-92ff-0e3f94886ec1)”）。
|
||||
|
||||
@ -375,7 +375,7 @@ New Content
|
||||
|
||||
尝试下列例子
|
||||
|
||||
```Plain Text
|
||||
```Shell
|
||||
$ cd; mkfifo mypipe
|
||||
$ echo "hello" >mypipe & # put into background
|
||||
[1] 8022
|
||||
@ -294,4 +294,6 @@ file is /usr/bin/file
|
||||
|
||||
`ls` 在最近被使用过，而 “`file`” 没有，因此 “`ls`” 标记为 “hashed”（被录入哈希表），即 shell 有一个内部的记录用来快速访问 “`ls`” 所处的位置。
|
||||
|
||||
记住 alia命令定义的别名仅在当前shell有效，如果关闭或重启shell则不会保留别名。如果想长久保留，请将其写入坏境变量中。
|
||||
:::tip
|
||||
alia命令定义的别名仅在当前shell有效，如果关闭或重启shell则不会保留别名。如果想长久保留，请将其写入坏境变量中。
|
||||
:::
|
||||
61
docs/deepin进阶教程/1.GNU-linux教程/1.6.类Unix的文本处理.md
Normal file
61
docs/deepin进阶教程/1.GNU-linux教程/1.6.类Unix的文本处理.md
Normal file
@ -0,0 +1,61 @@
|
||||
# 1.6. 类 Unix 的文本处理
|
||||
|
||||
在类 Unix 的工作环境中，文本处理是通过使用管道组成的标准文本处理工具链完成的。这是另一个重要的 Unix 创新。
|
||||
|
||||
## 1.6.1. Unix 文本工具
|
||||
|
||||
这里有一些在类 Unix 系统中经常使用到的标准文本处理工具。
|
||||
|
||||
- 没有使用正则表达式：
|
||||
|
||||
- `cat`(1) 连接文件并输出全部的内容。
|
||||
|
||||
- `tac`(1) 连接文件并反向输出。
|
||||
|
||||
- `cut`(1) 选择行的一部分并输出。
|
||||
|
||||
- `head`(1) 输出文件的开头。
|
||||
|
||||
- `tail`(1) 输出文件的末尾。
|
||||
|
||||
- `sort`(1) 对文本文件的行进行排序。
|
||||
|
||||
- `uniq`(1) 从已排序的文件中移除相同的行。
|
||||
|
||||
- `tr`(1) 转换或删除字符。
|
||||
|
||||
- `diff`(1) 对文件的行进行对比。
|
||||
|
||||
- 默认使用基础正则表达式（ BRE ）：
|
||||
|
||||
- `ed`(1) 是一个原始行编辑器。
|
||||
|
||||
- `sed`(1) 是一个流编辑器。
|
||||
|
||||
- `grep`(1) 匹配满足 pattern 的文本。
|
||||
|
||||
- `vim`(1) 是一个屏幕编辑器。
|
||||
|
||||
- `emacs`(1) 是一个屏幕编辑器。（有些扩展的 BRE ）
|
||||
|
||||
使用扩展的正则表达式（ ERE ）：
|
||||
|
||||
- 使用扩展的正则表达式（ ERE ）：
|
||||
|
||||
- `awk`(1) 进行简单的文本处理。
|
||||
|
||||
- `egrep`(1) 匹配满足多个 pattern 的文本。
|
||||
|
||||
- `tcl`(3tcl) 可以进行任何你想得到的文本处理：参见 re_syntax(3)经常与 tk(3tk) 一起使用。
|
||||
|
||||
- `perl`(1) 可以进行任何你想得到的文本处理。参见 perlre(1)
|
||||
|
||||
- `pcregrep` 软件包中的 pcregrep(1) 可以匹配满足 Perl 兼容正则表达式（PCRE） 模式的文本。
|
||||
|
||||
- `ripgrep` 是对grep最佳的替代，命令是rg
|
||||
|
||||
- 带有 re 模块的 python(1) 可以进行任何你想得到的文本处理。参见“/usr/share/doc/python/html/index.html”。
|
||||
|
||||
- 如果你不确定这些命令究竟做了什么，请使用“`man command`” 来自己把它搞清楚吧。
|
||||
|
||||
推荐文本工具：neovim batcat ripgrep
|
||||
@ -114,21 +114,21 @@ $ info make
|
||||
|
||||
**文件名**将由双引号括起来的打印机字体进行标记，就像 "`/etc/passwd`"。对于配置文件，你可以输入下列的命令来获取它的信息。
|
||||
|
||||
```Plain Text
|
||||
```Shell
|
||||
$ sensible-pager "/etc/passwd"
|
||||
```
|
||||
|
||||
|
||||
**目录名**将由双引号括起来的打印机字体进行标记，就像 "`/etc/apt`"。你可以输入下列的命令来浏览目录的内容。
|
||||
|
||||
```Plain Text
|
||||
```Shell
|
||||
$ mc "/etc/apt/"
|
||||
```
|
||||
|
||||
|
||||
**软件包名称**将由打印机字体进行标记，就像 `vim`。你可以输入下列的命令来获取它的信息。
|
||||
|
||||
```Plain Text
|
||||
```Shell
|
||||
$ dpkg -L vim
|
||||
$ apt-cache show vim
|
||||
$ aptitude show vim
|
||||
@ -146,7 +146,7 @@ $ sensible-browser "https://www.debian.org"
|
||||
|
||||
**环境变量**将由双引号括起来的打印机字体进行标记，并带有 "`$`" 前缀，就像 "`$TERM`"。你可以输入下列命令来获取它的当前值。
|
||||
|
||||
```Plain Text
|
||||
```Shell
|
||||
$ echo "$TERM"
|
||||
```
|
||||
|
||||
|
||||
96
docs/文档贡献指南/文档贡献指南.md
Normal file
96
docs/文档贡献指南/文档贡献指南.md
Normal file
@ -0,0 +1,96 @@
|
||||
# 文档贡献指南
|
||||
|
||||
## 1. 文档贡献流程
|
||||
|
||||
### 1.1. fork 仓库
|
||||
|
||||
首先，你需要 fork 本仓库到你的 GitHub 账号下。
|
||||
项目地址为: [www.github.com/deepin-community](https://github.com/deepin-community/.guide.deepin.org)
|
||||
|
||||
看到右上角的fork按钮了吗？点击它，就可以将本仓库复制到你的账号下了。
|
||||
|
||||
### 1.2. 克隆仓库
|
||||
|
||||
你需要将你的仓库克隆到本地，然后在本地进行修改。
|
||||
|
||||
```bash
|
||||
git clone https://github.com/deepin-community/.guide.deepin.org.git
|
||||
```
|
||||
|
||||
然后使用文本编辑器打开仓库，你会看到如下目录结构：
|
||||
|
||||
```text
|
||||
.
|
||||
├── docs
|
||||
├── LICENSE
|
||||
├── node_modules
|
||||
├── package.json
|
||||
├── pnpm-lock.yaml
|
||||
├── README.md
|
||||
└── yarn.lock
|
||||
```
|
||||
|
||||
你需要写的文档就在docs目录下，你可以在这个目录下新建一个文件夹，然后在这个文件夹下写你的文档。
|
||||
和现在这篇文档一样。
|
||||
|
||||
如果你需要修改侧边栏，你需要修改`docs/.vitepress/config.js`文件。
|
||||
|
||||
### 1.3. 本地渲染
|
||||
|
||||
#### 安装依赖
|
||||
|
||||
本文档使用vitepress作为文档渲染工具，你需要安装vitepress的依赖。
|
||||
|
||||
你需要安装nodejs和pnpm，然后使用pnpm来安装依赖。
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
```
|
||||
|
||||
使用`pnpm dev`来本地渲染文档。
|
||||
|
||||
```bash
|
||||
pnpm dev
|
||||
```
|
||||
|
||||
**注意：如果你使用的是yarn，你需要将`pnpm`替换为`yarn`**
|
||||
|
||||
#### 本地渲染效果
|
||||
|
||||
你可以在浏览器中打开`http://localhost:3000`来查看本地渲染效果。
|
||||
注意这个端口并不固定，会在你运行后在终端中显示。
|
||||
|
||||
### 1.4. 提交修改
|
||||
|
||||
提交修改到你的仓库。
|
||||
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "docs: add new doc"
|
||||
git push
|
||||
```
|
||||
|
||||
注意 commit 信息需要符合[约定式提交规范](https://www.conventionalcommits.org/zh-hans/v1.0.0-beta.4/)。
|
||||
|
||||
### 1.5. 发起 Pull Request
|
||||
|
||||
在你的仓库中，点击`Pull requests`，然后点击`New pull request`，然后点击`Create pull request`。
|
||||
|
||||
## 2. 文档格式
|
||||
|
||||
### 2.1. Markdown
|
||||
|
||||
本文档使用Markdown作为文档格式，你可以在[这里](https://www.markdownguide.org/basic-syntax/)查看Markdown的基本语法。
|
||||
|
||||
### 2.2. Vitepress
|
||||
|
||||
本文档使用Vitepress作为文档渲染工具，你可以在[这里](https://vitepress.vuejs.org/)查看Vitepress的文档。
|
||||
|
||||
## 3. CLA协议
|
||||
|
||||
本仓库使用CLA协议，你无需签署CLA协议，如果你提交pr,则视为你已经同意CLA协议。
|
||||
[CLA协议](https://github.com/linuxdeepin/cla)
|
||||
|
||||
## 4. License
|
||||
|
||||
本仓库使用LGPL-3.0-or-later License ，你可以在此License下自由使用本仓库的内容。
|
||||
Loading…
Reference in New Issue
Block a user