演示博客:https://earthsoar.github.io/
1.準備工作
1.安裝nodejs
去官網(wǎng)下載nodejs安裝(推薦安裝4.x),安裝之后在命令行 node -v,如果成功說明node環(huán)境ok,不成功就去環(huán)境變量配置一下.
2.安裝hexo
使用命令 npm install hexo -g,執(zhí)行hexo -v 查看版本,本教程適合3.1.1以上版本
3.安裝git
去官網(wǎng)下載git安裝
4.配置git
配置ssh私鑰,上傳到github上
2.github-pages的說明
- github有兩種主頁,一種是github-page(個人主頁),一種是項目主頁,本教程針對個人主頁
- github-page需要將hexo博客發(fā)布到repository的master(主干)即可
- github的個人主頁要求repository的名稱和username一致，加入username是tom，則repository的名稱為tom.github.io
3.使用hexo寫博客
- 新建一個文件夾myblog,
- 右鍵git bash here使用git的shell
- 在shell中輸入hexo init,回車執(zhí)行
- 在shell中輸入hexo g ,回車
- 在shell中hexo s,回車
- 去瀏覽器訪問http://localhost:4000,訪問到主頁,然后在shell中ctrl c停止
- 在shell中hexo new "first-blog",回車
- 在shell中hexo g ,回車
- 在shell中hexo s ,回車,在訪問
- ok,在本地測試就沒問題了
4.發(fā)布到github
打開項目根部錄下的.config.yml,找到deploy,修改如下:
deploy:
- type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: branch
message: message
5.常用命令
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
hexo clean 刪除public文件夾
6.常見問題
發(fā)布不上去：
npm install hexo-deployer-git --save 安裝依賴包
7.具體設(shè)置
hexo有2種_config.yml文件，一個是根目錄下的全局的_config.yml坝疼，一個是各個theme下的骂铁；
- 修改主題
修改_config.yml中的theme: landscape改為theme: yilia译打，然后重新執(zhí)行hexo g來重新生成跳仿。
如果出現(xiàn)一些莫名其妙的問題，可以先執(zhí)行hexo clean來清理一下public的內(nèi)容竿音，然后再來重新生成和發(fā)布。
全局的_config.yml這里面都是一些全局配置拴驮，每個參數(shù)的意思都比較簡單明了谍失，所以就不作詳細介紹了。
需要特別注意的地方是莹汤，冒號后面必須有一個空格快鱼，否則可能會出問題。
