Before 1.x.x, vuepress retrieves all markdown files in the documents source directory and defines the page links based on the file hierarchy. e.g. if you have the following file structure:
@@ -13,7 +14,7 @@ Before 1.x.x, vuepress retrieves all markdown files in the documents source dire
└── tags.md
```
Then you will get following available pages:
那么你就会获得以下的可用页面:
```
/source/
...
...
@@ -21,36 +22,28 @@ Then you will get following available pages:
/source/_post/intro-vuepress.html
```
However, for a blog system, we hope that the link of a post can be customized. VuePress started supporting this feature from `1.0.0`. which is known as `permalink`. Then, the actual pages would be:
看起来我们已经发现了 blog 的阴暗面。让我们继续看下去。
```
/source/
/source/tags/
/source/2018/4/1/intro-vuepress.html
```
It seems that we have seen the shadow of the blog. Let's continue to look down.
A permalink is a URL that is intended to remain unchanged for many years into the future, yielding a hyperlink that is less susceptible to link rot<sup>[1]</sup>. VuePress supports a flexible way to build permalinks, allowing you to leverage various template variables.
默认的永久链接是`/:regular`。
The default permalink is `/:regular`.
### 配置永久链接
### Configure Permalinks
You can configure globally to apply it for all pages:
你可以使用全局配置来向所有页面应用永久链接:
```js
// .vuepress/config.js
module.exports={
permalink:'/:year/:month/:day/:slug'
}
permalink:"/:year/:month/:day/:slug"
};
```
Alternatively, you can also set permalink on a page only, and it will have a higher priority than the global settings.
另外,你也可以只为单独一个页面去设置永久链接。这种方式比全局配置拥有更高的优先级。
📝 __hello.md__:
📝 **hello.md**:
```markdown
---
...
...
@@ -61,14 +54,17 @@ permalink: /hello-world
Hello!
```
### Template Variables
| Variable | Description |
|---|---|
|:year|Published year of posts (4-digit)|
|:month|Published month of posts (2-digit)|
|:i_month|Published month of posts (Without leading zeros)|
|:day|Published day of posts (2-digit)|
|:i_day|Published day of posts (Without leading zeros)|
|:slug|Slugified file path (Without extension)|
|:regular| Permalink generated by VuePress by default, for implementation see [here](https://github.com/vuejs/vuepress/blob/next/packages/%40vuepress/shared-utils/lib/fileToPath.js) |