GitHub Pages,Hexo是什么
GitHub Pages
GitHub Pages是一項(xiàng)靜態(tài)站點(diǎn)托管服務(wù)蓝角,它直接從GitHub上的倉庫獲取HTML怖糊、CSS和JavaScript 文件颇象,(可選)通過構(gòu)建過程運(yùn)行文件伍伤,然后發(fā)布網(wǎng)站遣钳。此段文字引用于GitHub官方文檔,點(diǎn)擊此處可達(dá)蕴茴。
Hexo
Hexo是一個(gè)快速、簡潔且高效的博客框架倦淀。Hexo使用Markdown(或其他渲染引擎)解析文章,在幾秒內(nèi)撞叽,即可利用靚麗的主題生成靜態(tài)網(wǎng)頁。此段文字引用于Hexo官方文檔愿棋,點(diǎn)擊此處可達(dá)。
Hexo建立GitHub Pages
Github配置
- 新建repo糠雨,命名為username.github.io(比如hebe-tian.github.io),點(diǎn)擊創(chuàng)建
目前免費(fèi)用戶只能創(chuàng)建公開倉庫來使用GitHubPages - 創(chuàng)建倉庫之后會提示倉庫中沒有內(nèi)容甘邀,作為一個(gè)碼農(nóng),這必然是不能接受的一件事情松邪,所以我們需要新建一個(gè)文件,并且在中間鄭重的輸入
Hello World
测摔,然后把文件命名為index.html并保存 - 最后點(diǎn)擊Settings-Pages,已經(jīng)會提示我們個(gè)人網(wǎng)站的跳轉(zhuǎn)鏈接锋八,點(diǎn)擊就可以跳轉(zhuǎn)到新頁面(如果提示了404,可以等兩分鐘再刷新)
2和3的操作是為了確認(rèn)GitHubPages可以使用羞酗,并不會真的使用index.html這個(gè)頁面
環(huán)境配置
- 安裝,具體安裝方式可以在juejin檀轨、zhihu胸竞、jianshu等平臺搜索参萄,有條件的同學(xué)可以Google
- git
- node,npm
- 使用命令行讹挎,輸入
npm install -g hexo-cli
,如果提示沒有權(quán)限則再次輸入sudo npm install -g hexo-cli
筒溃,會提示輸入密碼 - 輸入
hexo -v
查看是否安裝成功,命令行返回hexo信息就表示hexo已安裝 - 使用在命令行輸入
npm install hexo-deployer-git --save
怜奖,如果提示沒有權(quán)限則再次輸入sudo npm install hexo-deployer-git –-save
(這個(gè)步驟也可以在后面執(zhí)行)
Hexo本地
- 創(chuàng)建一個(gè)文件夾,命名為username.github.io
- 使用命令行工具歪玲,進(jìn)入這個(gè)文件夾,執(zhí)行
hexo init
對文件夾進(jìn)行hexo初始化读慎,成功后會提示”Start blogging with Hexo!” - 測試hexo是否可用
- 在命令行輸入
hexo generate
或者hexo g
用來渲染頁面 - 在命令行輸入
hero server
或者hexo s
用來打開本地服務(wù)器槐雾,命令行會提示可以訪問http://localhost:4000 - 在瀏覽器訪問http://localhost:4000 就可以看到初始化的博客頁面,使用Control+C可以關(guān)閉服務(wù)
- 在命令行輸入
- 打開_config.yml文件(可以使用文本編輯或者編輯器)募强,修改其中的信息株灸,其中比較重要的:title、author擎值、language(zh-CN)慌烧、timezone(Asia/Shanghai)并保存
- 此時(shí)重新打開命令行,先輸入
hexo clean
清理緩存鸠儿,然后再執(zhí)行3中的操作屹蚊,這個(gè)時(shí)候博客展示的內(nèi)容就變成我們設(shè)置的內(nèi)容
Hexo與GitHub Pages
目前博客只能在本地訪問,如果需要關(guān)聯(lián)到github上进每,我們需要另外在_config.yml文件中配置
- 在github對應(yīng)的倉庫中使用ssh形式clone汹粤,得到對應(yīng)的SSH key
- 打開_config.yml文件,找到deploy對它進(jìn)行配置
- 編輯config文件
deploy:
type: git
repository: yourSSHKey
branch: master
需要注意所有:之后都要帶一個(gè)空格田晚,否則不會生效
- 部署到GitHub Pages
- 打開命令行嘱兼,先輸入
hexo clean
清理緩存 - 在命令行輸入
hexo generate
或者hexo g
用來渲染頁面 - 在命令行輸入
hexo server
或者hexo s
用來打開本地服務(wù)器,命令行會提示可以訪問http://localhost:4000 - 調(diào)試完成之后使用
hexo deploy
或者hexo d
用來把博客部署到git的服務(wù)器上
這一步需要注意贤徒,如果之前沒有執(zhí)行過npm install hexo-deployer-git --save
芹壕,需要在hexo d
之前執(zhí)行 - 訪問地址username.github.io汇四,可以看到托管在git上的博客(第一次沒有請求到的話,等兩分鐘再請求就能看到了)
- 打開命令行嘱兼,先輸入
發(fā)表新博客
打開命令行踢涌,執(zhí)行hexo new “blogname”
通孽,可以在source/_post中看到新建的blogname.md的文件,修改title并在正文內(nèi)寫入內(nèi)容隨后重新執(zhí)行部署命令就可以把新博客寫入到GitHub Pages里
下一篇的內(nèi)容
大概率可能是更換hexo的主題睁壁,在換主題的時(shí)候遇到了一些坑,下一篇博客會講next主題的使用
這篇文章也同步發(fā)表在我的GitHub Pages