Sorry, your browser cannot access this site
This page requires browser support (enable) JavaScript
Learn more >

Layout template

pageIndependent page
postArticle page
docsDocumentation page
categoryCategory page
tagTag page
friendsFriends link page
listList page

page & post & docs

These three types of pages are the same, but have the following subtle differences:

  • When the post article has a title, scroll down the web page, the navigation bar will move up and out of the screen to display the article title, but page and docs will not.
  • post At the end of the article, up to four modules can be displayed: "Reference", "Related Article", "Copyright Mark", and "Reward".
  • At most one module of "reference" can be displayed at the end of the docs article.

Except that the archive page is automatically generated, other independent pages need to be created manually.

Archive page

The archive page is automatically generated and has been generated during initialization. The path is as follows:

# Directory
archive_dir: archives

About page

Create file if not exists: source/about/
layout: docs
seo_title: About
bottom_meta: false
sidebar: []
placeholder: What do you want to tell me?

Write about yourself below

Category page

Create file if not exists: source/categories/
layout: category
index: true
title: All categories

Tag page

Create file if not exists: source/tags/
layout: tag
index: true
title: all tags

List page

Create file if not exists: source/mylist/
layout: list
group: mylist
index: true

The result is to filter out all articles that contain group: mylist in the front-matter section.

Create page file

Create file if not exists: source/friends/
layout: friends # required
title: My friends # Optional, this is the title of the friend link page

Write the content above the friend chain here.

<!-- more -->

Here you can write text notes at the bottom of the friend chain page, such as your own friend chain specifications, examples, etc.

Choose a layout

Find the following in the theme configuration file:

# Friends link page configuration
layout_scheme: traditional # simple: simple layout, traditional: traditional layout, sites: website card layout

Three layout schemes are currently provided:

  • simple: Simple layout, only avatar and title.
  • traditional: Traditional layout, the style of the old version of Volantis.
  • sites: site card layout, which is the new style of website card tags added in Volantis 4.x.

Set data source

The data source of Friends Chain is written in the following path, if not, please create it yourself:


The content format is:

-group: # Group title
description: # Group description
-title: # name
avatar: # Avatar
url: # link
screenshot: # Screenshot
keywords: # Keywords
description: # description
-title: # name
avatar: # Avatar
url: # link
screenshot: # Screenshot
keywords: # Keywords
description: # description

Different layout methods will use some fields. Generally speaking, title, ʻavatar and ʻurl are all required. These data are converted into HTML tags and inserted into the <!-- more --> part of the friend link page.

Use the issues tag to get JSON data from issues to parse and generate HTML to fill in the page. The usage is as follows:

{% issues sites | api= %}

In this way, the way to add a friend chain becomes: the other party raises an Issue, reviews it by yourself, then adds the ʻactive` tag, and then refreshes the webpage to take effect. It is also very convenient to update the content of the friend chain. The creator of the issue has the right to modify and close it.

Create a new GitHub or Gitee repository and create the Issues template as follows:

"title": "",
"screenshot": "",
"url": "",
"avatar": "",
"description": "",
"keywords": ""

For details on how to use the issues tag, see this article:


  • Both can be used at the same time. It is recommended to open the issues friend chain to everyone, and save it to the static friend chain if you contact yourself frequently.
  • The actual speed and stability of the GitHub API is not as good as Gitee. If you pursue stability, it is recommended to use Gitee.

404 page

Create file if not exists: source/
cover: true
robots: noindex,nofollow
sitemap: false
seo_title: 404 Not Found
bottom_meta: false
sidebar: []
path: /404.html
placeholder: Please leave a message and tell me which page you want to visit is not found

{% p logo center huge, 404 %}
{% p center bold, sorry, the page you visited does not exist %}
{% p center small, the address may be entered incorrectly or the address has been deleted %}

User Exchange Area

This is only for communication between users. If you have any questions, please go to GitHub to submit an issue. Asking questions in the comment area will not receive any response from the developer!