docs：update links of sample codes of 'post_link' plugin (#1205)

* update links of sample codes of 'post_link' plugin
* upate examples for all the languages

source/docs/tag-plugins.md

@@ -252,8 +252,8 @@ Inserts a responsive or specified size Vimeo video.
 Include links to other posts.
 
 ```
-{% post_path filename %}
-{% post_link filename [optional text] [escape] %}
+{% post_path slug %}
+{% post_link slug [title] [escape] %}
 ```
 
 You can ignore permalink and folder information, like languages and dates, when using this tag.
@@ -283,16 +283,16 @@ For instance:
 **Escape title.**
 
 ```
-{% post_link hexo-4-0-released 'How to use <b> tag in title' %}
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
 ```
-{% post_link hexo-3-9-released 'How to use <b> tag in title' %}
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
 
 **Do not escape title.**
 
 ```
-{% post_link hexo-4-0-released '<b>bold</b> custom title' false %}
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
 ```
-{% post_link hexo-3-9-released '<b>bold</b> custom title' false %}
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
 
 ## Include Assets
 

source/ko/docs/tag-plugins.md

@@ -222,6 +222,44 @@ Vimeo video를 포함시킬 수 있습니다.
 {% post_link slug [title] [escape] %}
 ```
 
+You can ignore permalink and folder information, like languages and dates, when using this tag.
+
+For instance: `{% raw %}{% post_link how-to-bake-a-cake %}{% endraw %}`.
+
+This will work as long as the filename of the post is `how-to-bake-a-cake.md`, even if the post is located at `source/posts/2015-02-my-family-holiday` and has permalink `2018/en/how-to-bake-a-cake`.
+
+You can customize the text to display, instead of displaying the post's title. Using `post_path` inside Markdown syntax `[]()` is not supported.
+
+Post's title and custom text are escaped by default. You can use the `escape` option to disable escaping.
+
+For instance:
+
+**Display title of the post.**
+
+`{% raw %}{% post_link hexo-3-8-released %}{% endraw %}`
+
+{% post_link hexo-3-8-released %}
+
+**Display custom text.**
+
+`{% raw %}{% post_link hexo-3-8-released 'Link to a post' %}{% endraw %}`
+
+{% post_link hexo-3-8-released 'Link to a post' %}
+
+**Escape title.**
+
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+
+**Do not escape title.**
+
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+
 ## Include Assets
 
 포스트의 asset을 포함시킬 수 있습니다.

source/pt-br/docs/tag-plugins.md

@@ -225,6 +225,44 @@ Incluir links para outras postagens.
 {% post_link slug [title] [escape] %}
 ```
 
+You can ignore permalink and folder information, like languages and dates, when using this tag.
+
+For instance: `{% raw %}{% post_link how-to-bake-a-cake %}{% endraw %}`.
+
+This will work as long as the filename of the post is `how-to-bake-a-cake.md`, even if the post is located at `source/posts/2015-02-my-family-holiday` and has permalink `2018/en/how-to-bake-a-cake`.
+
+You can customize the text to display, instead of displaying the post's title. Using `post_path` inside Markdown syntax `[]()` is not supported.
+
+Post's title and custom text are escaped by default. You can use the `escape` option to disable escaping.
+
+For instance:
+
+**Display title of the post.**
+
+`{% raw %}{% post_link hexo-3-8-released %}{% endraw %}`
+
+{% post_link hexo-3-8-released %}
+
+**Display custom text.**
+
+`{% raw %}{% post_link hexo-3-8-released 'Link to a post' %}{% endraw %}`
+
+{% post_link hexo-3-8-released 'Link to a post' %}
+
+**Escape title.**
+
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+
+**Do not escape title.**
+
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+
 ## Incluir Assets
 
 Incluir assets de postagem.

source/ru/docs/tag-plugins.md

@@ -222,6 +222,44 @@ content
 {% post_link slug [title] [escape] %}
 ```
 
+You can ignore permalink and folder information, like languages and dates, when using this tag.
+
+For instance: `{% raw %}{% post_link how-to-bake-a-cake %}{% endraw %}`.
+
+This will work as long as the filename of the post is `how-to-bake-a-cake.md`, even if the post is located at `source/posts/2015-02-my-family-holiday` and has permalink `2018/en/how-to-bake-a-cake`.
+
+You can customize the text to display, instead of displaying the post's title. Using `post_path` inside Markdown syntax `[]()` is not supported.
+
+Post's title and custom text are escaped by default. You can use the `escape` option to disable escaping.
+
+For instance:
+
+**Display title of the post.**
+
+`{% raw %}{% post_link hexo-3-8-released %}{% endraw %}`
+
+{% post_link hexo-3-8-released %}
+
+**Display custom text.**
+
+`{% raw %}{% post_link hexo-3-8-released 'Link to a post' %}{% endraw %}`
+
+{% post_link hexo-3-8-released 'Link to a post' %}
+
+**Escape title.**
+
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+
+**Do not escape title.**
+
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+
 ## Вставка материала
 
 Содержит содержимое материала.

source/th/docs/tag-plugins.md

@@ -221,8 +221,8 @@ content
 รวมลิงก์ของโพสต์อื่นๆเข้าไปใน  block:
 
 ```
-{% post_path filename %}
-{% post_link filename [optional text] [escape] %}
+{% post_path slug %}
+{% post_link slug [title] [escape] %}
 ```
 
 เวลาใช้แท็กนี้ ข้อมูล permalink และ folder เช่น ภาษาและวันเดือนปี จะถูกละเลย
@@ -237,6 +237,8 @@ content
 จะโชว์ให้เห็นได้ดัวยการตั้งค่า `post_path` ส่วน syntax ท่ีเป็น `[]()` 
 จะไม่สนับสนุนโดย hexo ในท่ีนี่
 
+Post's title and custom text are escaped by default. You can use the `escape` option to disable escaping.
+
 ยกตัวอย่างเช่น:
 
 **โชว์หัวข้อโพสต์**
@@ -251,6 +253,19 @@ content
 
 {% post_link hexo-3-8-released 'Link to a post' %}
 
+**Escape title.**
+
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+
+**Do not escape title.**
+
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
 
 ## Include Assets
 

source/zh-cn/docs/tag-plugins.md

@@ -260,6 +260,8 @@ content
 
 默认链接文字是文章的标题，你也可以自定义要显示的文本。此时不应该使用 Markdown 语法 `[]()`。
 
+默认对文章的标题和自定义标题里的特殊字符进行转义。可以使用`escape`选项，禁止对特殊字符进行转义。
+
 **链接使用文章的标题**
 
 `{% raw %}{% post_link hexo-3-8-released %}{% endraw %}`
@@ -272,6 +274,20 @@ content
 
 {% post_link hexo-3-8-released '通往文章的链接' %}
 
+**对标题的特殊字符进行转义**
+
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+
+**禁止对标题的特殊字符进行转义**
+
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+
 ## 引用资源
 
 引用文章的资源。

source/zh-tw/docs/tag-plugins.md

@@ -218,6 +218,44 @@ content
 {% post_link slug [title] [escape] %}
 ```
 
+You can ignore permalink and folder information, like languages and dates, when using this tag.
+
+For instance: `{% raw %}{% post_link how-to-bake-a-cake %}{% endraw %}`.
+
+This will work as long as the filename of the post is `how-to-bake-a-cake.md`, even if the post is located at `source/posts/2015-02-my-family-holiday` and has permalink `2018/en/how-to-bake-a-cake`.
+
+You can customize the text to display, instead of displaying the post's title. Using `post_path` inside Markdown syntax `[]()` is not supported.
+
+Post's title and custom text are escaped by default. You can use the `escape` option to disable escaping.
+
+For instance:
+
+**Display title of the post.**
+
+`{% raw %}{% post_link hexo-3-8-released %}{% endraw %}`
+
+{% post_link hexo-3-8-released %}
+
+**Display custom text.**
+
+`{% raw %}{% post_link hexo-3-8-released 'Link to a post' %}{% endraw %}`
+
+{% post_link hexo-3-8-released 'Link to a post' %}
+
+**Escape title.**
+
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+```
+{% post_link hexo-4-released 'How to use <b> tag in title' %}
+
+**Do not escape title.**
+
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+```
+{% post_link hexo-4-released '<b>bold</b> custom title' false %}
+
 ## 引用資產
 
 引用文章的資產。