Hexo系列(二) 配置文件詳解

時間 2020-06-07

標籤 hexo 系列配置文件詳解简体版

原文原文鏈接

Hexo 是一款優秀的博客框架，在使用 Hexo 搭建一個屬於本身的博客網站後，咱們還須要對其進行配置，使得 Hexo 更能知足本身的需求html

這裏所說的配置文件，是位於站點根目錄下的 _config.yml 文件，能夠直接用記事本打開進行編輯，文件中的具體配置項以下：hexo

一、Site

網站的個性化描述，你們須要根據本身的實際狀況認真填寫框架

Setting	描述
title	網站標題
subtitle	網站副標題
description	網站描述
keywords	網站關鍵字
author	網站做者
language	網站使用的語言，默認是`en` ，中文網站填`zh-Hans`
timezone	網站使用的時區，默認爲 `計算機的預設置`，能夠不填

二、URL

關於博客文章 URL 的設置，通常不用進行更改佈局

Setting	描述
url	網站的網址
root	網站的根目錄，也是存放文章的目錄
permalink	文章的連接格式，默認爲 `:year/:month/:day/:title/`
permalink_defaults	永久連接中每一個段的默認值

三、Directory

關於文件夾的設置，也是通常不用進行更改post

Setting	描述
source_dir	資源文件夾，存放用戶的資源文件，默認爲 `source`
public_dir	公用文件夾，存放生成的靜態文件，默認爲 `public`
tag_dir	標籤目錄，默認爲 `tags`
archive_dir	檔案目錄，默認爲 `archives`
category_dir	分類目錄，默認爲 `categories`
code_dir	代碼目錄，默認爲 `downloads/code`
i18n_dir	i18n目錄，默認爲 `:lang`
skip_render	儲存站長驗證文件，跳過指定文件的渲染

四、Writing

這裏是比較經常使用的寫做設置，能夠根據本身的寫做習慣隨時進行調整網站

Setting	描述
new_post_name	文章的文件名格式，默認爲 `:title.md`
default_layout	預設的佈局模板，默認爲 `post`
titlecase	標題是否使用首字母大寫，默認爲 `false`
external_link	連接是否在新標籤頁中打開，默認爲 `true`
filename_case	將文件名轉換爲 `1` 小寫或 `2` 大寫，默認爲 `0`
render_drafts	是否顯示渲染草稿，默認爲 `false`
post_asset_folder	是否啓用 Asset 文件夾，默認爲 `false`
relative_link	是否創建相對於根文件夾的連接，默認爲 `false`
future	是否顯示將來文章，默認爲 `true`
highlight	代碼塊設置

highlighturl

Setting	描述
enable	是否使用代碼高亮，默認爲 `true`
line_number	是否顯示行號，默認爲 `true`
auto_detect	是否自動檢測語言，默認爲 `false`
tab_replace	tab 替代設置

五、Home page setting

首頁設置，能夠本身決定每頁顯示的文章數量和顯示文章的順序spa

Setting	描述
index_generator	主頁設置

index_generator插件

Setting	描述
path	首頁的根目錄
per_page	每頁顯示文章的數量，默認爲 `10`
order_by	顯示文章的順序，默認爲 `-date`

六、Category & Tag

這裏是關於分類和標籤的配置code

Setting	描述
default_category	預設分類，默認爲 `uncategorized`
category_map	分類別名
tag_map	標籤別名

七、Date / Time format

時間和日期的顯示格式，通常沒特殊要求的也不須要改

Setting	描述
date_format	日期格式，默認爲 `YYYY-MM-DD`
time_format	時間格式，默認爲 `HH:mm:ss`

八、Pagination

這裏是分頁設置，能夠本身決定單個頁面上顯示的文章數量和分頁目錄

Setting	描述
per_page	單個頁面上顯示的文章數量，默認爲 `10` ，用 `0` 表示禁用分頁
pagination_dir	分頁目錄，默認爲 `page`

九、Extensions

這裏能夠設置主題類型和插件，以後的文章講到更換博客主題時須要進行更改

Setting	描述
theme	博客使用的主題，默認爲 `landscape`

十、Deployment

這裏是關於網站部署的配置，經常使用的有部署類型和部署地址

Setting	描述
deploy	網站部署配置

deploy

Setting	描述
type	網站部署類型
repo	網站部署地址

【參考資料】

https://hexo.io/docs/configuration

【Hexo系列相關文章】

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。