基于Hexo和Github搭建博客

搭建自己的個人博客。包括以下步驟:

準(zhǔn)備工作

確保電腦需要已下載安裝node和npm。查看安裝是否成功,windows只需在命令行輸入以下兩條命令即可。

$ node -v
$ npm -v

安裝hexo

安裝hexo

$ npm install -g hexo

檢測hexo版本來確保hexo是否成功安裝

$ hexo v
查看hexo版本

注:可能報錯,可以試試執(zhí)行

npm install hexo --no-optional

進(jìn)入本地工程目錄,初始化hexo

$ cd blog
$ hexo init

npm安裝package.json中的依賴包

$ npm install

生成博客文件

$ hexo g

啟動本地博客

$ hexo s
啟動本地博客

此時在瀏覽器輸入http://localhost:4000即可訪問默認(rèn)主題的hexo博客

查看博客首頁

查看hexo幫助

$ hexo help

修改全局配置文件

對本地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)站使用的語言
timezone 網(wǎng)站時區(qū)。Hexo 默認(rèn)使用您電腦的時區(qū)。時區(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 資源文件夾,這個文件夾用來存放內(nèi)容。 source
public_dir 公共文件夾,這個文件夾用于存放生成的站點文件。 public
tag_dir 標(biāo)簽文件夾 tags
archive_dir 歸檔文件夾 archives
category_dir 分類文件夾 categories
code_dir Include code 文件夾 `downloads/code
i18n_dir 國際化(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 啟動 Asset 文件夾 false
relative_link 把鏈接改為與根目錄的相對位址 false
future 顯示未來的文章 true
highlight 代碼塊的設(shè)置

分類 & 標(biāo)簽

參數(shù) 描述 默認(rèn)值
default_category 默認(rèn)分類 uncategorized
category_map 分類別名
tag_map 標(biāo)簽別名

日期 / 時間格式

Hexo 使用 Moment.js 來解析和顯示時間。

參數(shù) 描述 默認(rèn)值
date_format 日期格式 MMM D YYYY
time_format 時間格式 H:mm:ss

分頁

參數(shù) 描述 默認(rèn)值
per_page 每頁顯示的文章量 (0 = 關(guān)閉分頁功能) 10
pagination_dir 分頁目錄 page

擴展

參數(shù) 描述
theme 當(dāng)前主題名稱。值為false時禁用主題
deploy 部署部分的設(shè)置

配置github

新建倉庫

  1. 登錄github,點擊右上角加號,點擊new respository

![Uploading 5_489636.png . . .]


新建倉庫
  1. 在跳轉(zhuǎn)界面填寫信息
填寫信息

生成測試頁面

進(jìn)入新建的倉庫,點擊右上角的settings,在跳轉(zhuǎn)頁面點擊 launch automatic page generator,在跳轉(zhuǎn)頁面點擊continue to layouts,接著選擇主題,生成頁面,約15min后,訪問https://syd1992.github.io,即可顯示生成測試頁面

創(chuàng)建ssh keys

  1. 檢測ssh keys是否已存在,即id_rsa,id_resa.pub是否存在
$ ls -al ~/.ssh
  1. 生成ssh keys(若ssh keys不存在)
$ ssh-keygen -t rsa -C "847909475@qq.com" 

輸入命令后,會提示輸入ssh keys保存位置,一般無需改,直接回車即可;接著提示輸入密碼,并確認(rèn)再次輸入密碼,這個密碼后面會有使用,一定要記住!

  1. 查看生成的ssh keys中的公鑰
$ cat ~/.ssh/id_rsa.pub

給github倉庫添加ssh keys

  1. 點擊創(chuàng)建的倉庫右上側(cè)的settings,在跳轉(zhuǎn)頁面左下側(cè)點擊deploy keys
  1. 在跳轉(zhuǎn)頁面點擊add deploy keys,title隨意填,在key部分將創(chuàng)建ssh keys步驟中的id_rsa.pub內(nèi)容粘貼在該部分

測試連接

執(zhí)行命令,輸入命令后,問yes/no,輸入yes即可,提示輸入密碼,則輸入生成ssh keys時設(shè)置的密碼

$ ssh -T git@github.com

最后提示如下內(nèi)容,表示成功

Hi, 用戶名/用戶名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.

配置根目錄下的_config.yml文件并發(fā)布

  1. 安裝hexo-deployer-git
$ npm install hexo-deployer-git --save
  1. 修改_config.yml的deploy內(nèi)容,如下圖
  1. 生成博客文件,每次修改本地文件后,都要執(zhí)行該命令
$ hexo g
  1. 發(fā)布
$ hexo d

此時,訪問https://syd192.github.io.git即可看到自己的辛勤勞動成果咯??!

切換主題

默認(rèn)主題是landscape,如果不太喜歡,可以訪問這里獲取更多的主題。本人選擇主題是TKL,具體切換方法如下:

  1. 下載TKL主題
$ git clone https://github.com/SuperKieran/TKL.git theme/TKL
  1. 配置根目錄下的_config.yml文件

然后,hexo g,再hexo d,即可正常訪問。
注:圖片url填寫,圖片文件夾img應(yīng)放在source文件目錄下,url直接寫為/img/圖片.png即可。

寫一篇博客

  1. 新建博客
$ hexo new "newBlog"
  1. 在根目錄下source文件夾下找到對應(yīng)的newBlog.md文件,按照markdown規(guī)則,編寫博客。
    在該newBlog.md文件的頭部,可以對該博客進(jìn)行配置,如博客標(biāo)題title,博客創(chuàng)建時間date,所屬分類categories,標(biāo)簽tags
    然后,hexo g,再hexo d,即可正常訪問。

最后來張成果圖,繼續(xù)加油咯~~~~

參考鏈接

  1. 史上最詳細(xì)的Hexo博客搭建圖文教程
  2. 使用hexo搭建github.io博客(一)
  3. 基于 Hexo 和 GitHub Pages 搭建博客
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容