搭建自己的個(gè)人博客释漆。包括以下步驟:
準(zhǔn)備工作
確保電腦需要已下載安裝node和npm握玛。查看安裝是否成功,windows只需在命令行輸入以下兩條命令即可畜挥。
$ node -v
$ npm -v
安裝hexo
安裝hexo
$ npm install -g hexo
檢測(cè)hexo版本來確保hexo是否成功安裝
$ hexo v
注:可能報(bào)錯(cuò)仔粥,可以試試執(zhí)行
npm install hexo --no-optional
進(jìn)入本地工程目錄,初始化hexo
$ cd blog
$ hexo init
npm安裝package.json中的依賴包
$ npm install
生成博客文件
$ hexo g
啟動(dòng)本地博客
$ hexo s
此時(shí)在瀏覽器輸入http://localhost:4000
即可訪問默認(rèn)主題的hexo博客
查看hexo幫助
$ hexo help
修改全局配置文件
對(duì)本地blog目錄下的_congig.yml
進(jìn)行修改配置即可蟹但。
網(wǎng)站
參數(shù) | 描述 |
---|---|
title |
網(wǎng)站標(biāo)題 |
subtitle |
網(wǎng)站副標(biāo)題 |
description |
網(wǎng)站描述 |
author |
您的名字 |
language |
網(wǎng)站使用的語(yǔ)言 |
timezone |
網(wǎng)站時(shí)區(qū)躯泰。Hexo 默認(rèn)使用您電腦的時(shí)區(qū)。時(shí)區(qū)列表华糖。比如說:America/New_York ,Japan , 和 UTC 麦向。 |
網(wǎng)址
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
url |
網(wǎng)址 | |
root |
網(wǎng)站根目錄 | |
permalink |
文章的 永久鏈接 格式 | :year/:month/:day/:title/ |
permalink_default |
永久鏈接中各部分的默認(rèn)值 |
目錄
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
source_dir |
資源文件夾,這個(gè)文件夾用來存放內(nèi)容客叉。 | source |
public_dir |
公共文件夾诵竭,這個(gè)文件夾用于存放生成的站點(diǎn)文件。 | public |
tag_dir |
標(biāo)簽文件夾 | tags |
archive_dir |
歸檔文件夾 | archives |
category_dir |
分類文件夾 | categories |
code_dir |
Include code 文件夾 | `downloads/code |
i18n_dir |
國(guó)際化(i18n)文件夾 | :lang |
skip_render |
跳過指定文件的渲染兼搏,您可使用 glob 表達(dá)式來匹配路徑卵慰。 |
文章
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
new_post_name |
新文章的文件名稱 | :title.md |
default_layout |
預(yù)設(shè)布局 | post |
auto_spacing |
在中文和英文之間加入空格 | false |
titlecase |
把標(biāo)題轉(zhuǎn)換為 title case | false |
external_link |
在新標(biāo)簽中打開鏈接 | true |
filename_case |
把文件名稱轉(zhuǎn)換為 (1) 小寫或 (2) 大寫 | 0 |
render_drafts |
顯示草稿 | false |
post_asset_folder |
啟動(dòng) Asset 文件夾 | false |
relative_link |
把鏈接改為與根目錄的相對(duì)位址 | false |
future |
顯示未來的文章 | true |
highlight |
代碼塊的設(shè)置 |
分類 & 標(biāo)簽
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
default_category |
默認(rèn)分類 | uncategorized |
category_map |
分類別名 | |
tag_map |
標(biāo)簽別名 |
日期 / 時(shí)間格式
Hexo 使用 Moment.js 來解析和顯示時(shí)間。
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
date_format |
日期格式 | MMM D YYYY |
time_format |
時(shí)間格式 | H:mm:ss |
分頁(yè)
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
per_page |
每頁(yè)顯示的文章量 (0 = 關(guān)閉分頁(yè)功能) | 10 |
pagination_dir |
分頁(yè)目錄 | page |
擴(kuò)展
參數(shù) | 描述 |
---|---|
theme |
當(dāng)前主題名稱佛呻。值為false 時(shí)禁用主題 |
deploy |
部署部分的設(shè)置 |
配置github
新建倉(cāng)庫(kù)
- 登錄github裳朋,點(diǎn)擊右上角加號(hào),點(diǎn)擊new respository
![Uploading 5_489636.png . . .]
- 在跳轉(zhuǎn)界面填寫信息
生成測(cè)試頁(yè)面
進(jìn)入新建的倉(cāng)庫(kù)吓著,點(diǎn)擊右上角的settings再扭,在跳轉(zhuǎn)頁(yè)面點(diǎn)擊 launch automatic page generator氧苍,在跳轉(zhuǎn)頁(yè)面點(diǎn)擊continue to layouts,接著選擇主題泛范,生成頁(yè)面让虐,約15min后,訪問https://syd1992.github.io
罢荡,即可顯示生成測(cè)試頁(yè)面
創(chuàng)建ssh keys
- 檢測(cè)ssh keys是否已存在赡突,即id_rsa,id_resa.pub是否存在
$ ls -al ~/.ssh
- 生成ssh keys(若ssh keys不存在)
$ ssh-keygen -t rsa -C "847909475@qq.com"
輸入命令后区赵,會(huì)提示輸入ssh keys保存位置惭缰,一般無需改,直接回車即可笼才;接著提示輸入密碼漱受,并確認(rèn)再次輸入密碼,這個(gè)密碼后面會(huì)有使用骡送,一定要記装合邸!
- 查看生成的ssh keys中的公鑰
$ cat ~/.ssh/id_rsa.pub
給github倉(cāng)庫(kù)添加ssh keys
- 點(diǎn)擊創(chuàng)建的倉(cāng)庫(kù)右上側(cè)的settings摔踱,在跳轉(zhuǎn)頁(yè)面左下側(cè)點(diǎn)擊deploy keys
- 在跳轉(zhuǎn)頁(yè)面點(diǎn)擊add deploy keys虐先,title隨意填,在key部分將創(chuàng)建ssh keys步驟中的id_rsa.pub內(nèi)容粘貼在該部分
測(cè)試連接
執(zhí)行命令派敷,輸入命令后蛹批,問yes/no,輸入yes即可篮愉,提示輸入密碼腐芍,則輸入生成ssh keys時(shí)設(shè)置的密碼
$ ssh -T git@github.com
最后提示如下內(nèi)容,表示成功
Hi, 用戶名/用戶名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.
配置根目錄下的_config.yml文件并發(fā)布
- 安裝hexo-deployer-git
$ npm install hexo-deployer-git --save
- 修改_config.yml的deploy內(nèi)容试躏,如下圖
- 生成博客文件猪勇,每次修改本地文件后,都要執(zhí)行該命令
$ hexo g
- 發(fā)布
$ hexo d
此時(shí)冗酿,訪問https://syd192.github.io.git
即可看到自己的辛勤勞動(dòng)成果咯2憾浴络断!
切換主題
默認(rèn)主題是landscape裁替,如果不太喜歡,可以訪問這里獲取更多的主題貌笨。本人選擇主題是TKL弱判,具體切換方法如下:
- 下載TKL主題
$ git clone https://github.com/SuperKieran/TKL.git theme/TKL
- 配置根目錄下的_config.yml文件
然后,hexo g
锥惋,再hexo d
昌腰,即可正常訪問开伏。
注:圖片url填寫,圖片文件夾img應(yīng)放在source文件目錄下遭商,url直接寫為/img/圖片.png即可固灵。
寫一篇博客
- 新建博客
$ hexo new "newBlog"
- 在根目錄下source文件夾下找到對(duì)應(yīng)的
newBlog.md
文件,按照markdown規(guī)則劫流,編寫博客巫玻。
在該newBlog.md
文件的頭部,可以對(duì)該博客進(jìn)行配置祠汇,如博客標(biāo)題title仍秤,博客創(chuàng)建時(shí)間date,所屬分類categories可很,標(biāo)簽tags
然后诗力,hexo g
,再hexo d
我抠,即可正常訪問苇本。
最后來張成果圖,繼續(xù)加油咯~~~~