github部署hexo备忘

hexo官网:https://hexo.io/zh-cn/

必要配置

GitHub Pages

Git

Hexo

1
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
1
2
3
$ brew update
$ brew install node
$ node -v
1
2
$ sudo npm install npm -g
$ npm -v
1
$ npm install -g hexo-cli

搭建方法

1
$ hexo init blog
1
$ cd blog
1
$ npm install
1
$ hexo generate
1
$ hexo server

https://github.com/pinggod/hexo-theme-apollo

部署

  • _config.yml:
1
2
3
4
deploy:
type: git
repo: 对应仓库的SSH地址(可以在GitHub对应的仓库中复制)
branch: 分支(User Pages为master,Project Pages为gh-pages)
  • 安装插件,使Hexo部署到GitHub:
1
$ npm install hexo-deployer-git --save
  • 执行部署:
1
2
$ hexo generate
$ hexo deploy
  • 访问:username.github.io

hexo常用命令

1
2
3
npm install hexo -g #安装
npm update hexo -g #升级
hexo init #初始化

简写

hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo p == hexo publish
hexo g == hexo generate #生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy #部署

服务器

hexo server #Hexo 会监视文件变动并自动更新,您无须重启服务器。
hexo server -s #静态模式
hexo server -p 5000 #更改端口
hexo server -i 192.168.1.1 #自定义 IP

hexo clean #清除缓存 网页正常情况下可以忽略此条命令
hexo g #生成静态网页
hexo d #开始部署

监视文件变动

hexo generate #使用 Hexo 生成静态文件快速而且简单
hexo generate --watch #监视文件变动

完成后部署

1
2
3
两个命令的作用是相同的
hexo generate --deploy
hexo deploy --generate

hexo deploy -g
hexo server -g

草稿

hexo publish [layout] <title>

模版

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,’ctrl + c’关闭server)
hexo deploy #将.deploy目录部署到GitHub

hexo new [layout] <title>
hexo new photo "My Gallery"
hexo new "Hello World" --lang tw

变量 描述
layout 布局
title 标题
date 文件建立日期
1
2
3
4
5
6
7
8
title: 使用Hexo搭建个人博客
layout: post
date: 2014-03-03 19:07:43
comments: true
categories: Blog
tags: [Hexo]
keywords: Hexo, Blog
description: 生命在于折腾,又把博客折腾到Hexo了。给Hexo点赞。

模版(Scaffold)

hexo new photo "My Gallery"

变量 描述
layout 布局
title 标题
date 文件建立日期

设置文章摘要

以上是文章摘要 <!--more--> 以下是余下全文

写作

hexo new page <title>

hexo new post <title>

变量 描述
:title 布局
:year 建立的年份(4 位数)
:month 建立的月份(2 位数)
:i_month 建立的月份(去掉开头的零)
:day 建立的日期(2 位数)
:i_day 建立的日期(去掉开头的零)

推送到服务器上

hexo n #写文章
hexo g #生成
hexo d #部署 #可与hexo g合并为 hexo d -g

报错

找不到git部署

ERROR Deployer not found: git

解决方法

npm install hexo-deployer-git --save

部署类型设置git

hexo 3.0 部署类型不再是 github/_config.yml 中修改

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repository: git@***.github.com:***/***.github.io.git
branch: master

xcodebuild

xcode-select: error: tool ‘xcodebuild’ requires Xcode, but active developer directory ‘/Library/Developer/CommandLineTools’ is a command line tools instance

npm install bcrypt

RSS不显示

安装RSS插件

npm install hexo-generator-feed --save

开启RSS功能

编辑hexo/_config.yml,添加如下代码:

1
rss: /atom.xml #rss地址 默认即可

域名

待填充