Import the tutorial.

2025-12-18 05:41:31 +00:00 · 2019-09-30 20:38:58 +08:00
parent b845c829f6
commit daaad546bb
4 changed files with 388 additions and 0 deletions
--- a/_posts/2019-08-08-write-a-new-post.md
+++ b/_posts/2019-08-08-write-a-new-post.md
@@ -0,0 +1,108 @@
+---
+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/)