frontmatter使用详解

74次阅读

共计 1452 个字符,预计需要花费 4 分钟才能阅读完成。

欢迎访问我的博客:林除夕

front-matter 包含的内容

参数 描述 默认值
layout 布局
title 标题
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
tags 标签(不适用于分页)
categories 分类(不适用于分页)
permalink 覆盖文章网址
keywords 仅用于 meta 标签和 Open Graph 的关键词(不推荐使用)

什么是 front-matter

  1. ---
    title: tags
    date: 2019-08-13 09:39:50
    type: tags
    layout: tag
    ---
  2. 就是.md 文件最上面的这部分内容

标签详解(只讲解官方文档中说的模糊的)

  1. layout

    • 作用:指定要使用的模版样式
    • 例如我上面的例子中使用的 tag 模版
    • 如果不指定这个将会使用 根目录 /_config.yml中的默认配置default_layout: post
  2. tags

    • 作用:给文章添加标签,使其能在标签页中显示
    • 如何使用:
    • tags:
      - PS3
    -  如上所示一篇文章可以设置多个标签
  3. categories

    • 整体内容基本与 tags 一致
    • 区别在于在进行分类管理的时候此标签下的内容是 有严格的顺序和层次 的,tags 没有
    • categories:
      - Diary

    因为 hexo 的分类具有层次关系,同一文章不能同时存在两个同级分类中,所以下面这种方式

    categories:

    • Diary
    • Life

    会使分类 Life 成为 Diary 的子分类,而不是并列分类。因此,有必要为您的文章选择尽可能准确的分类。

  4. permalink

    • 直白的说就是静态文件的存放地址
    • 如果不指定这个将会使用 根目录 /_config.yml中的默认配置permalink: :year/:month/:day/:title/
    • 如果指定的文件夹不存在就会创建一个
    • 你如何设置最后在页面中使用的连接地址就会是什么样的,例如上面这种方式最终生成的文章的连接地址就是xxx.github.io/2019/08/11/:title/
  5. keywords

    • 用于 SEO 优化
    • 你这篇文章包含哪些关键词
    • 人家百度这些关键词的时候可能就会显示你的页面

拓展:当前的主题中没有分类页和标签页怎么办

这个问题困扰了我一段时间,网上也没有比较好的答案所以现在写出来,给大家。

  1. tags 创建步骤

    ​ 根据你的配置创建文件夹,在我的配置中 (根目录 /_config.yml) 设置的标签根目录为tag_dir: tags,所以我新建额是 tags 目录,你可以根据你的情况处理。

    1. 创建 tags 文件夹,在命令行中输入:

      
      hexo new page "tags"
    2. 找到新建的文件夹 \source\tags 下的 index.md 文件
    3. 修改其 front-matter 为如下格式

      ---
      title: tags
      date: 2019-08-13 09:39:50
      type: tags    // 帮助脚本识别这是一个用来创建 tags 的文档
      layout: tag // 我的 tags 模版标签叫 tag 你可以根据你的模版名称输入对应的名称
      ---
    4. 生成静态文件

      hexo g
    5. 通过主题设置 /themes/ 你的主题名称 /_config.yml 中的配置,在页面指定一个连接指向 tags 文件夹,就可以在页面中看到标签页了

      menu:
        # Project:
        #   path: /categories/Projects
        #   card: project-card
        # Stuffs:
        #   path: /tags/Stuffs
        #   card: article-card
        Home: /
        tags: /tags

  1. categories 创建步骤

    与 tags 步骤一致我就不再赘述。

正文完
 0