Hexo是一个快速、简洁且高效的博客框架
准备工作
在本地使用hexo框架,需要电脑中已安装Git、Node.js
安装Git
- Windows:下载并安装 Git
- Mac:使用 Homebrew :
brew install git --with-gettext
- Linux (Ubuntu, Debian):
sudo apt-get install git-core
- Linux (Fedora, Red Hat, CentOS):
sudo yum install git-core
安装Node.js
Node.js 有多个版本,建议使用nvm (Node Version Manager)来管理node的版本。对于windows小伙伴来说,建议使用Node.js安装程序进行安装,喜欢折腾的小伙伴可以试试nvm-windows
安装Node.js
nvm install stable
# nvm 使用镜像安装
NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node nvm install stable
# windows小伙伴如果使用 nvm-windows,设置镜像
nvm node_mirror https://npm.taobao.org/mirrors/node/
安装Hexo
npm install -g hexo-cli
国内小伙伴建议使用淘宝 NPM 镜像
# 安装cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org
# 使用cnpm安装hexo
cnpm install -g hexo-cli
# windows小伙伴如果使用 nvm-windows,设置npm镜像
nvm npm_mirror https://npm.taobao.org/mirrors/npm/
使用hexo
初始化
# --no-install 是使用初始化后跳过npm install
hexo init 项目文件夹 --no-install
# 进入项目目录
cd 项目文件夹
# 安装依赖
cnpm install
查看hexo init
更多帮助
hexo init -h
本地启动
# s 是 server
hexo s
然后会输出以下信息
INFO Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
然后在可以本地浏览器打开http://localhost:4000,就可以访问启动好的博客啦
查看hexo server
更多帮助,也可参考Hexo 服务器
hexo s -h
安装Next主题
我使用的Next主题
cd 项目文件夹
git clone https://github.com/theme-next/hexo-theme-next themes/next
将项目目录
下的_config.yml
配置文件中的theme: landscape
改为theme: next
, 然后重启Hexo本地服务,即可在本地看到新的主题样式
如果想改为其他主题,请前往Hexo Themes,自行选取后,按照说明文档要求自行修改配置
配置
Hexo大部份的的配置在项目目录
下的_config.yml
中,根据Hexo官方文档按照自己需要改动即可
自己想个性化配置,例如在文章底部增加版权信息,网站底部字数统计等更多,可以参考Hexo的Next主题个性化配置教程,当然这个参考大部分都是next 5.x
版本,新的版本还是建议参考theme-next中的配置
写文章
创建一个新的文章
hexo new 文章名
更多说明,参考Hexo 写作
部署
安装hexo-deployer-git
cnpm install hexo-deployer-git --save
创建仓库
下面要用到git仓库,创建github.io仓库
- 点击
New repository
- 输入
Repository name
,必需为用户名.github.io
格式 - 点击按钮
Create repository
- 进入仓库
用户名.github.io
,点击Settings
,找到GitHub Pages
模块 - 点击
Choose a theme
选择一个页面主题 - 然后这个静态资源存放的远程仓库地址就创建了
指定仓库位置
下面将生成好的静态资源推到远程仓库,先修改博客项目目录下的_config.yml
deploy:
type: git
repo: 生成好的静态资源存放的远程仓库地址
branch: [分支名称]
部署
先生成文件后,再将静态资源提交到远程仓库
# d 是 deploy
# g 是 generate
hexo g -d
# 或者
hexo d -g
等个一会儿后,在浏览器打开https://用户名.github.io
就可以访问博客网站了