front-matter使用詳解

歡迎訪問我的博客:林除夕

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
      - Games
      
    • 如上所示一篇文章可以設置多個標籤

  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
      

blog-tags

  1. categories創建步驟

    與tags步驟一致我就不再贅述。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章