Skip to content

Commit 4b07838

Browse files
committed
Update the docs.
- Optimize the code style of markdown list - Increase post contents (cotes2020#104, cotes2020#100)
1 parent 00c5bbe commit 4b07838

5 files changed

+109
-79
lines changed

Diff for: README.md

+33-38
Original file line numberDiff line numberDiff line change
@@ -13,31 +13,30 @@ A minimal, sidebar, responsive web design Jekyll theme, focusing on text present
1313

1414
## Table of Contents
1515

16-
* [Features](#features)
17-
* [Installation](#installation)
18-
* [Usage](#usage)
19-
* [Contributing](#contributing)
20-
* [Credits](#credits)
21-
* [Support](#support)
22-
* [License](#license)
16+
- [Features](#features)
17+
- [Installation](#installation)
18+
- [Usage](#usage)
19+
- [Contributing](#contributing)
20+
- [Credits](#credits)
21+
- [Support](#support)
22+
- [License](#license)
2323

2424
## Features
2525

26-
* Pinned Posts
27-
* Configurable theme mode
28-
* Double-level Categories
29-
* Last modified date for posts
30-
* Table of Contents
31-
* Automatically recommend related posts
32-
* Syntax highlighting
33-
* Mathematical expressions
34-
* Search
35-
* Atom Feeds
36-
* Disqus Comments
37-
* Google Analytics
38-
* GA Pageviews reporting (Advanced)
39-
* SEO and Performance Optimization
40-
26+
- Pinned Posts
27+
- Configurable theme mode
28+
- Double-level Categories
29+
- Last modified date for posts
30+
- Table of Contents
31+
- Automatically recommend related posts
32+
- Syntax highlighting
33+
- Mathematical expressions
34+
- Search
35+
- Atom Feeds
36+
- Disqus Comments
37+
- Google Analytics
38+
- GA Pageviews reporting (Advanced)
39+
- SEO and Performance Optimization
4140

4241
## Installation
4342

@@ -49,7 +48,7 @@ $ git clone git@github.com:<username>/jekyll-theme-chirpy -b master --single-bra
4948

5049
### Setting up the local envrionment
5150

52-
If you would like to run or build the project on your local machine, please follow the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of `Ruby`, `RubyGems` and `Bundler`.
51+
If you would like to run or build the project on your local machine, please follow the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of `Ruby`, `RubyGems` and `Bundler`.
5352

5453
Before running or building for the first time, please complete the installation of the Jekyll plugins. Go to the root directory of project and run:
5554

@@ -61,19 +60,18 @@ $ bundle install
6160

6261
What's more, in order to generate some extra files (*categories*, *tags* and *last modified list*), we need to use some tool scripts. If your machine is running Debian or macOS, make sure that [GNU coreutils](https://www.gnu.org/software/coreutils/) is installed. Otherwise, install by:
6362

64-
* Debian
63+
- Debian
6564

6665
```console
6766
$ sudo apt-get install coreutils
6867
```
6968

70-
* macOS
69+
- macOS
7170

7271
```console
7372
$ brew install coreutils
7473
```
7574

76-
7775
## Usage
7876

7977
Running [**Chirpy**](https://github.com/cotes2020/jekyll-theme-chirpy/) requires some extra files, which cannot be generated by Jekyll native commands, so please strictly follow the methods mentioned below to run or deploy your website.
@@ -91,23 +89,23 @@ $ bash tools/init.sh
9189
What it does is:
9290

9391
1. Remove some files or directories from your repository:
94-
* `.travis.yml`
95-
* files under `_posts`
96-
* folder `docs`
9792

98-
2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.
93+
- `.travis.yml`
94+
- files under `_posts`
95+
- folder `docs`
96+
97+
2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.
9998

10099
3. Automatically create a commit to save the changes.
101100

102101
### Configuration
103102

104103
Generally, go to `_config.yml` and configure the variables as needed. Some of them are typical options:
105104

106-
* `url`
107-
* `avatar`
108-
* `timezone`
109-
* `theme_mode`
110-
105+
- `url`
106+
- `avatar`
107+
- `timezone`
108+
- `theme_mode`
111109

112110
### Run Locally
113111

@@ -177,19 +175,16 @@ For more details and the better reading experience, please check out the [tutori
177175

178176
The old saying, "Two heads are better than one." Consequently, welcome to report bugs, improve code quality or submit a new feature. For more information, see [contributing guidelines](.github/CONTRIBUTING.md).
179177

180-
181178
## Credits
182179

183180
This theme is mainly built with [Jekyll](https://jekyllrb.com/) ecosystem, [Bootstrap](https://getbootstrap.com/), [Font Awesome](https://fontawesome.com/) and some other wonderful tools (their copyright information can be found in the relevant files).
184181

185182
:tada: Thanks to all the volunteers who contributed to this project, their GitHub IDs are on [this list](https://github.com/cotes2020/jekyll-theme-chirpy/graphs/contributors). Also, I won't forget those guys who submitted the issues or unmerged PR because they reported bugs, shared ideas or inspired me to write more readable documentation.
186183

187-
188184
## Support
189185

190186
If you enjoy this theme or find it helpful, please consider becoming my sponsor, I'd really appreciate it! Click the button <kbd>:heart: Sponsor</kbd> at the top of the [Home Page](https://github.com/cotes2020/jekyll-theme-chirpy) and choose a link that suits you to donate; this will encourage and help me better maintain the project.
191187

192-
193188
## License
194189

195190
This work is published under [MIT](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE) License.

Diff for: _posts/2019-08-08-text-and-typography.md

+19-1
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,11 @@ date: 2019-08-08 11:33:00 +0800
55
categories: [Blogging, Demo]
66
tags: [typography]
77
math: true
8+
image: /assets/img/sample/devices-mockup.png
89
---
910

10-
This Jekyll template totally compatible with Markdown syntax. Now, let's take a look for the text and typography in here.
11+
This Jekyll template totally compatible with Markdown syntax. Now, let's have a look at the text and typography.
12+
1113

1214
## Titles
1315

@@ -37,6 +39,22 @@ Beside the lake, beneath the trees,
3739

3840
Fluttering and dancing in the breeze.
3941

42+
## List
43+
44+
### Ordered list
45+
46+
1. first item
47+
2. second item
48+
3. third item
49+
50+
### Unordered list
51+
52+
- item 1
53+
- sub item 1
54+
- sub item 2
55+
56+
- item 2
57+
4058
## Block Quote
4159

4260
> This line to shows the Block Quote.

Diff for: _posts/2019-08-08-write-a-new-post.md

+10
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,16 @@ math: true
124124
---
125125
```
126126

127+
## Preview Image
128+
129+
If you want to add an image to the top of the post contents, specify the url for the image by:
130+
131+
```yaml
132+
---
133+
image: /path/to/image-file
134+
---
135+
```
136+
127137

128138
## Pinned Posts
129139

Diff for: _posts/2019-08-09-getting-started.md

+13-9
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,13 @@ $ bundle install
3030

3131
What's more, in order to generate some extra files (*categories*, *tags* and *last modified list*), we need to use some tool scripts. If your machine is running Debian or macOS, make sure that [GNU coreutils](https://www.gnu.org/software/coreutils/) is installed. Otherwise, install by:
3232

33-
* Debian
33+
- Debian
3434

3535
```console
3636
$ sudo apt-get install coreutils
3737
```
3838

39-
* macOS
39+
- macOS
4040

4141
```console
4242
$ brew install coreutils
@@ -59,19 +59,23 @@ $ bash tools/init.sh
5959
What it does is:
6060

6161
1. Remove some files or directories from your repository:
62-
* `.travis.yml`
63-
* files under `_posts`
64-
* folder `docs`
62+
63+
- `.travis.yml`
64+
- files under `_posts`
65+
- folder `docs`
66+
6567
2. If you use the `--no-gh` option, the directory `.github` will be deleted. Otherwise, setup the GitHub Action workflow by removing extension `.hook` of `.github/workflows/pages-deploy.yml.hook`, and then remove the other files and directories in folder `.github`.
68+
6669
3. Automatically create a commit to save the changes.
6770

6871
### Configuration
6972

7073
Generally, go to `_config.yml` and configure the variables as needed. Some of them are typical options:
71-
* `url`
72-
* `avatar`
73-
* `timezone`
74-
* `theme_mode`
74+
75+
- `url`
76+
- `avatar`
77+
- `timezone`
78+
- `theme_mode`
7579

7680
### Run Locally
7781

Diff for: docs/README_zh-CN.md

+34-31
Original file line numberDiff line numberDiff line change
@@ -15,31 +15,31 @@
1515
1616
## 目录
1717

18-
* [功能一览](#功能一览)
19-
* [安装](#安装)
20-
* [使用](#使用)
21-
* [参与贡献](#参与贡献)
22-
* [感谢](#感谢)
23-
* [赞助](#赞助)
24-
* [许可证书](#许可证书)
18+
- [功能一览](#功能一览)
19+
- [安装](#安装)
20+
- [使用](#使用)
21+
- [参与贡献](#参与贡献)
22+
- [感谢](#感谢)
23+
- [赞助](#赞助)
24+
- [许可证书](#许可证书)
2525

2626
## 功能一览
2727

28-
* 文章置顶
29-
* 可配置的全局主题颜色
30-
* 文章最后修改日期
31-
* 文章目录
32-
* 自动推荐相关文章
33-
* 语法高亮
34-
* 二级目录
35-
* 数学表达式
36-
* 搜索
37-
* Atom 订阅
38-
* Disqus 评论
39-
* Google 分析
40-
* GA 浏览报告(高级功能)
41-
* SEO 优化
42-
* 网站性能优化
28+
- 文章置顶
29+
- 可配置的全局主题颜色
30+
- 文章最后修改日期
31+
- 文章目录
32+
- 自动推荐相关文章
33+
- 语法高亮
34+
- 二级目录
35+
- 数学表达式
36+
- 搜索
37+
- Atom 订阅
38+
- Disqus 评论
39+
- Google 分析
40+
- GA 浏览报告(高级功能)
41+
- SEO 优化
42+
- 网站性能优化
4343

4444
## 安装
4545

@@ -63,13 +63,13 @@ $ bundle install
6363

6464
另外,为了生成一些额外的文件( Post 的分类、标签以及更新时间列表),需要用到一些脚本工具。如果你电脑的操作系统是 Debian 或者 macOS,请确保已经安装了[GNU coreutils](https://www.gnu.org/software/coreutils/),否则,通过以下方式完成安装:
6565

66-
* Debian
66+
- Debian
6767

6868
```console
6969
$ sudo apt-get install coreutils
7070
```
7171

72-
* macOS
72+
- macOS
7373

7474
```console
7575
$ brew install coreutils
@@ -92,20 +92,23 @@ $ bash tools/init.sh
9292
上述脚本完成了以下工作:
9393

9494
1. 从你的仓库中删除了:
95-
* `.travis.yml`
96-
* `_posts` 下的文件
97-
* `docs` 目录
95+
96+
- `.travis.yml`
97+
- `_posts` 下的文件
98+
- `docs` 目录
99+
98100
2. 如果使用了参数 `--no-gh`,则会怒删 `.github`。否则,将会配置 GitHub Actions:把 `.github/workflows/pages-deploy.yml.hook` 的后缀 `.hook` 去除,然后删除 `.github` 里的其他目录和文件。
101+
99102
3. 自动提交一个 Commit 以保存上述文件的更改。
100103

101104
### 配置文件
102105

103106
根据个人需要去修改 `_config.yml` 的变量,大部分都有注释介绍用法。典型的几个选项是:
104107

105-
* `url`
106-
* `avatar`
107-
* `timezone`
108-
* `theme_mode`
108+
- `url`
109+
- `avatar`
110+
- `timezone`
111+
- `theme_mode`
109112

110113
### 本地运行
111114

0 commit comments

Comments
 (0)