Cloud-Link's blog Cloud-Link's blog
首页
  • 开发资源
  • 人员动态
  • 新人训练
  • 奖惩通报
  • 通讯录
项目资产
  • 快速指南
  • 后端框架
  • 前端框架
  • 业务模块
  • 基础理论
    • 前端
    • 后端
    • 数据库
    • 工具类
  • 常用
  • 网站
  • 资源
  • Vue资源
  • 分类
  • 标签
  • 归档
关于
首页
  • 开发资源
  • 人员动态
  • 新人训练
  • 奖惩通报
  • 通讯录
项目资产
  • 快速指南
  • 后端框架
  • 前端框架
  • 业务模块
  • 基础理论
    • 前端
    • 后端
    • 数据库
    • 工具类
  • 常用
  • 网站
  • 资源
  • Vue资源
  • 分类
  • 标签
  • 归档
关于
  • 前端

  • 后端

  • 数据库

  • 工具类

    • Vepress

      • 介绍
      • 快速上手
      • 目录结构
      • 核心配置和约定
      • 文档编写和一级标题
      • 自动生成front matter
        • 批量操作front matter工具
        • Markdown 容器
        • Markdown使用教程
        • Markdown 中使用组件
        • 提高文档表现力
      • Git

      • npm

    • Vue

    • TypeScript

    • React

    • 知识库
    • 工具类
    • Vepress
    2021-06-18

    自动生成front matter

    当你没有给.md文件的front matter (opens new window)指定标题(title)、时间(date)、永久链接(permalink)、分类(categories)、标签(tags)时,在运行开发服务npm run dev或打包npm run build时将自动为你生成这些数据,你也可以自己手动设置这些数据,当你手动设置之后,相应的数据就不会再自动生成。

    # 生成示例

    ---
    title: JavaScript教程
    date: 2021-05-12 11:51:53
    permalink: /pages/d8cae9
    categories:
      - 前端
      - JavaScript
    tags:
      -
    ---
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10

    # title

    • 类型: string

    • 默认值:.md文件的名称

    当前页面的标题

    # date

    • 类型: string
    • 格式:YYYY-MM-DD HH:MM:SS
    • 默认值:.md文件在系统中创建的时间

    当前页面的创建时间,如需手动添加或修改该字段时请按照格式添加或修改

    # permalink

    • 类型: string
    • 默认值:/pages/+ 6位字母加数字的随机码

    当前页面的永久链接

    Q:自动生成front matter为什么要包含永久链接?

    A:使用永久链接是出于以下几点考虑:

    • 在config.js配置nav时使用永久链接,就不会因为文件的路径或名称的改变而改变。
    • 对于博客而言,当别人收藏了你的文章,在未来的时间里都可以通过永久链接来访问到。
    • 主题中的目录页需要通过永久链接来访问文章。

    # categories

    • 类型: array
    • 默认值:
      • .md所在的文件夹名称。
      • 如果.md文件所在的目录是三级目录,则会有两个分类值,分别是二级目录和一级目录的文件夹名称。如果在四级目录,则再多一个三级目录的文件夹名称分类。(级别说明)
      • 如果.md文件所在的目录是_posts,则默认值是随笔,这个默认值可以在config.js中修改,参考:config.js配置
    • 如果在 config.js配置 设置了category: false 将不会自动生成该字段

    当前页面的分类

    # tags

    • 类型: array
    • 默认值:空数组
    • 如果在 config.js配置 设置了tag: false 将不会自动生成该字段

    当前页面的标签,默认值是空数组,自动生成该字段只是为了方便后面添加标签值。

    文档编写和一级标题
    批量操作front matter工具

    ← 文档编写和一级标题 批量操作front matter工具→

    Copyright © 2021-2022 用技术改变世界 | Tungray Cloud-Link
    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式
    ×