windows下搭建hexo博客并將其部署到GitCafe終極教程

這兩天看了N多教程后,終于成功建立了個HEXO博客,并且將其托管到了GitCafe上。

下面是終極教程小白版(因為我就是小白--!)

小提示(我走的彎路):

1. 所有標點符號都是英文的,所以輸入時請切換到英文狀態。

2. 冒號后面一定要有個空格,否則回報錯。

3. 所有文件(不管是以md為后綴的,還是以yml結尾的),都必須轉換成UTF-8格式,可以在notepad++的格式里轉換下,否則在本地查看(localhost:4000)中會出現亂碼。

4. 注意tags: [test, 測試]如果使用多個標簽,注意逗號和測試之間還有個空格。

5. 最新版Hexo(3.0.0或以上版本)默認未安裝hexo-deployer-git插件,即部署(上傳)到gitcafe或github要用的插件,所以如果不執行這個命令,就要報錯。

6. Git Bash右鍵點擊左上角的圖標,選擇屬性,右側編輯選項中“快速編輯模式”打勾,這是為了在Git Bash中點擊右鍵就能粘貼。

7. 不建議用默認hexo主題,建議在網上找個其他主題,不僅因為好看,還因為其他主題往往集成了多說、支持中文簡體等優勢,省去了你自己折騰的時間。

開始


環境準備

1.安裝 node.js
??去 Node.js 下載最新版的 Node.js,安裝到C盤。
2.安裝Git
??Windous下下載msysgit,我安裝到D盤。
??
??反正以后重裝系統后,這兩個程序都要重新安裝。

安裝hexo博客

1.雙擊桌面圖標或者從開始菜單,所有程序,git,打開Git Bash


gitbash
gitbash

注意:這時右鍵點擊左上角的圖標,選擇屬性,右側編輯選項中“快速編輯模式”打勾,這是為了在Git Bash中點擊右鍵就能粘貼

該輸入代碼了:

$ npm install -g hexo

這條命令是安裝hexo,然后

#進入D盤
cd d:
# 創建文件夾hexo,為了存放你的博客各種內容及設置
mkdir hexo
# 進入hexo文件夾
cd  hexo

這時看到Git Bash標題欄的路徑為/D/hexo,如圖:


# 初始化文件hexo
hexo init
# 安裝依賴包
npm install 

注意:安裝hexo-deployer-git插件

npm install hexo-deployer-git --save

然后生成

#生成
hexo g
#啟動服務預覽
hexo s

代碼簡寫:
hexo g == hexo generate
hexo s == hexo server

當看到“INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.”時就說明我們已經搭建起本地的hexo博客了,然后到瀏覽器輸入localhost:4000看看(注意:不要打開提示的0.0.0.0:4000)。

enter description here
enter description here

然后按Ctrl+C停止服務(有時要按兩次Ctrl+C,因為有時Git Bash認為當前在進行復制操作),直到出現 “$”標志就結束了。
然后關閉Git Bash.

配置gitcafe


注意:以下假設你的gitcafe賬號或者用戶名是:hello,你的郵箱為:hello@gmail.com,密碼為hello123


https://gitcafe.com 注冊個賬號,然后創建項目,右上角的那個圖標可以新建項目,右側也有“新建”字樣。
反是選填的可以不填,其他默認。

注意:項目名需要與你的用戶名相同,還有就是要選擇“公開項目”。

gitcaf項目
gitcaf項目

這是別人的圖片,雖然用戶名不是hello,但注意要一樣,項目主頁可以不填。

配置SSH公鑰

首先我們需要檢查你電腦上現有的ssh key:

cd ~/.ssh

如果提示:No such file or directory 說明你是第一次使用git。

生成新的SSH Key:

ssh-keygen -t rsa -C "hello@gmail.com"

Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回車就好>

出現


sshkeygen
sshkeygen

然后系統會要你輸入密碼:

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

這個設置是防止別人往你的項目里提交內容,我直接回車。

看到入下圖所示后,SSH key就生成成功了。


sshkeyok
sshkeyok

然后你可以去開始,打開你的用戶目錄,有一個“.ssh”文件夾,里面有
“id_rsa” “id_rsa.pub” 和 “known_hosts”這三個文件。

ssh文件
ssh文件

其中“id_rsa”是你的私鑰文件,“id_rsa.pub”是你的公鑰文件,一會兒要用。
接下來下載notepad++ 文本編輯器,比windows自帶的記事本更強大,這里我們主要用它來打開id_rsa.pub文件。
這是他的官網:notepad++官網
下載后,直接把“id_rsa.pub”文件拖進notepad++中,然后復制里面的所有內容到剪貼板。

添加SSH Key到Gitcafe

然后去GitCafe,點擊右上角的那個圖標,選擇賬戶設置,左側SSH公鑰管理,添加新的公鑰,在名稱文本框中輸入任意字符,在公鑰文本框粘貼剛才復制的公鑰字符串全部內容(包括結尾的郵箱),輸入GitCafe賬戶密碼,按保存按鈕完成操作。

enter description here
enter description here

這樣我們本地就和GitCafe服務端連接上了。

測試是否可以連接GitCafe服務器

在桌面上雙擊打開Git Bash,輸入:

ssh -T git@gitcafe.com 

如果是第一次連接的話,會出現:

The authenticity of host 'gitcafe.com (50.116.2.223)' can't be established.
#RSA key fingerprint is 84:9e:c9:8e:7f:36:28:08:7e:13:bf:43:12:74:11:4e.
#Are you sure you want to continue connecting (yes/no)?

直接輸入yes回車,然后會提示你輸入 passphrase 口令:

Enter passphrase for key ‘/c/Users/USERNAME/.ssh/id_rsa’: 

剛才我們根本就沒設置,所以這次也直接回車,當看到

Hi starsky! You've successfully authenticated, but GitCafe does not provide shell access.

我們就連接成功了。


enter description here
enter description here

設置用戶信息

# 設置你的用戶名
git config --global user.name "hello"  
# 設置你的郵箱
git config --global user.email "hello@gmail.com"

到此為止,SSH Key配置成功,本機已成功連接到gitcafe.
就差最后一步了,把博客部署到gitcafe.

修改hexo配置文件

在 Hexo 文件夾下找到 _config.yml 文件,并拖到notepad++ 打開。


enter description here
enter description here

找到其中的 deploy 標簽,改成下圖所示,并保存:

deploy:
  type: git
  repository: https://gitcafe.com/hello/hello.git 
  branch: gitcafe-pages

注意:除了 “https://” 中的冒號以外,其他每個冒號后面都有個空格,最后保存。

把hexo博客部署到gitcafe

注意:以下假設你注冊gitcafe時使用的密碼是hello123

打開我的電腦,進入D盤的hexo目錄,在該目錄內右鍵,選擇Git Bash,打開后看到Git Bash標題欄的路徑為/D/hexo.

注意:以后我們很多的博客操作都要在此目錄下運行Git Bash才行,比如新建博文、上傳部署等等。

輸入:

hexo d

運行中要輸入你的用戶名:輸入hello,回車,然后要輸入密碼,輸入hello123(這時當你輸入時,你會發現輸入之后密碼是不顯示的,也不顯示星號,這是為了安全,并非是你沒輸上),回車后顯示Deploy done等等就成功部署上了!如圖:

enter description here
enter description here

每次deploy時不輸入郵箱和密碼

如果覺得每次部署的時候都要輸入用戶名和密碼,可以這樣解決:開始,到你的用戶目錄下新建一個_netrc文件。
我的操作:可以直接復制一個.gitconfig文件復件,然后改名為_netrc注意:n前面有個下劃線。
然后把_netrc文件拖入notepad++ 里,輸入:

machine gitcafe.com
login hello
password hello123

,這樣每次部署的時候就不用輸入用戶名和密碼了。
來源:
把Hexo同時部署到GitHub和GitCafe
Git push時重復輸入用戶名密碼的問題

大功告成 :)

這時你就成功把hexo博客部署到了gitcafe上,快打開 http://hello.gitcafe.io/ 看看吧!

歡迎訪問我的博客:http://starsky.gitcafe.io/

其他問題

問題集1:

  1. 有網友反應右鍵菜單中沒有git bash選項,可以進入開始菜單找到git bash,然后通過cd進入相應目錄執行命令。
  1. 在github部署完成之后,馬上訪問可能出現404錯誤,這是正常的,(最多)等待十分鐘左右就可以訪問了。如果還不行,那很可能是 github 發送給你的驗證郵件你沒有打開看,據多方反映,驗證后就沒問題了。
  2. 如果在hexo d之后出現fatal: 'username.github.io' does not appear to be a git repository,一是檢查 repo 的名字是否合乎規范、是否含有大寫字母、config.yml 中的 deploy 配置是否正確,二是把 git bash 關掉,重新打開再執行命令。
  3. 有的同學可能不是 IT 界的,或者對shell 命令不太了解。在要求輸入密碼時,你輸入之后密碼是不顯示的,這是為了安全,并非是你沒輸上。
  4. 出現亂碼的,不要使用 windows 中的「記事本」打開并編輯文件,推薦使用 sublime text,很簡單。如果已經在「記事本」中編輯過,需要使用 sublime text 轉碼為「utf8」。
  5. 安裝 hexo 時卡在那兒不動,很可能是網絡不給力,能全局 break wall 就好了。
  6. 遇到什么其他的問題,不妨刪除.deploy 和db.json 再重新生成試一試。

來源:hexo系列教程:(二)搭建hexo博客

問題集2:

1.安裝NoteJs,出現問題,安裝到最后提示error 52**
過程:重新下載安裝了幾次都不行,不懂為什么,最后通過Hexo的文檔提供下載地址進行下載,然后安裝問題就沒有出現了。 可能原因:
a.下載的安裝包有問題的原因
b.我的C盤占用過多,盤符標紅,然后卸載一些不常用軟件解決,再安裝再加上上面重新下載的安裝包,之后安裝成功。

2.部署提示找不到git
解決辦法: 在Hexo 3.0版本后deploy git 被分開的,所以需要安裝,安裝命令如下:npm install hexo-deployer-git --save ,安裝好后在嘗試一下就ok。

3.部署提示 `event type error ***`
解決辦法:
安裝了git bash沒有配置到環境變量path中,添加進去在試試。

4.部署的時候執行:hexo deploy 命令行沒有任何輸出,也沒有錯誤。
解決辦法:
在部署的_config.yml文件中,找到deploy:標簽,在每個冒號后面必須要空格,否則就會出現上述問題。我的配置如下:
deploy:
type: git
repository: https://github.com/wx962464/wx962464.github.io.git
branch: master
順便提示下,如果使用ssh部署不成功的話,請使用https的方式試試,這個就是每次會讓你輸入用戶名和密碼。其實效果是一樣的。

5.修改主題不起作用,而且hexo generate還報錯
解決辦法:
需要到相應的主題文件夾下面進行修改,比如我的主題為:themes\jacman 則在根目錄下找到該文件夾下,修改_config.yml文件,根目錄下面也有個同樣的名字,不注意,容易弄混,要主要修改的文件是否正確。

6.執行hexo server顯示running at http://0.0.0.0:4000/
問題說明:
開始的時候以為啟動服務器有問題,一直在找問題,找了半天沒有答案,最后在瀏覽器直接嘗試http://0.0.0.0:4000/ 是沒辦法訪問的,然后就試了下http://localhost:4000/ 發現是可以訪問的,大喜!~~

7.執行hexo server提示找不到該指令
解決辦法:
在Hexo 3.0 后server被單獨出來了,需要安裝server,安裝的命令如下:npm install hexo-server --save 安裝此server后再試,問題解決。

8.以上就是我在這幾天使用Hexo的一些問題,當然問題列的不夠詳細,只是一個大致思路,這些也是憑著自己的印象做的筆記,所以有些錯誤的地方希望大家指出,共同學習,共同進步!

來源:Hexo 使用中遇到的問題總結


參考:

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容