• 永久链接
    • 背景
    • 永久链接
      • 配置永久链接
      • 模板变量

    永久链接

    背景

    在 1.x.x 版本之前,VuePress 会检索文档源目录下的所有 markdown 文件并按照文件的层次结构去定义页面链接。比如你有以下的文件结构:

    1. ├── package.json
    2. └── source
    3. ├── _post
    4. └── intro-vuepress.md
    5. ├── index.md
    6. └── tags.md

    那么你就会获得以下的可用页面:

    1. /source/
    2. /source/tags.html
    3. /source/_post/intro-vuepress.html

    看起来我们已经发现了 blog 的阴暗面。让我们继续看下去。

    永久链接

    一个永久链接是一个旨在未来很多年里维持不变的 URL,由此产生一个发生链接失效(link rot1)的可能性较小的超链接。VuePress 支持一种灵活的方式去生成固定链接,这种方式允许你使用各种模板变量。

    默认的永久链接是/:regular

    配置永久链接

    你可以使用全局配置来向所有页面应用永久链接:

    1. // .vuepress/config.js
    2. module.exports = {
    3. permalink: "/:year/:month/:day/:slug"
    4. };

    另外,你也可以只为单独一个页面去设置永久链接。这种方式比全局配置拥有更高的优先级。

    ? hello.md:

    1. ---
    2. title: Hello World
    3. permalink: /hello-world
    4. ---
    5. Hello!

    模板变量

    变量介绍
    :year文章发布的年份 (4数字)
    :month文章发布的月份 (2数字)
    :i_month文章发布的月份 (前面不带0)
    :day文章发布的日份 (2数字)
    :i_day文章发布的日份 (前面不带0)
    :slug蛞蝓化文件路径 (不带扩展名)
    :regularVuePress默认的生成永久链接的方式,具体实现看 这里