經過各種找資料,踩過何種坑泰偿,終于搭建好了 hexo
,域名目前用得時 github
的柠横,我的 hexo
是 3.2.2
版本课兄,hexo
不同的版本晨继,很多配置都不一樣。好吧紊扬,廢話不多說了,開始吧餐屎。
之前是想著寫博客,一方面是給自己做筆記腹缩,可以提升自己的寫作、總結能力润讥,一個技術點我們會使用盘寡,并不難,但是要做到讓讓別人也能聽懂我們講得竿痰,還是需要一定的技巧和經驗的。很多類似于 CSDN
影涉、博客園也都可以寫文章,但是頁面的樣式我不是太喜歡弟胀,簡書還算好點得。最近看到一些大神們的博客孵户,貌似都是用 hexo
寫得,我也依葫蘆畫瓢的搭建了一個检柬。不羅嗦了,直接上搭建步驟何址。
簡介
hexo
是一個npm
包进胯,在node
環(huán)境上運行,功能就是將你的文章(.md
文件)生成為靜態(tài)html
文件胁镐。
基礎準備
下面正式開始搭建博客!首先要想使用 Hexo
和 github pages
搭建博客颇玷,需要以下環(huán)境:
- 在
github
上注冊一個賬號就缆,并創(chuàng)建一個指定名字的reposity
-
homebrew
套件管理器,主要用來安裝git
和node.js
-
git
版本管理工具 node.js
- 配置
SSH key
- 安裝
hexo
- 同步
hexo
博客到github
注冊Github賬號并創(chuàng)建reposity
申請完賬號竭宰,登陸之后,就可以創(chuàng)建 reposity
了渣淳,點擊 New repository
,會跳轉到這個界面:
安裝brewhome
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)”
安裝失敗, 執(zhí)行以下腳本卸載:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"
報錯:Failed to locate Homebrew!
執(zhí)行以下:
sudo rm -rf /usr/local/.git rm -rf Library .git .gitignore bin/brew README.md share/man/man1/brew rm -rf ~/Library/Caches/Homebrew
成功后入愧,再次執(zhí)行嗤谚,下載腳本:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
下載成功
安裝git版本管理工具
git
是一個強大的版本管理工具,github
的版本管理就是基于 git
的旁赊,現(xiàn)在 svn
基本過時了椅野,使用 Git
進行版本管理才是王道籍胯。安裝完 homebrew
之后,安裝 Git
幾乎零成本杖狼,還是在 terminal
終端妖爷,輸入以下命令:
brew install git
然后等一段時間就 ok
了,homebrew
會自動去幫你完成下載安裝絮识。
安裝node.js
hexo
是基于 node.js
的,所以要讓 hexo
運行熄攘,node.js
環(huán)境是必不可少的垃它。使用 homebrew
安裝 node.js
也特別簡單鲜屏,在 terminal
終端輸入如下命令:
brew install node
ps:安裝最新版的 Node.js
之后国拇,我們就可以使用 npm
命令惯殊,在 mac
下遇到 npm
命令找不到的問題,解決方案如下:
sudo ln -s /usr/local/bin/node /usr/bin/node
sudo ln -s /usr/local/lib/node /usr/lib/node
sudo ln -s /usr/local/bin/npm /usr/bin/npm
sudo ln -s /usr/local/bin/node-waf /usr/bin/node-waf
安裝hexo
前面我們安裝了 node.js
务热,裝完 node.js
之后己儒,我們就可以使用 npm
命令了,而 hexo
安裝就是使用 npm
闪湾,在終端輸入以下命令:
npm install -g hexo
ps:等待一會兒,hexo
會自動完成下載安裝途样。等 hexo
安裝完成之后,在創(chuàng)建一個文件夾陶夜,這個文件夾以后就是你存放本地博客的地方了裆站。
搭建hexo博客
創(chuàng)建新建一個文件夾黔夭,用來存放本地博客。
hexo init
npm install
hexo
會在創(chuàng)建的文件夾創(chuàng)建本地博客所需的一切資源纠修。
hexo server
訪問本地localhost:4000可以看到博客已經搭建成功厂僧。
同步hexo博客到github
- 配置本地和
github
的ssh
- 在
github
上創(chuàng)建名字為XXX.github.io
的項目,XXX
為自己的github
用戶名颜屠。 - 開本地的創(chuàng)建的文件夾中的
_config.yml
配置文件,將其中的type
設置為git
密浑。
檢查你電腦上現(xiàn)有的ssh key
cd ~/.ssh # 切換到ssh目錄
ls -al ~/.ssh # 查看
注意:
如果你本地沒有生成的話粗井,終端上面會顯示,No such file or directory
浇衬。說明你是第一次使用git,如果已經存在的話耘擂,則會顯示id_rsa
和id_rsa.pub
。
獲取ssh
ssh-keygen -t rsa -C "your.email@example.com" -b 4096
配置github的ssh
登陸github
后秩霍,點擊右上角自己的頭像–>點擊Your profile–>點擊你的博客遠程倉庫蚁阳,頁面中就能找到ssh。
安裝自動部署發(fā)布工具
這里用到了 hexo-deployer-git螺捐,使用如下命令安裝:
npm install hexo-deployer-git --save
配置hexo
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/sunjinshuai/sunjinshuai.github.com
branch: master
在terminal終端,執(zhí)行以下命令:
hexo generate // 可以簡寫成hexo g 根據(jù)markdown文件生成靜態(tài)文件
hexo deploy // 或者簡寫成hexo d 將本地修改椿疗,部署到遠端
此時糠悼,打開瀏覽器,訪問https://sunjinshuai.github.io 倔喂,就可以看到你的博客靖苇。
Hexo安裝新主題apollo
Hexo換皮膚還是比較簡單的班缰,既可以自己根據(jù)默認的主題來修改,也可以到https://hexo.io/themes/ 上去找主題埠忘。
安裝
github上的文檔給出了詳細的安裝命令:
hexo init #blogname#
cd #blogname#
npm install
npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive
git clone https://github.com/pinggod/hexo-theme-apollo.git themes/apollo
啟用
安裝成功后就可以開始啟用主題,主題的啟用需要修改_config.yml 的 theme 配置項為 apollo:
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: apollo
# 在歸檔頁面顯示所有文章
# 需要上面安裝的 hexo-generator-archive 插件支持
archive_generator:
per_page: 0
yearly: false
monthly: false
daily: false
hexo常用的命令
hexo init //在指定目錄執(zhí)行該命令名船,會將當前目錄初始化為hexo站點旨怠,生成hexo站點所需的一切文件
hexo new “my new blog title” //新建一篇文章。如果沒有設置 layout 的話鉴腻,默認使用 _config.yml 中的 default_layout 參數(shù)代替。如果標題包含空格的話蜓席,請使用引號括起來。
hexo clean // 清除緩存瓮床,如果對本地文件做了修改产镐,同步到遠程驗證修改的效果之前踢步,先clean,清除緩存
hexo generate // 可以簡寫成hexo g 根據(jù)markdown文件生成靜態(tài)文件
hexo server // 或者簡寫成hexo s 啟動本地hexo 服務器获印,默認localhost:4000可以訪問
hexo deploy // 或者簡寫成hexo d 將本地修改,部署到遠端
hexo version // 顯示hexo版本
關于HEXO安裝失敗的解決方法
目前國內npm源有問題兼丰;所以鍵入如下代碼即可安裝成功:
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install hexo-cli -g