1.前言
github pages介紹:
1.一般多用于托管個人的靜態(tài)網(wǎng)站
2.省去了購買服務(wù)器、域名等等一系列復(fù)雜的操作
github pages好處:
1.全是靜態(tài)文件,訪問速度快
2.免費方便尸疆,不用花一分錢就可以搭建一個自由的個人博客社裆,不需要服務(wù)器不需要后臺
3.數(shù)據(jù)絕對安全,基于github的版本管理拣播,想恢復(fù)到哪個歷史版本都行
4.博客內(nèi)容可以輕松打包愧杯、轉(zhuǎn)移黄刚、發(fā)布到其它平臺
5.等
2.準備工作
1.注冊一個github賬號(已有不用)
2.安裝了node.js、npm民效,并了解相關(guān)基礎(chǔ)知識憔维;
3.安裝了git for windows(或者其它git客戶端)
3.開始搭建github博客
3.1github中創(chuàng)建倉庫
倉庫名為用戶名.github.io(必須與用戶名一致),網(wǎng)站訪問地址是?http://用戶名.github.io?了創(chuàng)建成功后畏邢,默認會在你這個倉庫里生成一些示例頁面业扒,以后你的網(wǎng)站所有代碼都是放在這個倉庫里。
4.配置SSH key
配置原因:因為提交代碼肯定要擁有你的github權(quán)限才可以舒萎,但是直接使用用戶名和密碼太不安全了程储,所以我們使用ssh key來解決本地和服務(wù)器的連接問題
用git bash執(zhí)行如下命令:
1.$ cd~/.ssh#檢查本機已存在的ssh密鑰?
(如果提示:No such file or directory 說明你是第一次使用git。)
2.$?ssh-keygen -t rsa -C "郵件地址"
(然后連續(xù)3次回車臂寝,最終會生成一個文件在用戶目錄下章鲤,打開用戶目錄,到.ssh\id_rsa.pub文件咆贬,記事本打開并復(fù)制里面的內(nèi)容败徊,打開你的github主頁,進入個人設(shè)置 -> SSH and GPG keys -> New SSH key:)
(id_rsa和id_rsa.pub,分別表示私鑰和公鑰文件, 私鑰文件自己使用, 公鑰文件需要上傳到Github上.)
3.測試是否成功
$ ssh -Tgit@github.com# 注意郵箱地址不用改
(如果提示Are you sure you want to continue connecting (yes/no)?掏缎,輸入yes皱蹦,然后會看到:Hi QzzBL You’ve successfully authenticated, but GitHub does not provide shell access.)
說明SSH已配置成功!
4.繼續(xù)配置設(shè)置用戶信息:
$ git config --global user.name "liuxianan"http:// 你的github用戶名眷蜈,非昵稱
$ git config --global user.email "xxx@qq.com"http:// 填寫你的github注冊郵箱
5.hexo寫博客
5.1 安裝
$ npm install-g hexo
5.2?初始化
$ cd/f/Workspaces/hexo/
$ hexo init
5.3
$ hexo g# 生成(靜態(tài)頁面)
$ hexo s# 啟動服務(wù)(開啟本地預(yù)覽服務(wù)沪哺,打開瀏覽器訪問?http://localhost:4000?即可看到內(nèi)容)
(執(zhí)行以上命令之后,hexo就會在public文件夾生成相關(guān)html文件酌儒,這些文件將來都是要提交到github去的:)
6.上傳到github
首先辜妓,ssh key肯定要配置好。
其次忌怎,配置_config.yml中有關(guān)deploy的部分:
正確寫法:
deploy:? type: git? repository:git@github.com:liuxianan/liuxianan.github.io.git??
branch: master
錯誤寫法:
deploy:? type: github? repository:https://github.com/liuxianan/liuxianan.github.io.git
branch: master
(后面一種寫法是hexo2.x的寫法籍滴,現(xiàn)在已經(jīng)不行了,無論是哪種寫法呆躲,此時直接執(zhí)行hexo d的話一般會報如下錯誤:
Deployer not found: github 或者 Deployer not found: git
原因是還需要安裝一個插件:
npm install hexo-deployer-git --save ? (hexo-deployer-git 會存在于node_modules文件夾中)
)
打開你的git bash异逐,輸入hexo d就會將本次有改動的代碼全部提交
7.常見hexo命令及上傳步驟
常見命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建頁面
hexo generate #生成靜態(tài)頁面至public目錄
hexo server #開啟預(yù)覽訪問端口(默認端口4000捶索,'ctrl + c'關(guān)閉server)
hexo deploy #部署到GitHub
hexo help? # 查看幫助
hexo version? #查看Hexo的版本
hexo new page 'postName'命令和hexo new 'postName'有區(qū)別:
hexo new page "my-second-blog"
生成如下:
最終部署時生成:hexo\public\my-second-blog\index.html插掂,但是它不會作為文章出現(xiàn)在博文目錄。
縮寫:
hexo n == hexo new
hexo g == hexo generate(此三步驟完成上傳)
hexo s == hexo server
hexo d == hexo deploy
組合命令:
hexo s -g #生成并本地預(yù)覽
hexo d -g #生成并上傳
8.個人安裝時問題
1.訪問username.github.io時出現(xiàn)404錯誤(可能與沒有分支 git init 等安裝分支)
2.主題修改本地可看,github上看不了
3.等等
9.參考文章
http://blog.haoji.me/build-blog-website-by-hexo-github.html?from=xa
http://www.reibang.com/p/380290deb8f0
https://blog.csdn.net/zxy987872674/article/details/72491066