最近代碼君興趣來潮腾窝,想搭建一個自己的博客,說干就干居砖,搭建過程遇到不少坑特此記錄下來虹脯,希望對后來要搭建自己博客的讀者有用~
搭建準(zhǔn)備
- 下載Node.js
以為Hexo是基于Node.js的所以需要按照這個,選擇自己電腦對應(yīng)的版本就好奏候,這個很簡單循集,一路安裝就可以,這就沒什么說的啦蔗草。
- 安裝Hexo
$ npm install -g hexo-cli
如果報無權(quán)限的錯誤咒彤,用一下命令
$ sudo npm install -g hexo-cli 再輸入密碼就行
打開命令行,輸入上面命令咒精,就開始安裝啦,就這么簡單,可以輸入$ npm -v來測試是不是安裝成功蔼紧,輸出版本號,就證明已經(jīng)安裝成功啦狠轻,如下圖
博客搭建
一奸例、本地博客搭建
- 建立一個文件夾,用于放Hexo的項(xiàng)目,為了方便我在桌面建立了一個名為Blog的文件夾,執(zhí)行下面代碼 hexo init 文件路徑查吊,不知道怎么寫路徑谐区,可以在輸入完hexo init 后拖拽要放的文件夾到命令行,終端會自己寫入路徑的
$ hexo init /Users/apple/Desktop/Blog
- cd 到Blog文件夾逻卖,執(zhí)行如下命令宋列,安裝npm:
$ cd /Users/apple/Desktop/Blog
$ npm install
- 安裝完成后繼續(xù)執(zhí)行如下命令,開啟服務(wù)器
$ hexo s
此時评也,打開瀏覽器輸入網(wǎng)址http://localhost:4000,就會有驚喜炼杖,surprise~
二、Github搭建
- 用Github那就必須有Github賬號盗迟,沒有的自行注冊
- 新建一個倉庫坤邪,倉庫命名最好是你的Github用戶名.github.io
- 創(chuàng)建完成后,什么東西都沒有罚缕,給自己加一個主題Theme艇纺,在項(xiàng)目中找到Setting->GitHub Pages-> Choose a Theme,選擇完成后,輸入你剛才定義的庫名稱邮弹,就是以github.io結(jié)尾的黔衡,我的是https://jiangzepeng.github.io/,這個就是你自己的網(wǎng)上博客啦
三、搭建網(wǎng)上博客
剛才我們是隨便選了一個簡單的主題腌乡,那怎么把我們本地的博客放到這個網(wǎng)址上吶盟劫,接著往下看
-
找到剛才我們建立的Blog文件夾,找到_config.yml文件与纽,打開侣签,找到deploy配置,修改如下面的配置渣锦,這你你要把repository里的地址換成你的,其實(shí)就是換一下用戶名氢哮,配置好后記得保存
deploy:
type: git
repository: https://github.com/jiangzepeng/jiangzepeng.github.io.git
branch: master
- cd 到Blog文件路徑下袋毙,執(zhí)行生成靜態(tài)頁面的命令
$ cd /Users/apple/Desktop/Blog
$ hexo generate 或者h(yuǎn)exo g
- 在執(zhí)行上傳github命令
$ hexo deploy 或者:hexo d
如果一直提示:ERROR Deployer not found: git,無法連接git或找不到git冗尤,那說明你沒安裝hexo-deployer-git依賴包听盖,執(zhí)行下面命令行進(jìn)行安裝
$ npm install hexo-deployer-git --save
安裝完再次執(zhí)行hexo deploy命令就不會出現(xiàn)上面的問題了
- 若你未關(guān)聯(lián)Github,則執(zhí)行hexo deploy命令時終端會提示你輸入Github的用戶名和密碼裂七,即
Username for 'https://github.com':
Password for 'https://github.com':
- 如果hexo deploy 執(zhí)行成功皆看,你再次輸入以github.io結(jié)尾的個人博客就會出現(xiàn)你本地的那個酷炫界面啦
擴(kuò)展
一、 如何寫一篇博客
- 寫博客主要是用Markdown背零,首先還是cd到Blog路徑腰吟,執(zhí)行一下命令
$ cd /Users/apple/Desktop/Blog
$ hexo new "myblog"
- 執(zhí)行成功后,會生成一個myblog.md的文件,文件路徑在Blog/source/_post里面毛雇,當(dāng)然你下次也可以直接在_post里面直接生成.md文件
二嫉称、 添加ssh key到Github
- 如果閑每次上傳文章輸入github密碼太麻煩的話,可以添加ssh key到github上灵疮,執(zhí)行如下命令织阅,檢查SSH keys是否存在。如果有文件id_rsa.pub或id_dsa.pub震捣,則直接進(jìn)入步驟1.3將SSH key添加到Github中荔棉,否則進(jìn)入下一步生成SSH key。
$ ls -al ~/.ssh
- 生成新的ssh key
執(zhí)行如下命令生成public/private rsa key pair蒿赢,注意將your_email@example.com換成你自己注冊Github的郵箱地址润樱。
$ ssh-keygen -t rsa -C "your_email@example.com"
默認(rèn)會在相應(yīng)路徑下(~/.ssh/id_rsa.pub)生成id_rsa和id_rsa.pub兩個文件。
- 將ssh key添加到Github中
Find前往文件夾~/.ssh/id_rsa.pub打開id_rsa.pub文件诉植,里面的信息即為SSH key祥国,將這些信息復(fù)制到Github的Add Deploy key頁面即可。
進(jìn)入Github --> Settings --> Deploy keys --> add deploy key:
Title里任意添一個標(biāo)題晾腔,將復(fù)制的內(nèi)容粘貼到Key里舌稀,點(diǎn)擊下方Add key綠色按鈕即可。
三灼擂、 新增欄目 比如個人簡歷
路徑:根目錄-》themes-》landscape-plus-master-》_config.yml
在菜單欄里面新增需要的欄目