Skip to content

Commit

Permalink
Format markdown (use prettier), and do some fixes
Browse files Browse the repository at this point in the history
Arondight committed May 23, 2023
1 parent c94d4f8 commit c2b6b7e
Showing 162 changed files with 996 additions and 1,141 deletions.
9 changes: 4 additions & 5 deletions CHANGES.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
+ 2016-03-20
* 所有章节翻译完成
+ 2016-03-03
* 目录翻译和结构建立

- 2016-03-20
- 所有章节翻译完成
- 2016-03-03
- 目录翻译和结构建立
108 changes: 53 additions & 55 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -2,11 +2,11 @@

#### 参与翻译

你有三种方式可以参与Slackbook中文版的翻译
你有三种方式可以参与 Slackbook 中文版的翻译

1. 提交[Issues][ID_ISSUES],适合单处的翻译错误。
2. 提交[Pull Requests][ID_PULL_REQUESTS],适合较多翻译内容提交。
3. [申请][ID_JOINUS]成为[The Slackware Linux CN Community][ID_SLACKWARECN] 的一员,适合长期跟进翻译工作。
1. 提交[Issues][id_issues],适合单处的翻译错误。
2. 提交[Pull Requests][id_pull_requests],适合较多翻译内容提交。
3. [申请][id_joinus]成为[The Slackware Linux CN Community][id_slackwarecn] 的一员,适合长期跟进翻译工作。

#### 原始文档

@@ -23,17 +23,17 @@ $ make

#### 参与步骤

##### 新建Issues
##### 新建 Issues

你需要在[Issues][ID_ISSUES]页面查看你要翻译的章节是否有人接手,如果该章节的翻译尚未开始,你需要新建一个Issue来说明自己要翻译的章节
你需要在[Issues][id_issues]页面查看你要翻译的章节是否有人接手,如果该章节的翻译尚未开始,你需要新建一个 Issue 来说明自己要翻译的章节

我会尽快把项目的翻译状态更新到[项目翻译工作进展](https://github.com/slackwarecn/slackbook_cn/issues/2)页面。

##### Pull Requests 流程

###### Fork项目
###### Fork 项目

在GitHub上`fork`到自己的仓库,然后`clone`到本地,并设置用户信息。
在 GitHub 上`fork`到自己的仓库,然后`clone`到本地,并设置用户信息。

```
$ git clone https://github.com/<Your_Github_ID>/slackbook_cn.git
@@ -44,17 +44,17 @@ $ git config user.email "email"

###### 修改并提交翻译

做修改后提交,推送到自己的仓库,并在Commit中关闭你提的Issue
做修改后提交,推送到自己的仓库,并在 Commit 中关闭你提的 Issue

```
$ git add .
$ git commit -m "Close #n 该章节翻译已经完成 "
$ git push origin master
```

###### 发起Pull Request
###### 发起 Pull Request

现在你可以在你的Github 项目页面上发起[Pull Request][ID_PULL_REQUESTS]
现在你可以在你的 Github 项目页面上发起[Pull Request][id_pull_requests]

##### 组织内翻译提交流程

@@ -71,7 +71,7 @@ $ git config user.email "email"

###### 进行翻译并提交

做修改后提交,推送到仓库,并在Commit中关闭你提的Issue
做修改后提交,推送到仓库,并在 Commit 中关闭你提的 Issue

```
$ git add .
@@ -83,7 +83,7 @@ $ git push origin master

除此之外,你需要定期使用项目仓库内容更新自己仓库内容。

###### 更新Fork的项目
###### 更新 Fork 的项目

首先你需要为上游添加一个别名。

@@ -110,48 +110,46 @@ $ git pull origin master

#### 签名

请尽量使用自己的GPG密钥对提交进行签名
请尽量使用自己的 GPG 密钥对提交进行签名

#### 贡献者列表

| 内容 | 贡献者 |
| --- | --- |
| 翻译框架 | [Arondight][ID_NAME_ARONDIGHT] |
| 前言 | [Arondight][ID_NAME_ARONDIGHT] [zhuduiyou][ID_NAME_ZHUDUIYOU] [紫雨蝶眸][ID_NAME_ZIYUDIEMOU] |
| 第一章 | [zhuduiyou][ID_NAME_ZHUDUIYOU] [紫雨蝶眸][ID_NAME_ZIYUDIEMOU] |
| 第二章 | [liandesinian][ID_NAME_LIANDESINIAN] [紫雨蝶眸][ID_NAME_ZIYUDIEMOU] |
| 第三章 | [unnamed42][ID_NAME_UNNAMED42] |
| 第四章 | [abbycin][ID_NAME_ABBYCIN] [unnamed42][ID_NAME_UNNAMED42] |
| 第五章 | [liandesinian][ID_NAME_LIANDESINIAN] |
| 第六章 | [farkasity][ID_NAME_FARKASITY] |
| 第七章 | [unnamed42][ID_NAME_UNNAMED42] |
| 第八章 | [nnnewb][ID_NAME_NNNEWB] |
| 第九章 | [unnamed42][ID_NAME_UNNAMED42] |
| 第十章 | [unnamed42][ID_NAME_UNNAMED42] |
| 第十一章 | [abbycin][ID_NAME_ABBYCIN] |
| 第十二章 | [Arondight][ID_NAME_ARONDIGHT] |
| 第十三章 | [zhuduiyou][ID_NAME_ZHUDUIYOU] |
| 第十四章 | [cantaosir][ID_NAME_CANTAOSIR] |
| 第十五章 | [unnamed42][ID_NAME_UNNAMED42] |
| 第十六章 | [zhuduiyou][ID_NAME_ZHUDUIYOU] |
| 第十七章 | [zhuduiyou][ID_NAME_ZHUDUIYOU] [紫雨蝶眸][ID_NAME_ZIYUDIEMOU] |
| 第十八章 | [Arondight][ID_NAME_ARONDIGHT] [nnnewb][ID_NAME_NNNEWB] [zha0300][ID_NAME_ZHA0300] |
| 第十九章 | [coolrc136][ID_NAME_COOLRC136] |

[ID_SLACKWARECN]: https://github.com/slackwarecn "访问The Slackware Linux CN Community"
[ID_JOINUS]: http://slackwarecn.github.io/JoinUs "加入我们!"
[ID_PULL_REQUESTS]: https://github.com/slackwarecn/slackbook_cn/pulls "查看Pull Requests"
[ID_ISSUES]: https://github.com/slackwarecn/slackbook_cn/issues "提交Issues"

[ID_NAME_ARONDIGHT]: https://github.com/Arondight
[ID_NAME_ZHUDUIYOU]: https://github.com/zhuduiyou
[ID_NAME_COOLRC136]: https://github.com/coolrc136
[ID_NAME_UNNAMED42]: https://github.com/unnamed42
[ID_NAME_LIANDESINIAN]: https://github.com/liandesinian
[ID_NAME_ZHA0300]: https://github.com/zha0300
[ID_NAME_ABBYCIN]: https://github.com/abbycin
[ID_NAME_FARKASITY]: https://github.com/farkasity
[ID_NAME_CANTAOSIR]: https://github.com/cantaosir
[ID_NAME_ZIYUDIEMOU]: http://tieba.baidu.com/home/main?un=%E7%B4%AB%E9%9B%A8%E8%9D%B6%E7%9C%B8&ie=utf-8&fr=pb
[ID_NAME_NNNEWB]: https://github.com/nnnewb

| 内容 | 贡献者 |
| -------- | -------------------------------------------------------------------------------------------- |
| 翻译框架 | [Arondight][id_name_arondight] |
| 前言 | [Arondight][id_name_arondight] [zhuduiyou][id_name_zhuduiyou] [紫雨蝶眸][id_name_ziyudiemou] |
| 第一章 | [zhuduiyou][id_name_zhuduiyou] [紫雨蝶眸][id_name_ziyudiemou] |
| 第二章 | [liandesinian][id_name_liandesinian] [紫雨蝶眸][id_name_ziyudiemou] |
| 第三章 | [unnamed42][id_name_unnamed42] |
| 第四章 | [abbycin][id_name_abbycin] [unnamed42][id_name_unnamed42] |
| 第五章 | [liandesinian][id_name_liandesinian] |
| 第六章 | [farkasity][id_name_farkasity] |
| 第七章 | [unnamed42][id_name_unnamed42] |
| 第八章 | [nnnewb][id_name_nnnewb] |
| 第九章 | [unnamed42][id_name_unnamed42] |
| 第十章 | [unnamed42][id_name_unnamed42] |
| 第十一章 | [abbycin][id_name_abbycin] |
| 第十二章 | [Arondight][id_name_arondight] |
| 第十三章 | [zhuduiyou][id_name_zhuduiyou] |
| 第十四章 | [cantaosir][id_name_cantaosir] |
| 第十五章 | [unnamed42][id_name_unnamed42] |
| 第十六章 | [zhuduiyou][id_name_zhuduiyou] |
| 第十七章 | [zhuduiyou][id_name_zhuduiyou] [紫雨蝶眸][id_name_ziyudiemou] |
| 第十八章 | [Arondight][id_name_arondight] [nnnewb][id_name_nnnewb] [zha0300][id_name_zha0300] |
| 第十九章 | [coolrc136][id_name_coolrc136] |

[id_slackwarecn]: https://github.com/slackwarecn "访问The Slackware Linux CN Community"
[id_joinus]: http://slackwarecn.github.io/JoinUs "加入我们!"
[id_pull_requests]: https://github.com/slackwarecn/slackbook_cn/pulls "查看Pull Requests"
[id_issues]: https://github.com/slackwarecn/slackbook_cn/issues "提交Issues"
[id_name_arondight]: https://github.com/Arondight
[id_name_zhuduiyou]: https://github.com/zhuduiyou
[id_name_coolrc136]: https://github.com/coolrc136
[id_name_unnamed42]: https://github.com/unnamed42
[id_name_liandesinian]: https://github.com/liandesinian
[id_name_zha0300]: https://github.com/zha0300
[id_name_abbycin]: https://github.com/abbycin
[id_name_farkasity]: https://github.com/farkasity
[id_name_cantaosir]: https://github.com/cantaosir
[id_name_ziyudiemou]: http://tieba.baidu.com/home/main?un=%E7%B4%AB%E9%9B%A8%E8%9D%B6%E7%9C%B8&ie=utf-8&fr=pb
[id_name_nnnewb]: https://github.com/nnnewb
1 change: 0 additions & 1 deletion COPYING

This file was deleted.

1 change: 1 addition & 0 deletions COPYRIGHT
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Copyright (c) 2016-2023 The Slackware Linux CN Community (https://github.com/slackwarecn/)
18 changes: 8 additions & 10 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,23 +1,21 @@
# ==============================================================================
# make all/pdf/epub/mobi/clean
# make <all|html|pdf|epub|mobi>
# ==============================================================================
GITBOOK = gitbook
RM = rm

TARGET = slackbook_cn
FORMATS = pdf epub mobi

.PHONY: all clean html $(FORMATS)
.PHONY: all clean html format $(FORMATS)

all: html $(FORMATS)

html:
$(GITBOOK) build . $(TARGET)_html
gitbook build . $(TARGET)_html

$(FORMATS):
$(GITBOOK) $@ . $(TARGET).$@
gitbook $@ . $(TARGET).$@

clean:
-$(RM) -f $(addprefix $(TARGET)., $(FORMATS))
-$(RM) -rf $(TARGET)_html
format:
@prettier -wu $(shell find * -type f -name '*.md')

clean:
rm -rf $(TARGET)_html $(addprefix $(TARGET)., $(FORMATS))
45 changes: 24 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,45 @@
## Slackware中文手册
## Slackware 中文手册

### 关于本书

本书是[Slackbook][ID_SLACKBOOK]的中文版,项目托管于[Github][ID_GITHUB]
本书是[Slackbook][id_slackbook]的中文版,项目托管于[Github][id_github]

### 修订历史

你可以在[这里][ID_CHANGES]查看该文档的修订历史。
你可以在[这里][id_changes]查看该文档的修订历史。

### 获取文档

+ [在线阅读][ID_ONLINE]
+ [发布页面][ID_RELEASES]
- [在线阅读][id_online]
- [发布页面][id_releases]

### 本地编译

确保你的系统中有`xdg-utils``wget``xz-utils``python2.6+`以安装[Calibre][ID_CALIBRE][GitBook][ID_GITBOOK]需要此软件进行PDF、EPUB和MOBI的格式转换
[GitBook][id_gitbook]需要[Calibre][id_calibre]以输出 PDF、EPUB 和 MOBI 格式。安装此软件前,确保你的 Slackware Linux 中已安装`python3``wget``xdg-utils``xz`软件包

```
$ sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
$ sudo npm install -g @0y0/gitbook-cli
$ git clone https://github.com/slackwarecn/slackbook_cn
$ cd slackbook_cn
$ make all
```shell
curl -fsSL https://download.calibre-ebook.com/linux-installer.sh | sudo -E bash -s
sudo npm install -g @0y0/gitbook-cli
git clone https://github.com/slackwarecn/slackbook_cn.git
cd ./slackbook_cn/
make all
```

> 因为GitBook官方已经[不再支持CLI][ID_GITBOOK_DEPRECATION],所以这里使用了非官方维护的版本。
> 因为 GitBook 官方已经[不再支持 CLI][id_gitbook_deprecation],所以这里使用了非官方维护的版本。
### 贡献力量

如果你想为项目贡献你的力量,请务必事先阅读[CONTRIBUTING.md](CONTRIBUTING.md)

[ID_GITHUB]: https://github.com/slackwarecn/slackbook_cn "访问项目主页"
[ID_SLACKBOOK]: http://slackbook.org "访问The Revised Slackware Book Project主页"
[ID_CHANGES]: https://github.com/slackwarecn/slackbook_cn/blob/master/CHANGES.md "查看修订历史"
[ID_ONLINE]: https://slackwarecn.gitbook.io/slackbook_cn "阅读在线版本"
[ID_RELEASES]: https://github.com/slackwarecn/slackbook_cn/releases "查看已发布文档"
[ID_GITBOOK]: https://github.com/GitbookIO/gitbook "Gitbook项目主页"
[ID_GITBOOK_DEPRECATION]: https://github.com/GitbookIO/gitbook#%EF%B8%8F-deprecation-warning "查看GitBook官方不再支持CLI公告"
[ID_CALIBRE]: https://github.com/kovidgoyal/calibre/releases "点此获取Calibre"
[id_github]: https://github.com/slackwarecn/slackbook_cn "访问项目主页"
[id_slackbook]: http://slackbook.org "访问The Revised Slackware Book Project主页"
[id_changes]: https://github.com/slackwarecn/slackbook_cn/blob/master/CHANGES.md "查看修订历史"
[id_online]: https://slackwarecn.gitbook.io/slackbook_cn "阅读在线版本"
[id_releases]: https://github.com/slackwarecn/slackbook_cn/releases "查看已发布文档"
[id_gitbook]: https://github.com/GitbookIO/gitbook "Gitbook项目主页"
[id_gitbook_deprecation]: https://github.com/GitbookIO/gitbook#%EF%B8%8F-deprecation-warning "查看GitBook官方不再支持CLI公告"
[id_calibre]: https://github.com/kovidgoyal/calibre/releases "点此获取Calibre"

### 版权

Copyright (c) 2016-2023 The Slackware Linux CN Community (https://github.com/slackwarecn/)
Loading

0 comments on commit c2b6b7e

Please sign in to comment.