Skip to content

Commit 0ac2675

Browse files
committed
Document improvement.
1 parent de905e0 commit 0ac2675

File tree

3 files changed

+31
-28
lines changed

3 files changed

+31
-28
lines changed

README.md

Lines changed: 20 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,29 @@
1-
# Jekyll Theme Chirpy
1+
# Chirpy
2+
3+
Language: **English** | [简体中文](docs/README_zh-CN.md)
24

35
[![Build Status](https://github.com/cotes2020/jekyll-theme-chirpy/workflows/build/badge.svg?event=push)](https://github.com/cotes2020/jekyll-theme-chirpy/actions?query=event%3Apush)
46
[![GitHub license](https://img.shields.io/github/license/cotes2020/jekyll-theme-chirpy.svg)](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE)
57
[![996.icu](https://img.shields.io/badge/link-996.icu-%23FF4D5B.svg)](https://996.icu)
68

7-
Language: English | [简体中文](docs/README_zh-CN.md)
8-
9-
A minimal, portfolio, sidebar, bootstrap Jekyll theme with responsive web design and focuses on text exhibition. It will help you easily record and share your knowledge.
9+
A minimal, sidebar, responsive web design Jekyll theme, focusing on text presentation. Aim to help you easily record and share your knowledge.
1010

1111
**Features**
1212

13-
* Auto Dark Mode
14-
* Posts' Last Modified Date
13+
* Configurable theme mode
14+
* Two-level Categories
15+
* Last modified date for posts
1516
* Table of Contents
16-
* Automatically Recommend Related Posts
17+
* Automatically recommend related posts
1718
* Syntax highlighting
18-
* Two Level Categories
1919
* Search
2020
* Atom Feeds
2121
* Disqus Comments
2222
* Google Analytics
23-
* GA Pageviews (Advanced)
24-
* SEO Tag
25-
* Performance Optimization
23+
* GA Pageviews reporting (Advanced)
24+
* SEO and Performance Optimization
2625

27-
[![devices-mockup](https://raw.githubusercontent.com/cotes2020/jekyll-theme-chirpy/master/assets/img/sample/devices-mockup.png)](https://chirpy.cotes.info)
26+
[![Devices Mockup](https://raw.githubusercontent.com/cotes2020/jekyll-theme-chirpy/master/assets/img/sample/devices-mockup.png)](https://chirpy.cotes.info)
2827

2928
## Table of Contents
3029

@@ -118,7 +117,7 @@ As mentioned above, some files or directories should be removed from your repo:
118117

119118
### Customization
120119

121-
Basically, go to `_config.yml` and customize the variables as needed, some of them are typical options:
120+
Basically, go to `_config.yml` and configure the variables as needed. Some of them are typical options:
122121

123122
* `url`
124123

@@ -157,7 +156,7 @@ Few days later, you may find that the file modification(e.g. edits to a post) do
157156

158157
### Deploying to GitHub Pages
159158

160-
Before the deployment begins, ensure the `url` in file `_config.yml` has been set to `https://<username>.github.io`(or the custom domain, if you have. e.g. `https://yourdomain.com`). What's more, if you prefer to the [Project site](https://help.github.com/en/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites), change `baseurl` of file `_config.yml` to your project name, starting with a slash. e.g. `/project`.
159+
Before the deployment begins, checkout the file `_config.yml` and make sure that the `url` has been configured. What's more, if you prefer the [Project site on GitHub](https://help.github.com/en/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites) and also use the default domain `<username>.github.io`, remember to change the `baseurl` to your project name that starting with a slash. For example, `/project`.
161160

162161
#### Option 1: Built by GitHub Pages
163162

@@ -170,7 +169,7 @@ By deploying the site in this way, you're allowed to push the source code direct
170169
|Site Type | Repo's Name|
171170
|:---|:---|
172171
|User or Organization | `<username>.github.io`|
173-
|Project| any one except `<username>.github.io`, let's say `project`|
172+
|Project| Any one except `<username>.github.io`, let's say `project`|
174173

175174
**2**. Commit the changes of the repo first, then run the initialization script:
176175

@@ -211,7 +210,7 @@ For security reasons, GitHub Pages runs on `safe` mode, which means the third-pa
211210
|Site Type | Repo's Name|
212211
|:---|:---|
213212
|User or Organization | `<username>.github.io`|
214-
|Project| any one except `<username>.github.io`, let's say `project`|
213+
|Project| Any one except `<username>.github.io`, let's say `project`|
215214

216215
and clone it.
217216

@@ -232,15 +231,18 @@ The generated static files will be placed in the root of `/path/to/local/project
232231
|User or Organization | `https://<username>.github.io/`|
233232
|Project| `https://<username>.github.io/project/`|
234233

235-
and enjoy!
234+
#### Finishing work
235+
236+
No matter which way you choose to deploy the website on GitHub, please enforce the `HTTPS` for it. See official docs: [Configuring a publishing source for your GitHub Pages site](https://help.github.com/en/github/working-with-github-pages/securing-your-github-pages-site-with-https).
237+
236238

237239
### Documentation
238240

239241
For more details and the better reading experience, please check out the [tutorial in demo site](https://chirpy.cotes.info/categories/tutorial/). In the meanwhile, a copy of the tutorial is also available on the [Wiki](https://github.com/cotes2020/jekyll-theme-chirpy/wiki).
240242

241243
## Contributing
242244

243-
The old saying: "Two heads are better than one. Five heads are better than two." So, welcome to report bugs, improve code quality or submit a new feature. For more information, see [contributing guidelines](.github/CONTRIBUTING.md).
245+
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).
244246

245247

246248
## Credits

_posts/2019-08-09-getting-started.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ As mentioned above, some files or directories should be removed from your repo:
7373

7474
## Configuration
7575

76-
Basically, go to `_config.yml` and customize the variables as needed, some of them are typical options:
76+
Basically, go to `_config.yml` and configure the variables as needed. Some of them are typical options:
7777

7878
* `url`
7979

@@ -112,7 +112,7 @@ Few days later, you may find that the file changes does not refresh in real time
112112

113113
## Deploying to GitHub Pages
114114

115-
Before the deployment begins, ensure the `url` in file `_config.yml` has been set to `https://<username>.github.io`(or the custom domain, if you have. e.g. `https://yourdomain.com`). What's more, if you prefer to the [Project site](https://help.github.com/en/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites), change `baseurl` of file `_config.yml` to your project name, starting with a slash. e.g. `/project`.
115+
Before the deployment begins, checkout the file `_config.yml` and make sure that the `url` has been configured. What's more, if you prefer the [Project site on GitHub](https://help.github.com/en/github/working-with-github-pages/about-github-pages#types-of-github-pages-sites) and also use the default domain `<username>.github.io`, remember to change the `baseurl` to your project name that starting with a slash. For example, `/project`.
116116

117117

118118
### Option 1: Built by GitHub Pages
@@ -126,7 +126,7 @@ By deploying the site in this way, you're allowed to push the source code direct
126126
|Site Type | Repo's Name|
127127
|:---|:---|
128128
|User or Organization | `<username>.github.io`|
129-
|Project| any one except `<username>.github.io`, let's say `project`|
129+
|Project| Any one except `<username>.github.io`, let's say `project`|
130130

131131
**2**. Commit the changes of the repo first, then run the initialization script:
132132

@@ -168,7 +168,7 @@ For security reasons, GitHub Pages runs on `safe` mode, which means the third-pa
168168
|Site Type | Repo's Name|
169169
|:---|:---|
170170
|User or Organization | `<username>.github.io`|
171-
|Project| any one except `<username>.github.io`, let's say `project`|
171+
|Project| Any one except `<username>.github.io`, let's say `project`|
172172

173173
and clone it.
174174

@@ -189,4 +189,6 @@ The generated static files will be placed in the root of `/path/to/local/project
189189
|User or Organization | `https://<username>.github.io/`|
190190
|Project| `https://<username>.github.io/project/`|
191191

192-
and enjoy!
192+
### Finishing work
193+
194+
No matter which way you choose to deploy the website on GitHub, please enforce the `HTTPS` for it. See official docs: [Configuring a publishing source for your GitHub Pages site](https://help.github.com/en/github/working-with-github-pages/securing-your-github-pages-site-with-https).

docs/README_zh-CN.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
# Jekyll Theme Chirpy
1+
# Chirpy
2+
3+
语言: [English](../README.md) | **简体中文**
24

35
[![Build Status](https://github.com/cotes2020/jekyll-theme-chirpy/workflows/build/badge.svg?event=push)](https://github.com/cotes2020/jekyll-theme-chirpy/actions?query=event%3Apush)
46
[![GitHub license](https://img.shields.io/github/license/cotes2020/jekyll-theme-chirpy.svg)](https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE)
57
[![996.icu](https://img.shields.io/badge/link-996.icu-%23FF4D5B.svg)](https://996.icu)
68

7-
选择语言: [English](../README.md) | 简体中文
8-
99
一个不一样的 Jekyll 主题(内附神秘工具),采用响应式设计,方便记录、管理、分享你的知识和经验。
1010

1111
**功能一览**
@@ -24,8 +24,7 @@
2424
* SEO 优化
2525
* 网站性能优化
2626

27-
28-
[![devices-mockup](https://raw.githubusercontent.com/cotes2020/jekyll-theme-chirpy/master/assets/img/sample/devices-mockup.png)](https://chirpy.cotes.info)
27+
[![Devices Mockup](https://raw.githubusercontent.com/cotes2020/jekyll-theme-chirpy/master/assets/img/sample/devices-mockup.png)](https://chirpy.cotes.info)
2928

3029
## 目录
3130

0 commit comments

Comments
 (0)