hexo+github搭建個(gè)人博客
前言：
有那么多的博客平臺(tái)狮荔，為什么要搭建個(gè)人博客？
- 基于共享平臺(tái)的策略會(huì)審核發(fā)布內(nèi)容并可能隨時(shí)被刪
- 你是否想搭建專屬的個(gè)性化博客傍药，定義自己的精美頁(yè)面
- 作為一個(gè)編程從業(yè)者炭剪，有一個(gè)專門(mén)記錄自己成長(zhǎng)的博客可以作為求職的一個(gè)技能棧介紹
本系列教程將搭建一個(gè)這樣的博客Hackt0's Blog預(yù)覽(博客還在完善中)
原文鏈接
準(zhǔn)備工作
- github賬號(hào)
- node.js 、git
本文環(huán)境
- Window11/Windows10 x64
- node.js v16.11.1(使用最新版本運(yùn)行hexo server 是會(huì)出現(xiàn)告警携丁，但是不影響使用，如果介意兰怠，可以使用低版本)
- Git v2.33.1
- hexo v5.4.0
準(zhǔn)備工作
創(chuàng)建github倉(cāng)庫(kù)
首先在gitHub官網(wǎng)注冊(cè)一個(gè)賬號(hào)(注冊(cè)的用戶名會(huì)和之后的博客域名相關(guān)梦鉴，可以直接想好，避免二次修改)揭保，由于github在外網(wǎng)肥橙，可能出現(xiàn)無(wú)法訪問(wèn)的情況，可以參考解決github訪問(wèn)失敗 - 簡(jiǎn)書(shū) (jianshu.com)
注冊(cè)完成后會(huì)收到一份郵件秸侣，要點(diǎn)擊完成下注冊(cè)驗(yàn)證
以新建賬號(hào)為例做介紹存筏，創(chuàng)建一個(gè)倉(cāng)庫(kù)
create repository.pngRepository name一欄填上
用戶名.github.io，如上圖用戶名為shuhan520味榛，那么對(duì)應(yīng)的Repository name就是shuhan520.github.io椭坚，再勾選一下Add a README file選項(xiàng)用于快速生成項(xiàng)目頁(yè)面，其余選項(xiàng)全部默認(rèn)即可創(chuàng)建后可以在Settings-Pages看到自己的專屬域名了（
不推薦使用projectpage搏色，如果使用其他名稱生成的域名會(huì)帶有路徑善茎，搭建博客時(shí)會(huì)出現(xiàn)路徑導(dǎo)致的資源訪問(wèn)問(wèn)題），此時(shí)訪問(wèn)網(wǎng)頁(yè)是剛剛創(chuàng)建的README文檔內(nèi)容频轿，沒(méi)有勾選Add a README file選項(xiàng)的需要添加內(nèi)容才可以生成GithubPages.png上圖Custom domain可以綁定其他域名
配置SSH Key
可以使用Git官網(wǎng)下載和安裝git垂涯，安裝完成后鼠標(biāo)右鍵空白處菜單欄會(huì)出現(xiàn)
git bash here選項(xiàng)，設(shè)置個(gè)人郵箱和用戶名$ git config --global user.name "你的GitHub用戶名" $ git config --global user.email "你的GitHub注冊(cè)郵箱"生成ssh-key文件
$ ssh-keygen -t rsa -C "你的GitHub注冊(cè)郵箱"生成過(guò)程中需要設(shè)置生成路徑航邢、密碼耕赘，默認(rèn)空白即可；注意使用默認(rèn)路徑時(shí)是否存在提示already exists膳殷，如果有可以輸入'n'退出操骡，重設(shè)路徑或者使用現(xiàn)有ssh-key(郵箱相同時(shí))
找到生成的.ssh的文件夾中的id_rsa.pub，記事本打開(kāi)復(fù)制全部?jī)?nèi)容即可
可以在SSH and GPG keys (github.com)點(diǎn)擊New SSH Key，title為任意內(nèi)容当娱，key輸入剛剛復(fù)制的key文件內(nèi)容吃既，點(diǎn)擊Add SSH Key即可
任意位置打開(kāi)cmd命令行窗口輸入
$ ssh git@github.com看到以下內(nèi)容即可(初次訪問(wèn)可能需要添加GitHub域名到可信域名考榨，確認(rèn)連接時(shí)輸入yes即可)
PTY allocation request failed on channel 0
Hi shuhan520! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.
安裝node.js
可以使用node.js官網(wǎng)下載和安裝node.js跨细，打開(kāi)控制臺(tái)輸入以下命令可正常輸出版本號(hào)即安裝完成
$ node -v $ npm -v
至此所有的準(zhǔn)備工作已經(jīng)完成
博客搭建
框架選取
快速構(gòu)建博客可以選擇hexo，hugo河质，wordpress等框架冀惭，本文使用的時(shí)hexo，因?yàn)殪o態(tài)頁(yè)面搭建相對(duì)簡(jiǎn)單掀鹅，檢索時(shí)發(fā)現(xiàn)hexo擁有很多美化主題和美化教程散休，同時(shí)自動(dòng)根據(jù)markdown文檔識(shí)別文章列表、分類乐尊、標(biāo)簽戚丸、翻頁(yè)等動(dòng)態(tài)內(nèi)容，相對(duì)于小白比較容易上手
hexo安裝
新建一個(gè)單獨(dú)的目錄用于搭建博客扔嵌，在新建目錄下打開(kāi)cmd命令行輸入以下命令
$ npm install -g hexo
安裝完成后輸入以下命令初始化
$ hexo init
hexo會(huì)自動(dòng)下載相關(guān)文件到本地限府，此時(shí)可以通過(guò)以下命令開(kāi)啟本地預(yù)覽
$ hexo g
$ hexo s
打開(kāi)瀏覽器訪問(wèn) http://localhost:4000即可看到未發(fā)布的頁(yè)面效果(本地訪問(wèn)可以使用瀏覽器隱私模式，避免因緩存而導(dǎo)致修改效果無(wú)法正常顯示)
如果提示端口占用可以使用以下命令更改端口
$ hexo server -p 5000 #更改端口到5000
推送到Github
安裝github插件
$ npm install hexo-deployer-git --save
修改hexo主目錄下的站點(diǎn)配置文件_config.yml痢缎，修改最下方deploy為如下內(nèi)容胁勺，yml以縮進(jìn)表示層級(jí)關(guān)系，所以務(wù)必要使用空格對(duì)齊
deploy:
type: git
repo: git@github.com:`your username`/`your username`.github.io.git
branch: main
推送到github倉(cāng)庫(kù)：
$ hexo d
如果推送時(shí)提示
nothing to commit, working tree clean
請(qǐng)清除本地緩存独旷，重新生成后推送：
$ hexo clean && hexo g
$ hexo d
至此署穗，可以使用github分配的個(gè)人域名訪問(wèn)到博客了
關(guān)于更多配置和美化由于簡(jiǎn)書(shū)平臺(tái)支持的md格式有限，可以訪問(wèn)hexo 個(gè)人博客美化 | Hackt0's Blog
