前言
Hexo 是一个快速、简洁且高效的博客框架。使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页,这是一片专属于你的净土!无论从怎样都是值得尝试的东西。
随手一甩就是一份官方文档
markdown排版示例站
[我的博客(捂脸)]www.langwazi.cn
好了本篇文章结束!
安装环境
安装 Hexo 相当简单。然而在安装前,您必须检查电脑中是否已安装下列应用程序:
上述环境安装完毕后,只需要使用 npm 即可完成 Hexo 的安装。
$ npm install -g hexo-cli
开始建站
在目标目录执行下面命令完成工程目录初始化。
$ hexo init <folder>
$ cd <folder>
$ npm install
初始化完成后目录文件结构如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
上面所有文件中需要关心的是_config.yml文件和themes目录
_config.yml
网站的 配置 信息,您可以在此配置大部分的参数。
themes
该目录为主题样式目录,修改网站样式和一些样式相关的配置都在改目录下进行操作。
目前为止博客框架就搭建完成,是不是巨简单呢!
cd <博客工程目录>
hexo s -debug
出现上面的提示后,在浏览器中访问http://localhost:4000/ 就能看到博客效果啦!
默认的Hexo主题样式不是很美观,所以我们需要进行优化更改一下主题。
修改主题
许多主题模板都可直接传送门找到。在上面找到你心仪的模板并按照模板提供的文档进行配置即可。
本博客使用的主题是NexT。修改成NexT主题步骤如下:
$ cd your-hexo-site
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
主题安装完毕后打开上文提到的_config.yml站点配置文件,找到配置节点theme,并设置theme: next
。
修改保存后hexo s -debug
调试运行查看是否成功启用NexT主题。
部署博客
经过上面一系列的骚操作后,博客在本地已经能完美运行了。是时候将博客部署到线上去了。
线上有许多页面托管服务,以我使用过的为例吧。
点击上面两个链接查看官方文档即可开通对应的pages服务。
对于我们来讲就是在对应平台上创建了个特殊用途的git仓库,因此在初始化时不要添加任何文件保持一个空的git仓库最佳。
当pages服务创建成功后,将仓库地址配置到站点配置_config.yml文件中,找到下方节点。
文档地址
deploy:
- type: git
repo: pages服务的仓库地址
branch: master
注意上面分支名一定是master,方便后面处理。
一切完成后。
#将md和其他文件生成静态页面
$ hexo generate
#将生成的静态页面部署到上面配置的仓库
$ hexo deploy
通过pages服务提供的公网访问方式进行访问就可以看到刚才发布的博客。
备份
博客配置、美化扩展、以及编写博客等工作非常的耗时耗力。git上master存储的是生成静态页面后的代码和文件。想想哪天你的电脑损坏或者重装系统等情况,你该如何保持你的博客工程呢?U盘拷贝?
其实我们可以通过git的分支特性来保持,master分支用来存放生成后的静态页面,用来部署博客;在创建一个src分支专门来存放工程源文件。
完成上面的我们只需修改上面部署时设置的deploy节点,新增一个src分支上传所有源码工程。
deploy:
- type: git
repo: pages服务的仓库地址
branch: master
- type: git
repo: pages服务的仓库地址
branch: src
extend_dirs: /
ignore_hidden: false
ignore_pattern:
public: .
这样在你每次部署博客时,都会自动上传源文件到对应的分支。
特别需要注意的是这种方法需要将启用的主题目录,例如\themes\next
下的.git
隐藏目录删除。
- 一般来说主题并不会经常的去更新拉取,你拉取时可能会覆盖掉你辛苦修改部分。
- 如果保留主题下的git在上传保存源码和文件时会自动忽略掉主题目录下的文件,这是由git设计特性决定的。(说用git submodule请你出克)
恢复
那么如何恢复呢?so easy!
- 安装环境,git、node.js、以及Hexo,只需要安装好即可,完全不需要额外的配置。
- 环境准备好后,去你备份的仓库下载src分支的源码。
为了少折腾记住是通过下载而不是git clone
,通过cloen方式的自觉删除掉.git文件。
$ cd 工程目录
$ npm install
执行完毕后,就可以像往常一样骚操作啦。
写在后面的话
本篇只有大体的流程和说明,具体的操作请翻阅文中提供的文档和连接。
只有经历过文档和Google才是自己的。
当然这么做还有一个很重要的原因,那就是我懒啊!