使用hexo搭建我的博客

本文介紹了使用hexo搭建我的博客的詳細過程~

本人博客，這是昨天剛剛搭起來的，還比較簡單，但願之後有時間慢慢把他作的愈來愈完善。

使用前準備

1.github

由於hexo是使用 GitHub Pages 來搭建的，因此在搭建以前要先確保有個github帳號。身爲一個進階中的程序員，github是居家旅行必備神器，相信你們都有啦，因此關於建立倉庫，設置ssh key之類的問題，在這裏就不贅述啦。

2.node，git

node.js和git 命令行是輔助工具，可是是必不可少的。在安裝hexo以前，要先確認電腦上已經安裝了node.js和git，安裝方法參考hexo官方文檔，這裏就不作介紹了。

hexo安裝

使用npm安裝hexo，在終端中運行命令

npm install -g hexo-cli

建站

1.github中建立倉庫

在github中新建一個倉庫，倉庫名稱爲 你的github名稱.github.io,倉庫名稱只有知足這個格式才能使用github的Pages主頁，不然不能使用。

2.本地建立倉庫

在本地建立一個文件夾，而後在終端打開這個文件後，執行命令

hexo init

若是執行以後這個樣子，就說明建立成功了。

建立成功的文件夾目錄以下：

配置

配置文件： ——config.yml,關於配置文件中主要的配置項能夠參考hexo官方文檔，這裏只對用的較多的進行介紹。

1.網站信息

參數	描述
title	網站標題
subtitle	網站副標題
description	網站描述,有利於seo優化
author	您的名字
language	網站使用的語言（中文：zh-CN）
timezone	網站時區。Hexo 默認使用您電腦的時區。（中國：Asia/Shanghai）時區列表。

注意：在設置時區的時候，不設置會默認採用電腦時區，北京時間可設置爲 Asia/Shanghai，第一眼看見這個時區的時候，我覺得這是上海時間，便自覺得的把時區設置成了 Asia/Beijing ,而後在編譯的時候，一直在報錯，後來廢了好大勁才找到問題所在，真是被本身蠢哭了。

#####2.目錄

參數	描述	默認值
url	網址
root	網站根目錄
permalink	文章的 永久連接 格式	:year/:month/:day/:title/
permalink_defaults	永久連接中各部分的默認值

若是您的網站存放在子目錄中，例如 http://yoursite.com/blog，則請將您的 url 設爲 http://yoursite.com/blog 並把 root 設爲 /blog/。

注意： url能夠設置爲本身的網址，可是本身須要註冊域名，有本身域名的同窗能夠將url替換爲本身的域名，沒有本身的域名，此處設置了url也不會生效，發佈成功後，本身的博客主頁網址爲：http://youname.github.io。若是本身沒有域名，此處url可隨便填，可是不可爲空，不然會報錯。（不要問我怎麼知道的~）

3.目錄

參數	描述	默認值
source_dir	資源文件夾，這個文件夾用來存放內容。	source
public_dir	公共文件夾，這個文件夾用於存放生成的站點文件。	public
tag_dir	標籤文件夾	tags
archive_dir	歸檔文件夾	archives
category_dir	分類文件夾	categories
code_dir	Include code 文件夾	downloads/code
i18n_dir	國際化（i18n）文件夾	:lang
skip_render	跳過指定文件的渲染，您可以使用 glob 表達式來匹配路徑。

此處不須要修改，除非有特殊需求。

4.文章

參數	描述	默認值
new_post_name	新文章的文件名稱	:title.md
default_layout	預設佈局	post
auto_spacing	在中文和英文之間加入空格	false
titlecase	把標題轉換爲 title case	false
external_link	在新標籤中打開連接	true
filename_case	把文件名稱轉換爲 (1) 小寫或 (2) 大寫	0
render_drafts	顯示草稿	false
post_asset_folder	啓動 Asset 文件夾	false
relative_link	把連接改成與根目錄的相對位址	false
future	顯示將來的文章	true
highlight	代碼塊的設置

5.主題

參數	描述
theme	當前主題名稱。值爲false時禁用主題

在更換主題時，先從github上把要更換的主題代碼clone下來，放入項目中themes文件夾中，而後把配置文件中theme字段設置爲更換的主題名稱便可。

6.部署

參數	描述
deploy	部署部分的設置

部署

hexo的部署方式有多種，默認爲git部署。由於我用的是git部署，因此在這裏就介紹git部署的過程。

安裝 hexo-deployer-git。

npm install hexo-deployer-git --save

配置文件中deploy：

deploy:
  type: git
  repo: <repository url> ## github上倉庫地址 ##
  branch: [branch] ## 分支名稱 ##
  message: [message]## 提交信息 ##

部署到hexo

hexo deploy

經常使用命令

init

hexo init [folder]

新建一個網站。若是沒有設置 folder ，Hexo 默認在目前的文件夾創建網站。

new

hexo new [layout] <title>

新建一篇文章。若是沒有設置 layout 的話，默認使用 _config.yml 中的 default_layout 參數代替。若是標題包含空格的話，請使用引號括起來。

generate

$ hexo generate

生成靜態文件。

選項 描述
-d, --deploy 文件生成後當即部署網站
-w, --watch 監視文件變更
該命令能夠簡寫爲

$ hexo g

server

hexo server

啓動服務器。默認狀況下，訪問網址爲： http://localhost:4000/。

選項 描述
-p, --port 重設端口
-s, --static 只使用靜態文件
-l, --log 啓動日記記錄，使用覆蓋記錄格式

deploy

hexo deploy

部署網站。

參數 描述
-g, --generate 部署以前預先生成靜態文件
該命令能夠簡寫爲：

$ hexo d

clean

hexo clean

清除緩存文件 (db.json) 和已生成的靜態文件 (public)。