有些效果無法在這兒體現(xiàn)搔谴,如果想看完整的效果,請(qǐng)移步個(gè)人站點(diǎn)翼抠。
閱讀本篇前,請(qǐng)先閱讀前幾篇文章:
基于 Hexo 從零開始搭建個(gè)人博客(一)
基于 Hexo 從零開始搭建個(gè)人博客(二)
基于 Hexo 從零開始搭建個(gè)人博客(三)
前言
- 博客搭建過程遇到任何問題,優(yōu)先在本頁面搜索轰胁,檢查是否已經(jīng)有該配置教程。
- 遇到問題可以優(yōu)先在文章評(píng)論區(qū)留言朝扼,注意留言時(shí)請(qǐng)?zhí)顚懻_的郵箱以確保能收到站長的回復(fù)赃阀。
- 實(shí)在解決不了的問題可添加站長 Wechat ,添加好友時(shí)請(qǐng)備注自己的姓名+專業(yè)擎颖,如 張三 計(jì)算機(jī)科學(xué)與技術(shù)榛斯。
Front-matter
Front-matter 是 markdown 文件最上方以---
分隔的區(qū)域观游,用于指定個(gè)別檔案的變數(shù)。
- Page Front-matter 用于頁面配置
- Post Front-matter 用于文章頁配置
如果標(biāo)注可選的參數(shù)肖抱,可根據(jù)自己需要添加备典,不用全部都寫在markdown里
Page Front-matter
---
title:
date:
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
---
寫法 | 解釋 |
---|---|
title | 【必需】頁面標(biāo)題 |
date | 【必需】頁面創(chuàng)建日期 |
type | 【必需】標(biāo)籤、分類和友情鏈接三個(gè)頁面需要配置 |
updated | 【可選】頁面更新日期 |
description | 【可選】頁面描述 |
keywords | 【可選】頁面關(guān)鍵字 |
comments | 【可選】顯示頁面評(píng)論模塊(默認(rèn) true) |
top_img | 【可選】頁面頂部圖片 |
mathjax | 【可選】顯示mathjax(當(dāng)設(shè)置mathjax的per_page: false時(shí)意述,才需要配置提佣,默認(rèn) false) |
katex | 【可選】顯示katex(當(dāng)設(shè)置katex的per_page: false時(shí),才需要配置荤崇,默認(rèn) false) |
aside | 【可選】顯示側(cè)邊欄 (默認(rèn) true) |
aplayer | 【可選】在需要的頁面加載aplayer的js和css,請(qǐng)參考文章下面的音樂 配置 |
highlight_shrink | 【可選】配置代碼框是否展開(true/false)(默認(rèn)為設(shè)置中highlight_shrink的配置) |
Post Front-matter
---
title:
date:
updated:
tags:
categories:
keywords:
description:
top_img:
comments:
cover:
toc:
toc_number:
toc_style_simple:
copyright:
copyright_author:
copyright_author_href:
copyright_url:
copyright_info:
mathjax:
katex:
aplayer:
highlight_shrink:
aside:
---
寫法 | 解釋 |
---|---|
title | 【必需】文章標(biāo)題 |
date | 【必需】文章創(chuàng)建日期 |
updated | 【可選】文章更新日期 |
tags | 【可選】文章標(biāo)籤 |
categories | 【可選】文章分類 |
keywords | 【可選】文章關(guān)鍵字 |
description | 【可選】文章描述 |
top_img | 【可選】文章頂部圖片 |
cover | 【可選】文章縮略圖(如果沒有設(shè)置top_img,文章頁頂部將顯示縮略圖拌屏,可設(shè)為false/圖片地址/留空) |
comments | 【可選】顯示文章評(píng)論模塊(默認(rèn) true) |
toc | 【可選】顯示文章TOC(默認(rèn)為設(shè)置中toc的enable配置) |
toc_number | 【可選】顯示toc_number(默認(rèn)為設(shè)置中toc的number配置) |
toc_style_simple | 【可選】顯示 toc 簡潔模式 |
copyright | 【可選】顯示文章版權(quán)模塊(默認(rèn)為設(shè)置中post_copyright的enable配置) |
copyright_author | 【可選】文章版權(quán)模塊的文章作者 |
copyright_author_href | 【可選】文章版權(quán)模塊的文章作者鏈接 |
copyright_url | 【可選】文章版權(quán)模塊的文章連結(jié)鏈接 |
copyright_info | 【可選】文章版權(quán)模塊的版權(quán)聲明文字 |
mathjax | 【可選】顯示mathjax(當(dāng)設(shè)置mathjax的per_page: false時(shí),才需要配置术荤,默認(rèn) false) |
katex | 【可選】顯示katex(當(dāng)設(shè)置katex的per_page: false時(shí)倚喂,才需要配置,默認(rèn) false) |
aplayer | 【可選】在需要的頁面加載aplayer的js和css,請(qǐng)參考文章下面的音樂 配置 |
highlight_shrink | 【可選】配置代碼框是否展開(true/false)(默認(rèn)為設(shè)置中highlight_shrink的配置) |
aside | 【可選】顯示側(cè)邊欄 (默認(rèn) true) |
注意:我的博客根目錄路徑為 【G:/hexo-blog/blog-demo】瓣戚,下文所說的根目錄都是此路徑端圈,將用
[BlogRoot]
代替。如果不清楚根目錄路徑子库,請(qǐng)回到教程 基于 Hexo 從零開始搭建個(gè)人博客(二)舱权,查看你執(zhí)行hexo init xxx
這條命令時(shí)所選擇的路徑,例如我選擇的路徑是【G:/hexo-blog】仑嗅,我的博客根目錄即為【G:/hexo-blog/xxx】宴倍。
標(biāo)簽頁
- 前往你的Hexo博客根目錄,打開cmd命令窗口執(zhí)行
hexo new page tags
仓技。 - 在【BlogRoot/source/】會(huì)生成一個(gè)含有
index.md
文件的tags
文件夾鸵贬。
- 修改【BlogRoot/source/tags/index.md】,添加
type: "tags"
脖捻。
---
title: tags
date: 2022-05-29 21:42:56
type: "tags"
---
分類頁
- 前往你的Hexo博客根目錄阔逼,打開cmd命令窗口執(zhí)行
hexo new page categories
。 - 在【BlogRoot/source/】會(huì)生成一個(gè)含有
index.md
文件的categories
文件夾地沮。
- 修改【BlogRoot/source/categories/index.md】颜价,添加
type: "categories"
。
---
title: categories
date: 2022-05-29 21:57:07
type: "categories"
---
友情鏈接
創(chuàng)建友情鏈接頁面
- 前往你的Hexo博客根目錄诉濒,打開cmd命令窗口執(zhí)行
hexo new page link
周伦。 - 在【BlogRoot/source/】會(huì)生成一個(gè)含有
index.md
文件的link
文件夾。
- 修改【BlogRoot/source/link/index.md】未荒,添加
type: "link"
专挪。
---
title: link
date: 2022-05-29 22:03:35
type: "link"
---
友情鏈接頁面添加友鏈信息
前往Hexo博客目錄(【BlogRoot/source/_data】)創(chuàng)建一個(gè)文件link.yml
(如果沒有 _data 文件夾,請(qǐng)自行創(chuàng)建)。
- class_name: 友情鏈接
class_desc: 那些人寨腔,那些事
link_list:
- name: 唐志遠(yuǎn)の博客
link: https://fe32.top/
avatar: https://bu.dusays.com/2022/01/14/cd5ffd485f867.jpg
descr: 古今之成大事者速侈,不惟有超世之才,亦必有堅(jiān)忍不拔之志迫卢。
- class_name: 網(wǎng)站
class_desc: 值得推薦的網(wǎng)站
link_list:
- name: Twitter
link: https://twitter.com/
avatar: https://i.loli.net/2020/05/14/5VyHPQqR6LWF39a.png
descr: 社交分享平臺(tái)
class_name
和class_desc
支持 html 格式倚搬,如不需要,也可以留空乾蛤。
如果你想設(shè)置成本站友鏈頁的效果每界,請(qǐng)參考教程:基于Butterfly的外掛標(biāo)簽引入 。
圖庫
該效果無法展現(xiàn)眨层,請(qǐng)閱讀原文。
子頁面
該效果無法展現(xiàn)趴樱,請(qǐng)閱讀原文。
404頁面
主題內(nèi)置了一個(gè)簡單的404頁面叁征,可在設(shè)置中開放。
如需本地預(yù)覽捺疼,請(qǐng)?jiān)L問 http://localhost:4000/404.html
# A simple 404 page
error_404:
enable: true
subtitle: "頁面沒有找到"
background: