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