Hexo和GitHub搭建个人博客

简介

Hexo是一款静态博客框架。基于Node.js,超快速度;支持 Markdown语法;可一键部署到 GitHub Pages, Heroku 或其他网站;拥有强大丰富的插件系统。官网链接:Hexo
Mac用户参考:传送门

安装前提

  • Git。Hexo基于Git封装命令,用于把本地的Hexo文件提交到GitHub Pages。
  • Node.js。Hexo调用Node来生成静态页面。自定义环境配置可参考:Node.js环境变量配置
  • GitHub。作为做博客的远程仓库、域名和服务器。

安装Hexo

官方Docs
首先创建一个文件夹,如blog,用户存放Hexo的配置文件,然后进入blog里安装Hexo。打开Dos窗口执行下面命令

  1. npm install -g hexo-cli:安装Hexo。如果没有对Node.js进行自定义环境变量配置,会默认安装在C:\Users\用户名\AppData\Roaming\npm目录下
  2. hexo init <folder>:生成初始化文件。Hexo 将会在指定文件夹中新建所需要的文件,不指定<folder>会在当前目录执行。
    新建完成后,blog目录会产生文件,结构如下:
.
├── _config.yml  (配置文件)
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts  (文章放置处)
└── themes  (主题放置处)
  1. hexo generatehexo g:Hexo读取初始化配置文件_config.yml,在blog根目录下建立一个public文件夹生成静态博客内容。
  2. hexo server:启动本地Hexo服务。然后浏览器输入http://localhost:4000即可看到默认主题Demo。
homePage

如果你不能看到这个页面,说明环境还没配置好,不用紧张。

配置GitHub

  1. 建立Repository。建立与你用户名对应的仓库,仓库名必须为【username.github.io】,固定写法。
  2. 打开_config.yml文件,到最下面修改deploy属性,把用户名换成你个人的username。
deploy:
  type: git
  repo: https://github.com/username/username.github.io.git
  branch: master

3.0版本后都是这样配置,我的Hexo版本是3.3.8,hexo -vsersion可查看。

  1. npm install hexo-deployer-git --save:安装连接Hexo和Git的管道插件
  2. hexo deploy:把本地public目录里文件部署到远程GitHub对应的仓库里。如果你没有使用SSH keys,在部署过程会弹出可视化窗口输入账号密码。浏览器中输入仓库名称https://username.github.io/,可看到默认主题Demo。

主题推荐

我个人使用next主题,配置性很强,next主题说明文档

主题下载配置

使用Git下载到本地,先确认当前目录是blog根目录,执行git clone https://github.com/iissnan/hexo-theme-next themes/next,后面两个参数分别是主题GitHub地址和本地themes目录放置的文件夹。

对比_config.yml配置文件中元素theme: landscape与themes目录中landscape文件夹名相同,下载主题后会生成对应的文件夹,我的是next。

把_config.yml配置文件中元素修改为theme: next即可。

每次更换主题部署时,分别执行三个命令:

hexo clean  # 清理public文件夹
hexo generate  #生成静态文件
hexo deploy  #本地部署到远程服务器

再次打开地址发现主题风格变化了。最后执行hexo new <title>创建一篇新文章,打开source/_posts/title.md文件,通过MarkDown格式语法开心的编辑文章吧。
如果你有什么问题,可以评论或私信我,欢迎叨扰。

参考链接http://leopardpan.github.io

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,686评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,668评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,160评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,736评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,847评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,043评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,129评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,872评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,318评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,645评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,777评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,470评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,126评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,861评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,095评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,589评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,687评论 2 351

推荐阅读更多精彩内容