Blog Template

In i18n/conf.yml, use: Blog indicates that the blog template is used for rendering.

The markdown file of the blog post needs to include meta information.

Meta information must be at the beginning of the file, starting with --- and ending with ---. The format of the configuration information in between is YAML.

A demo file is configured as follows:

---

brief: |
  this is a demo brief
  you can write multiline

---

# title

… …

brief indicates the content summary, which will be displayed on the blog index page.

With the help of YMAL ' | ` syntax, you can write multi-line summaries.

The configuration for the directory tree on the right side of the blog is also a TOC file (see the previous chapter). Only articles listed in the TOC will appear in the blog's homepage index.

Articles that do not contain meta information will not appear on the blog's homepage, but they can appear in the directory tree on the right.

Author Information

Author information can be included in the meta information of the article, for example:

author: marlowe

Then edit the author.yml file in the source language directory and add author information, for example:

marlowe:
  name: Eleanor Marlowe
  title: Senior Translator
  url: https://github.com/i18n-site

name, url, and title are all optional. If name is not set, the key name (here marlowe) will be used as the name.

See the demo project's begin.md and author.yml

Pinned Articles

If you need to pin an article, run i18n.site and then edit the xxx.yml file under .i18n/data/blog, changing the timestamp to a negative number (multiple negative numbers will be sorted from largest to smallest).