From 36f55f091da53652dc4b3f748a84a791110339d0 Mon Sep 17 00:00:00 2001 From: Cotes Chung <11371340+cotes2020@users.noreply.github.com> Date: Sun, 5 Dec 2021 02:30:22 +0800 Subject: [PATCH] Add content to the tutorial --- _posts/2019-08-08-write-a-new-post.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/_posts/2019-08-08-write-a-new-post.md b/_posts/2019-08-08-write-a-new-post.md index 9ea249b..abe698e 100644 --- a/_posts/2019-08-08-write-a-new-post.md +++ b/_posts/2019-08-08-write-a-new-post.md @@ -9,9 +9,11 @@ tags: [writing] render_with_liquid: false --- +This post will guide you how to write a post on _Chirpy_ theme. Even if you have previous experience with Jekyll, this article is worth reading, because many features require specific variables to be set. + ## Naming and Path -Create a new file named `YYYY-MM-DD-TITLE.EXTENSION` and put it in the `_posts/` of the root directory. Please note that the `EXTENSION` must be one of `md` and `markdown`. +Create a new file named `YYYY-MM-DD-TITLE.EXTENSION` and put it in the `_posts` of the root directory. Please note that the `EXTENSION` must be one of `md` and `markdown`. If you want to save time of creating files, please consider using the plugin [`Jekyll-Compose`](https://github.com/jekyll/jekyll-compose) to accomplish this. ## Front Matter @@ -26,9 +28,9 @@ tags: [TAG] # TAG names should always be lowercase --- ``` -> **Note**: The posts' ***layout*** has been set to `post` by default, so there is no need to add the variable ***layout*** in the Front Matter block. +> **Note**: The posts' _layout_ has been set to `post` by default, so there is no need to add the variable _layout_ in the Front Matter block. -### Timezone of date +### Timezone of Date In order to accurately record the release date of a post, you should not only set up the `timezone` of `_config.yml` but also provide the post's timezone in variable `date` of its Front Matter block. Format: `+/-TTTT`, e.g. `+0800`. @@ -40,6 +42,17 @@ The `categories` of each post are designed to contain up to two elements, and th categories: [Animal, Insect] tags: [bee] ``` +### Author Information + +The author information of the post usually does not need to be filled in the _Front Matter_ , they will be obtained from variables `social.name` and the first entry of `social.links` of the configuration file by default. But you can also override it as follows: + +```yaml +--- +author: + name: Full Name + url: https://example.com +--- +``` ## Table of Contents