寫在前面
從搭建到佈置到GitHub花費時間大概用了五個小時,中間刪除repo N次,localhost運行正常,git上出現過404頁面、若干次README.md頁面,本文將簡略介紹搭建過程,主要內容是搭建過程當中出現的問題解決方法。
https://hexo.io/zh-cn/docs/ hexo官方文檔
https://c-axis.github.io/ 博客地址node
環境配置
安裝Git,註冊GitHub,並建立博客的repository
具體過程自行百度(注意點:repository的名稱必須是 Name.GitHub.io)
安裝Node https://nodejs.org/zh-cn/download/
下載了以後一直點就好了
安裝hexo
建立一個文件夾hexo,存放hexo的配置文件,右鍵Git Bush Here執行下面的代碼git
npm install hexo-cli -g npm install hexo --save hexo -v # 查看是否安裝成功
初始化倉庫github
$ hexo init yourname.github.io #建議和建立倉庫時使用同一個 這裏使用的不是GitHub上已經建好的那一個,而是在本地初始化的一個文件夾,若是已經建好的話,請刪除後在使用初始化命令 npm install npm -v #查看npm版本 hexo g # 使用默認主題本地測試下 hexo s
以後順利的畫就能夠在本地 http://localhost:4000 進行預覽了
此時文件夾的目錄以下:npm
. ├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes
具體內容不作介紹有問題諮詢度娘或者Google,這裏離上傳GitHub就不遠了。
修改這裏的_config.yml文件json
deploy: type: git repo: https://github.com/yourname/yourname.github.io.git branch: master
寫博客與發佈 瀏覽器
通過上述步驟,本地博客已經完成,那麼接下來就是寫博客了。緩存
你的博客文件須要存放到 xxx.github.io/source/_posts 文件夾中,在該文件夾下面你能夠按照你的博客分類創建一系列的文件夾來管理博客原文件。ruby
一、在本地運行測試
hexo s
二、安裝上傳Git功能:在瀏覽器中輸入 http://localhost:4000 訪問本地博客
npm install hexo-deployer-git --save
三、清理緩存併發布常見問題
hexo clean #清理緩存 多數頁面沒有更新的時候均可以用這個東西多刷新幾回 hexo g #生成頁面 hexo d #Git上傳
- Git上顯示爲404頁面,這裏大部分緣由應該Git的錯誤,等待或者從新建立repository(捂臉)。
- 本地查看博客正常可是yourname.git.io查看時爲空或者是README.md的樣式。從新查看_config.yml文件的delpoy下的設置,肯定無誤後進行
hexo clean
多刷新幾回,從新上傳,等幾分鐘再看。
寫在最後
官方文檔是個好東西,出現問題時最好先去看看官方有沒有列出,而後就在問人,個人大部分問題出在佈置好本地,上傳git的過程當中,有些BUG這裏沒有列出,以後再補吧。併發