用Hexo搭建静态博客(一), Hexo的搭建
Hexo 是一个基于Node.js的开源静态博客程序,通过markdown书写文章,生成的静态网页可以托管在github及gitcafe上。通过Hexo可以方便的创建自己的博客,本博客即使用Hexo创建并托管在github及gitcafe上。
Table of Contents
依赖程序的安装
Hexo 基于Node.js,其部署通过Git进行,以下程序的安装过程仅以Windows平台为例。
安装 Node.js
到Node.js 官网下载安装包,直接双击安装。
安装 Git
到Git官网下载安装包,直接双击安装。
验证安装是否正确
在开始菜单中打开Git Bash
,输入:
1
2git --version
git version 2.5.2.windows.2
如果如上显示正确的版本号则Git 已正确安装。
输入:
1
2npm -v
2.14.7
显示对应版本号则表示Node.js 已正确安装。
安装与部署 Hexo
安装Hexo
打开Git Bash
通过npm命令即可安装Hexo:
1
2npm install hexo-cli -g
npm install hexo --save
初始化 Hexo
打开Git Bash
并切换到想要存放Hexo的目录下,执行以下命令将在该目录下新建文件夹<folder>
并在该文件夹中初始化Hexo:
1
hexo init <folder>
cd <folder>
npm install
新建完成后,指定文件夹的目录如下:
1
.
├── _config.yml #主配置文件
├── package.json #应用数据,不建议手动修改
├── .deploy #将部署的静态文件,为git同步目录
├── node_modules #Hexo安装的所有插件
├── scaffolds #(脚手架)新建文章的模板文件
├── scripts #自定义的随程序运行的脚本文件
├── source #博客源文件,文章markdown文件、404和CNAME文件等
| ├── _drafts #文章草稿,不会被转换为html
| └── _posts #发表的文章
└── themes #主题文件夹
本地查看Hexo 博客
执行以下命令打开Hexo 本地服务器
1
hexo server
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.
在浏览器中打开网址localhost:4000
就可以查看默认的Hexo博客。
安装 Hexo 插件
Hexo 提供了许多插件以提供不同的功能,插件列表列出了可用的插件。以安装hexo-generator-feed插件为例。
该插件可以为博客增加rss订阅支持,在博客目录下打开命令行,输入以下命令即可安装该插件:
1
npm install hexo-generator-feed --save
安装完成后在主目录的配置文件中可以配置该插件的功能:
1
feed:
type: atom
path: atom.xml
limit: 20
然后在页面添加对atom.xml文件的链接即可。 其他插件的功能、安装及配置可以查看插件列表详细了解。
安装 Hexo 主题
通过安装不同的主题,可以方便的使博客拥有不同的外观,官方的主题列表列举一些主题。 一款非常流行的Hexo主题NexT:
另一款流行的主题Jacman:
安装Hexo主题十分简单,首先下载主题后解压到主目录下的themes
文件夹,建议使用git clone
的方式安装主题,便于更新。
以安装NexT主题为例,打开命令行,切换到Hexo主目录下:
1
git clone https://github.com/iissnan/hexo-theme-next themes/next
完成后,主题已被下载到了themes\next
目录下。
当需要更新主题时,执行以下命令即可:
1
2cd themes/next
git pull origin master
之后更改主目录中的配置文件_config.yml
应用新主题,修改其中的theme
字段的值即可:
1
theme: next
# 注意所有参数名后的冒号“:”后面必须有一个空格
然后重新生成网页文件即可:
1
# 清除已经生成的缓存网页文件,只是新增文章时可以不执行该命令
hexo clean
# 生成网页文件,如果生成网页文件有问题,可以尝试先执行上一个clean命令清除缓存再重新生成
hexo generate
hexo generate
也可以用短命令 hexo g
代替。
之后打开本地服务器,查看应用新主题后的博客效果。
1
hexo server
Hexo 的使用
用Hexo书写博客的流程为:
hexo new "post-name"
按照模板文件生成新的文章,该文件位于source/_posts
文件夹中- 按照markdown语法编辑post-name.md文件
hexo generate
生成新的网页文件hexo deploy
部署生成的网页文件
Hexo常用命令
1 | hexo help #查看hexo所有命令及帮助 |
Hexo 中的某些常用命令还支持简写:
1
2
3
4hexo n <=> hexo new
hexo g <=> hexo generate
hexo s <=> hexo server
hexo d <=> hexo deploy
本文主要介绍了Hexo博客本地应用程序的安装以及基本应用,在下一篇文章中将介绍将Hexo生成的博客部署至github及gitcafe上及自定义域名的绑定。