109 lines
3.1 KiB
Markdown
109 lines
3.1 KiB
Markdown
|
---
|
||
|
|
title: "Write a new Post"
|
||
|
|
date: 2019-08-08 14:10:00 +0800
|
||
|
|
categories: [Blogging, Tutorial]
|
||
|
|
tags: [writting]
|
||
|
|
---
|
||
|
|
|
||
|
|
## Naming and Path
|
||
|
|
|
||
|
|
Create a new file name with the format `YYYY-MM-DD-title.md` then put it into `_post` of the root directory.
|
||
|
|
|
||
|
|
## Front Matter
|
||
|
|
|
||
|
|
Basically, you need to fill the [Front Matter](https://jekyllrb.com/docs/front-matter/) as below at the top of the post:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
title: TITLE
|
||
|
|
date: YYYY-MM-DD HH:MM:SS +/-TTTT
|
||
|
|
categories: [TOP_CATEGORIE, SUB_CATEGORIE]
|
||
|
|
tags: [TAG]
|
||
|
|
---
|
||
|
|
```
|
||
|
|
|
||
|
|
> **Note**: The posts' ***layout*** has been set to `post` by default, so there is no need to add the variable ***layout*** in Front Matter block.
|
||
|
|
|
||
|
|
### Categories and Tags
|
||
|
|
|
||
|
|
The pages for all the categories and tags are placed in the `categoreis` and `tags` respectively.
|
||
|
|
|
||
|
|
Let's say there is a post with title `The Beautify Rose`, it's Front Matter as follow:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
title: "The Beautify Rose"
|
||
|
|
categories: [Plant]
|
||
|
|
tags: [flower]
|
||
|
|
---
|
||
|
|
```
|
||
|
|
|
||
|
|
> **Note**: `categories` is designed to contain up to two elements.
|
||
|
|
|
||
|
|
|
||
|
|
## Table of Contents
|
||
|
|
|
||
|
|
By default, the **T**able **o**f **C**ontents (TOC) is displayed on the right panel of the post. If you want to turn it off globally, go to `_config.yml` and set the variable `toc` to `false`. If you want to turn off TOC for specific post, add the following to post's [Front Matter](https://jekyllrb.com/docs/front-matter/):
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
toc: false
|
||
|
|
---
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Comments
|
||
|
|
|
||
|
|
Similar to TOC, the [Disqus](https://disqus.com/) comments is loaded by default in each post, and the global switch is defined by variable `comments` in file `_config.yml` . If you want to close the comment for specific post, add the following to the **Front Matter** of the post:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
comments: false
|
||
|
|
---
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Code Block
|
||
|
|
|
||
|
|
Markdown symbols <code class="highlighter-rouge">```</code> can easily create a code block as following examples.
|
||
|
|
|
||
|
|
```
|
||
|
|
This is a common code snippet, without syntax highlight and line number.
|
||
|
|
```
|
||
|
|
|
||
|
|
## Specific Language
|
||
|
|
|
||
|
|
Using <code class="highlighter-rouge">```Language</code> you will get code snippets with line Numbers and syntax highlight.
|
||
|
|
|
||
|
|
> **Note**: The Jekyll style `{% raw %}{%{% endraw %} highlight LANGUAGE {% raw %}%}{% endraw %}` or `{% raw %}{%{% endraw %} highlight LANGUAGE linenos {% raw %}%}{% endraw %}` are not allowed to be used in this theme !
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
# Yaml code snippet
|
||
|
|
items:
|
||
|
|
- part_no: A4786
|
||
|
|
descrip: Water Bucket (Filled)
|
||
|
|
price: 1.47
|
||
|
|
quantity: 4
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Liquid codes
|
||
|
|
|
||
|
|
If you want to display the **Liquid** snippet, surround the liquid code with `{% raw %}{%{% endraw %} raw {%raw%}%}{%endraw%}` and `{% raw %}{%{% endraw %} endraw {%raw%}%}{%endraw%}` .
|
||
|
|
|
||
|
|
{% raw %}
|
||
|
|
```liquid
|
||
|
|
{% if product.title contains 'Pack' %}
|
||
|
|
This product's title contains the word Pack.
|
||
|
|
{% endif %}
|
||
|
|
```
|
||
|
|
{% endraw %}
|
||
|
|
|
||
|
|
## Learn More
|
||
|
|
For more knowledge about Jekyll posts, visit the [Jekyll Docs: Posts](https://jekyllrb.com/docs/posts/).
|
||
|
|
|
||
|
|
## See Also
|
||
|
|
|
||
|
|
* [Getting Started]({{ site.baseurl }}/posts/getting-started/)
|
||
|
|
* [Text and Typography]({{ site.baseurl }}/posts/text-and-typography/)
|
||
|
|
* [Customize the Favicon]({{ site.baseurl }}/posts/customize-the-favicon/)
|