|
閱讀全文大概需要6分鐘 1. 前言 通常,一個(gè)技術(shù)點(diǎn)我們會(huì)使用,并不難,但是要做到讓別人也能聽(tīng)懂我們講得,還是需要一定的技巧和經(jīng)驗(yàn)的。因此很多搞技術(shù)的工程師都喜歡寫(xiě)博客,一方面是給自己做筆記,另一方面也是在提升自己的寫(xiě)作、總結(jié)能力。類似于CSDN、博客園也都可以寫(xiě)文章,但這些都是依賴在別人提供好的網(wǎng)站或博客模板上來(lái)寫(xiě),能定制屬性較少,今天給大家推薦一種搭建個(gè)人技術(shù)博客的方法:基于hexo+github實(shí)現(xiàn),通過(guò)它能快速搭建出一套屬于個(gè)人且具有極高定制化特性的技術(shù)博客,下面介紹詳細(xì)的搭建過(guò)程。 2. 開(kāi)始前準(zhǔn)備工作 在開(kāi)始之前,需要做一些準(zhǔn)備工作:
3. 新建GitHub倉(cāng)庫(kù) 新建一個(gè)名為你的用戶名.的倉(cāng)庫(kù),比如說(shuō),如果你的github用戶名是test,那么你就新建test.的倉(cāng)庫(kù)(必須是你的用戶名,其它名稱無(wú)效),將來(lái)你的網(wǎng)站訪問(wèn)地址就是 http://test. 了,是不是很方便? 需要注意的是,倉(cāng)庫(kù)名字必須是:username.,其中username是你的用戶名,且每一個(gè)github賬戶最多只能創(chuàng)建一個(gè)這樣可以直接使用域名訪問(wèn)的倉(cāng)庫(kù)。 4. 配置SSH Key 為什么要配置這個(gè)呢?因?yàn)槟闾峤淮a肯定要擁有你的github權(quán)限才可以,但是直接使用用戶名和密碼太不安全了,所以我們使用ssh key來(lái)解決本地和服務(wù)器的連接問(wèn)題。 如果提示:No such file or directory 說(shuō)明你是第一次使用git。 最終會(huì)生成一個(gè)文件在用戶目錄下,打開(kāi)用戶目錄,找到.ssh\id_rsa.pub文件,打開(kāi)并復(fù)制里面的內(nèi)容,打開(kāi)你的GitHub主頁(yè),進(jìn)入個(gè)人設(shè)置 -> SSH and GPG keys -> New SSH key。 4.1. 測(cè)試是否成功 如果提示Are you sure you want to continue connecting (yes/no)?,輸入yes,然后會(huì)看到:Hi zhoujinjian! You've successfully authenticated, but GitHub does not provide shell access. 看到這個(gè)信息說(shuō)明SSH已配置成功! 此時(shí)你還需要配置:
5. 安裝、使用hexo 5.1. hexo簡(jiǎn)介 Hexo是一個(gè)簡(jiǎn)單、快速、強(qiáng)大的基于 Github Pages 的博客發(fā)布工具,支持Markdown格式,有眾多優(yōu)秀插件和主題,官網(wǎng):http://。 5.2. hexo原理 由于github pages存放的都是靜態(tài)文件,博客存放的不只是文章內(nèi)容,還有文章列表、分類、標(biāo)簽、翻頁(yè)等動(dòng)態(tài)內(nèi)容,假如每次寫(xiě)完一篇文章都要手動(dòng)更新博文目錄和相關(guān)鏈接信息,相信誰(shuí)都會(huì)瘋掉,所以hexo所做的就是將這些md文件都放在本地,每次寫(xiě)完文章后調(diào)用寫(xiě)好的命令來(lái)批量完成相關(guān)頁(yè)面的生成,然后再將有改動(dòng)的頁(yè)面提交到github。 5.3. hexo安裝 Node和Git都安裝好后,可執(zhí)行如下命令安裝hexo: 5.4. hexo目錄初始化 創(chuàng)建一個(gè)文件夾,如:Blog,cd到Blog里執(zhí)行hexo init的,命令: 好啦,至此,全部安裝工作已經(jīng)完成! 5.5. hexo生成靜態(tài)頁(yè)面 繼續(xù)再Blog目錄下執(zhí)行如下命令,生成靜態(tài)頁(yè)面 5.6 本地啟動(dòng) 啟動(dòng)本地服務(wù),進(jìn)行文章預(yù)覽調(diào)試,命令: 開(kāi)啟本地預(yù)覽服務(wù),打開(kāi)瀏覽器訪問(wèn) http://localhost:4000 即可看到博客內(nèi)容。 6. 使用hexo寫(xiě)博客 6.1 hexo與GitHub倉(cāng)庫(kù)關(guān)聯(lián)配置 建立與你用戶名對(duì)應(yīng)的倉(cāng)庫(kù),倉(cāng)庫(kù)名必須為【your_user_name.】,固定寫(xiě)法 然后建立關(guān)聯(lián),例如我的Blog在本地/Users/mikezhou/Blog,Blog是我之前建的東西也全在這里面,有:
現(xiàn)在我們需要_config.yml文件,來(lái)建立關(guān)聯(lián),命令: 翻到最下面,改成我這樣子的,注意:: 后面要有空格
6.2 hexo寫(xiě)博客 hext與github關(guān)聯(lián)配置好之后,定位到hexo博客的根目錄,執(zhí)行命令: hexo會(huì)幫我們?cè)赺posts下生成相關(guān)md文件,我們只需要打開(kāi)這個(gè)文件按markdown語(yǔ)法就可以開(kāi)始寫(xiě)博客了。當(dāng)然你也可以直接自己新建md文件,用這個(gè)命令的好處是幫我們自動(dòng)生成了時(shí)間。 一般md博客文章,完整格式如下:
文章寫(xiě)好之后,執(zhí)行如下命令才能使用git部署: 執(zhí)行下述命令進(jìn)行上傳并部署代碼到GitHub: 代碼上傳好之后,在瀏覽器中輸入https://zhoujinjian./就行了,我的 github 的賬戶叫 zhoujinjian ,把這個(gè)改成你 github 的賬戶名就行了。 可根據(jù)個(gè)人需求,進(jìn)行一些定制化配置(如主題、樣式配置、增加閱讀統(tǒng)計(jì)功能等),最終本文示例效果如下所示:
詳細(xì)示例效果可訪問(wèn):https://zhoujinjian. 7. hexo補(bǔ)充知識(shí) 每次部署的步驟,可按以下三步來(lái)進(jìn)行:
一些常用命令:
一些常用路徑:
我們正常使用,修改最多的是_config.yml文件,不管是博客的基礎(chǔ)配置,還是模板,都是修改這個(gè)文件。 |
|
|
來(lái)自: 測(cè)試開(kāi)發(fā)技術(shù) > 《待分類》