在 1.x.x 版本之前,VuePress 會檢索文檔源目錄下的所有 markdown 文件并按照文件的層次結構去定義頁面鏈接。 比如你有以下的文件結構:
├── package.json
└── source
├── _post
│ └── intro-vuepress.md
├── index.md
└── tags.md
那么你就會獲得以下的可用頁面:
/source/
/source/tags.html
/source/_post/intro-vuepress.html
然而對于 blog 來說,我們希望文章的鏈接更加靈活,而不是局限于目錄結構。VuePress 把這個功能稱為永久鏈接 (permalinks) ,并從 1.0.0 版本開始支持。
永久鏈接
一個永久鏈接是一個旨在未來很多年里維持不變的 URL,由此產生一個發生鏈接失效(link rot1 (opens new window))的可能性較小的超鏈接。VuePress 支持一種靈活的方式去生成固定鏈接,這種方式允許你使用各種模板變量。
默認的永久鏈接是/:regular
。
#配置永久鏈接
你可以使用全局配置來向所有頁面應用永久鏈接:
// .vuepress/config.js
module.exports = {
permalink: "/:year/:month/:day/:slug"
};
另外,你也可以只為單獨一個頁面去設置永久鏈接。這種方式比全局配置擁有更高的優先級。
?? hello.md:
---
title: Hello World
permalink: /hello-world
---
Hello!
#模板變量
變量 | 介紹 |
---|---|
:year | 文章發布的年份 (4數字) |
:month | 文章發布的月份 (2數字) |
:i_month | 文章發布的月份 (前面不帶0) |
:day | 文章發布的日份 (2數字) |
:i_day | 文章發布的日份 (前面不帶0) |
:slug | 蛞蝓化文件路徑 (不帶擴展名) |
:regular | VuePress默認的生成永久鏈接的方式,具體實現看 這里 |