手把手教 GitHub + Hexo 搭建博客

前言

在好久之前，博主就想着要有自主的博客專欄或者網站。經歷了博客園這個須要所謂的編輯審覈，一直比較困惑，這些編輯是什麼出身，怎麼知道技術博客的價值性。

接下來找到了開源中國，這個能夠自由發言的地方。不過，不知道是否是受衆面不廣，訪問量都不是很理想。

再而後就來本身動手開始搭建博客。從手寫html發佈文章，到使用jekyll，最後到了hexo陣營。

終於，有種找到家的趕腳。hexo不只搭建方便，並且在後續的功能擴展以及文章發佈都是很是方便的。不只如此，還能夠本地調試，預覽效果。最方便的是支持markdown編寫文檔。

本文就是介紹如何安裝使用hexo搭建屬於本身的博客。今後再也不擔憂投稿被莫名拒絕。能夠在本身的一畝三分地講述着本身的故事。

環境準備

安裝Git

MAC OS X 是自帶Git命令行工具。

Windows 能夠安裝Git Bash。

安裝Node.js

前往官方地址，根據教程安裝便可。

安裝hexo

$ sudo npm install hexo-cli -g

使用hexo

# 建立hexo文件夾
$ mkdir hexo

# 進入hexo文件夾
$ cd hexo

# 初始化hexo
$ hexo init

# 安裝依賴包
$ npm install

# 本地查看
# 先運行下面的命令，再在瀏覽器輸入localhost:4000便可
$ hexo server

# 問題：執行hexo server提示找不到該指令
# 解決辦法：在Hexo 3.0 後server被單獨出來了，須要安裝server，安裝的命令以下：
$ npm install hexo -server --save

生成靜態網站

$ hexo generate

目錄結構

.
├── .deploy #須要部署的文件
├── node_modules #Hexo插件
├── public #生成的靜態網頁文件
├── scaffolds #模板
├── source #博客正文和其餘源文件，40四、favicon、CNAME 都應該放在這裏
| ├── _drafts #草稿
| └── _posts #文章
├── themes #主題
├── _config.yml #全局配置文件
└── package.json

全局配置 _config.yml

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site #站點信息
title:  #標題
subtitle:  #副標題
description:  #站點描述，給搜索引擎看的
author:  #做者
email:  #電子郵箱
language: zh-CN #語言
# URL #連接格式
url:  #網址
root: / #根目錄
permalink: :year/:month/:day/:title/ #文章的連接格式
tag_dir: tags #標籤目錄
archive_dir: archives #存檔目錄
category_dir: categories #分類目錄
code_dir: downloads/code
permalink_defaults:
# Directory #目錄
source_dir: source #源文件目錄
public_dir: public #生成的網頁文件目錄
# Writing #寫做
new_post_name: :title.md #新文章標題
default_layout: post #默認的模板，包括 post、page、photo、draft（文章、頁面、照片、草稿）
titlecase: false #標題轉換成大寫
external_link: true #在新選項卡中打開鏈接
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
highlight: #語法高亮
  enable: true #是否啓用
  line_number: true #顯示行號
  tab_replace:
# Category & Tag #分類和標籤
default_category: uncategorized #默認分類
category_map:
tag_map:
# Archives
2: 開啓分頁
1: 禁用分頁
0: 所有禁用
archive: 2
category: 2
tag: 2
# Server #本地服務器
port: 4000 #端口號
server_ip: localhost #IP 地址
logger: false
logger_format: dev
# Date / Time format #日期時間格式
date_format: YYYY-MM-DD #參考http://momentjs.com/docs/#/displaying/format/
time_format: H:mm:ss
# Pagination #分頁
per_page: 10 #每頁文章數，設置成 0 禁用分頁
pagination_dir: page
# Disqus #Disqus評論，替換爲多說
disqus_shortname:
# Extensions #拓展插件
theme: landscape-plus #主題
exclude_generator:
plugins: #插件，例如生成 RSS 和站點地圖的
- hexo-generator-feed
- hexo-generator-sitemap
# Deployment #部署，將 lmintlcx 改爲用戶名
deploy:
  type: git
  repo: github創庫地址.git
  branch: master

注意

• 配置文件的冒號「:」後面有一個空格
• repo: github創庫地址.git

hexo命令行使用

經常使用命令：
hexo help #查看幫助
hexo init #初始化一個目錄
hexo new "postName" #新建文章
hexo new page "pageName" #新建頁面
hexo generate #生成網頁，能夠在 public 目錄查看整個網站的文件
hexo server #本地預覽，'Ctrl+C'關閉
hexo deploy #部署.deploy目錄
hexo clean #清除緩存，強烈建議每次執行命令前先清理緩存，每次部署前先刪除 .deploy 文件夾

簡寫：
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

使用GitHub

註冊帳號

前往GitHub官網註冊帳號，按照網站提示註冊。

建立代碼倉庫

這個倉庫的名字須要和你的帳號對應。格式: yourname.github.io

具體使用GitHub能夠參考：《GitHub 使用》

編輯文章

# 新建文章
$ hexo new "標題"

在 _posts 目錄下會生成文件標題.md

---
title: Hello World
date: 2015-07-30 07:56:29 #發表日期，通常不改動
categories: hexo #文章文類
tags: [hexo,github] #文章標籤，多於一項時用這種格式
---
正文，使用Markdown語法書寫

編輯完後保存, 預覽

$ hexo server

hexo部署

執行下列指令完成部署

hexo generate
hexo deploy

如下提示說明部署成功

[info] Deploy done: git

至此，博客搭建完成，基本使用介紹完畢。但願對你們有所幫助。