一、前言
工作之后一直有寫作的沖動,想把自己的一些想法記錄下來,但可能是天生自帶的強迫癥,一直沒有好的平臺,所以一直沒有開始。之前看到過一些技術(shù)人員有自己的博客,而且是那種私人的博客,覺得非常的炫酷,從此就一直想要說自己也弄一個,其實關(guān)于博客的平臺有很多,很多人也喜歡在一些第三方平臺進行寫作,像是簡書、CSDN、知乎...但是有一個自己博客的想法一直在我腦海,這不剛好自己現(xiàn)在有時間了,就開始鼓搗起來了。
關(guān)于這篇博客
寫這篇博客主要是:
第一是對整個網(wǎng)站搭建過程進行記錄,幫助自己鞏固和總結(jié)一下
第二是搭建過程中也遇到了不少的坑和問題,將這些問題進行總結(jié)一下,幫助其他人少犯錯。
額外想說的一點:
這個雖然說是教程,但是隨著技術(shù)的更新,肯定會有部分的內(nèi)容沒有及時更新逐漸淘汰,所以我會盡量在寫的過程中提供相關(guān)的官方文檔鏈接,一般只要這個技術(shù)沒有被完全淘汰,他的官網(wǎng)文檔總是會進行更新的,所以如果我的教程中有哪些地方你覺得可能不太準(zhǔn)確,可以通過其中的官網(wǎng)鏈接進行查看。
二、教程部分
搭建博客網(wǎng)站是一個小的項目工程,所以不要想著一步成功,中間可能還會遇到各種Bug,可以將這個項目分為多個步驟進行,接下來我們開始第一部分(博客網(wǎng)站框架搭建):
- 了解Hexo
- 安裝Nodejs環(huán)境
- 安裝Hexo
- 搭建你的一個博客平臺
- 開始你的第一篇博客文章
開始準(zhǔn)備工作
- 首先你的電腦要安裝了Git(版本控制工具),不會的可以點擊Git官網(wǎng)進行下載安裝
- 安裝nodejs環(huán)境,可以去Node官網(wǎng)進行下載即可,這樣你就擁有了NPM包管理工具,就可以安裝hexo啦!
- 你需要注冊一個GitHub的賬號,因為你需要使用GitHub Pages
- 貌似目前就需要這些。。。
1.Hexo介紹
Hexo是基于NodeJs
的靜態(tài)博客框架,簡單、輕量,其生成的靜態(tài)網(wǎng)頁可以托管在Github
上。
- 超快速度
- 支持MarkDown
- 一件部署
- 豐富的插件
2.環(huán)境準(zhǔn)備
2.1 安裝node.js
去nodejs官網(wǎng)下載對應(yīng)系統(tǒng)的安裝包,按照提示進行安裝即可。可以使用以下命令檢驗是否安裝成功:
$ node -v
如果安裝成功將會顯示你安裝的node版本信息。
2.2 安裝Hexo
在你安裝好node之后你就可以使用npm安裝hexo,目前由于部分原因,npm并不是所有人都可以使用,如果不行的話可以使用淘寶鏡像操作沒有很大的不同,把npm
改成cnpm
即可,安裝Hexo的主要流程可以通過Hexo文檔進行查看,官方文檔都會持續(xù)更新。
$ npm install hexo-cli -g
3.使用Hexo搭建你的第一個博客
3.1 創(chuàng)建博客目錄
$ hexo init yourblogfilename
$ cd youeblogfilename
$ npm install
這里三個步驟分別是:
- 初始化你的博客的文件目錄
- 進入到你的博客文件目錄中
- 安裝npm
這里的
yourblogfilename
就是你本地博客的文件夾,這個名字你可以自己隨便取。
3.2 生成靜態(tài)頁面
$ hexo clean
$ hexo g
g表示generate
3.3 運行
$ hexo s
s表示server
這個時候你打開瀏覽器,輸入 http://localhost:4000/就可以看到效果啦!
這個時候你應(yīng)該是有一點小興奮的吧!終于看到了一個博客網(wǎng)站的大致雛形了,接下來你就可以自己嘗試發(fā)一篇文章試試!
4.你的第一篇博客文章
4.1 執(zhí)行命令
$ hexo new firstblog
這個時候在你的博客文件目錄的source/_posts
下會生成一個firstblog.md
文件,這個是一個Markdown文件,相信很多編程人員都知道,編寫Markdown文檔也是技術(shù)人員的基本功之一,所以你可以打開這個文件,隨便輸入一些文字,保存關(guān)閉即可。這將是你的第一篇博客文章,使用以下命令查看生成的效果:
$ hexo clean
$ hexo g
$ hexo s
打開瀏覽器,輸入 http://localhost:4000/查看效果。
4.2 更直接的方法
在source/_post/下新建一個.md
文件也可以
以上,你已經(jīng)完成了一個博客網(wǎng)站的基本搭建,可以自己查看自己的新建并且發(fā)布的的博客文章。但是它與我們所設(shè)想的還有一段距離,所以接下來我們就要開始進行以下操作:
- 配置站點信息
- 更換主題
- 配置主題信息
- 部署到Github
5.配置站點信息
網(wǎng)站的設(shè)置大部分都在_config.yaml文件中,詳細(xì)配置可以查看官方文檔
下面列舉一些常用配置:
-
title
-> 網(wǎng)站標(biāo)題 -
subtitle
-> 網(wǎng)站副標(biāo)題 -
description
-> 網(wǎng)站描述 -
author
-> 你的名字 -
langiage
-> 網(wǎng)站使用的語言
??注意:在配置時,需要加上冒號:
,冒號后面要加一個英文的空格,例如:
title: Kevin wan
6.換一個你喜歡的主題
配置好上面的站點信息以及發(fā)布了自己的博客文章之后,是不是發(fā)現(xiàn)Hexo這個自帶的主題有點丑呢?沒關(guān)系,Hexo中有很多主題,可以在Hexo官網(wǎng)查看。我自己使用的是Next主題,個人還是比較推薦的。
6.1 下載主題資源
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
當(dāng)然,這里我使用的Next主題作為例子,你也可以使用其他的主題,只需要將clone
后面的鏈接換成你的主題的URL即可。
6.2 使用下載主題
在站點配置文件,也就是_config.yaml中,配置theme
next是我使用的主題名稱,具體的可以通過主題文檔查看你的主題名稱
6.3 主題其他部分配置
到這一步你已經(jīng)可以看到一個比較漂亮的博客網(wǎng)站了,一個你喜歡的風(fēng)格的網(wǎng)站。當(dāng)然,還有一些細(xì)節(jié)的部分需要我們進行配置,這個時候可以根據(jù)主題的配置文檔進行主題配置,一般是在theme/{theme}/_config.yaml
主題配置文件下進行配置,Next主題的可以查看Next文檔,詳細(xì)的配置步驟這里就不多說了,可以按照自己的喜好進行配置。
在配置完之后怎么查看自己是否配置成功呢?可以使用完成的調(diào)試命令進行查看:
$ hexo clean
$ hexo g
$ s
這個時候本地瀏覽器訪問http://localhost:4000/即可
此時,你已經(jīng)完成了第二個部分,配置好了你的站點信息,選擇了自己喜歡的主題和配置了相應(yīng)的主題設(shè)置,但是目前這個網(wǎng)站僅限于我們自己本地進行瀏覽,無法讓別人看到,這就需要我們將我們的網(wǎng)站部署到Github上面去,至于什么是GitHub,知道的可以自己搜索一下,作為一名開發(fā)人員,GitHub肯定是要了解的,廢話不多少,接著操作:
- 注冊Github賬號
- 創(chuàng)建倉庫(repo)
- 網(wǎng)站配置
- 進行部署
7.部署到GitHub
7.1 注冊GitHub賬號
7.2 創(chuàng)建一個xxx.github.io的倉庫
這里的xxx是你的用戶名,例如我的用戶名是Xiankai-Wan
那么我的倉庫就命名為Xiankai-Wan.github.io
7.3 安裝hexo-deployer-git
$ npm install hexo-deployer-git --save
7.4站點配置Git
在站點而不是主題的_config.yaml
中配置deploy
deploy:
type: git
repo: <repository url>
branch: [branch]
-
type
這里默認(rèn)為git
-
repo
后面是你的這個repo的URL,可以在Github上面找到你的repo的地址 -
branch
表示分支,可以不填,一般為master - 還是那句話,冒號后面要有空格
7.5 部署
終端輸入:
$ hexo d
d 就是 deploy
將網(wǎng)站部署到GitHub已經(jīng)完成了,這一步還是比較簡單的,只需要一些基本的操作就可以了,這個時候你就可以通過xxx.github.io訪問自己的博客網(wǎng)站啦!
接下來我們需要配置一些其他的信息,例如每一個博客文章中都有標(biāo)簽,那這個是怎么來的呢?還有我們可以對每一篇博客文章進行分類,這個也是需要我們手動配置一下的,所以接下來我們開始:
- 配置標(biāo)簽頁
- 配置分類頁
8.創(chuàng)建標(biāo)簽頁
8.1 確認(rèn)相關(guān)信息
- 你需要確認(rèn)站點配置文件里面有:
tag_dir: tags
- 確認(rèn)主題配置文件有:
tags: tags
8.2 新建Tags頁面
$ hexo new page tags
這個時候會在source/
下面生成tags/index.md
文件
8.3 配置標(biāo)簽頁面
打開tags/index.md
,配置如下:
title: tags
date: 2017-10-20 06:49:50
type: "tags"
comments: false
date可以保持系統(tǒng)生成的時間,其他部分不要亂改
8.4 在文章中添加Tags
在完成以上操作之后,你就可以在自己的博客文章xx.md文件中添加:
tags:
- Tag1
- Tag2
- Tag3
多個Tag可以按照上面的格式進行添加。
之后你的博客文章文件頭部類似于:
title: TagEditText
date: 2016-11-19 10:44:25
tags:
- Tag1
- Tag2
- Tag3
9.創(chuàng)建分類頁
9.1 確認(rèn)相關(guān)信息
- 你需要確認(rèn)站點配置文件里面有:
category_dir: categories
- 確認(rèn)主題配置文件有:
categories: /categories
9.2 新建分類頁面
$ hexo new page categories
這個時候會在source
目錄下面生成categories/index.md
文件。
9.3 配置分類頁面
打開categories/index.md
,配置如下:
title: categories
date: 2015-10-20 06:49:50
type: "categories"
comments: false
date 可以保持系統(tǒng)生成的時間,其他不要隨意更改
9.4 在文章中添加categories
在完成以上操作之后,你就可以在自己的博客文章xx.md文件中添加:
categories:
- cate
之后你的博客文章文件頭部類似于:
title: TagEditText
date: 2016-11-19 10:44:25
categories:
- cate
三、總結(jié)
以上,就是整個博客網(wǎng)站的基本搭建過程,這個時候你已經(jīng)可以通過自己新建文件然后上傳部署到自己的博客上面了,每次編輯完成之后可以使用以下三個命令進行查看:
$ hexo clean
$ hexo g
$hexo d
也可以使用:
$ hexo s
進行本地測試,測試完成之后,在上傳到Github也可以。
關(guān)于站點和主題的其他配置,大部分都可以通過官方文檔進行配置,對于其他擴展應(yīng)用例如統(tǒng)計瀏覽量、加入評論系統(tǒng)等等,后期我會繼續(xù)總結(jié)發(fā)帖分享。