设置hexo

发表于 2016-09-09 更新于 2021-11-28 分类于在北京

前言

hexo是一个使用了nodejs的静态博客生成器。可以使用markdown书写文档，然后使用hexo生成可读性更强的网页文件。

写用于share的文档，太多时间用于使用office处理文档(一般是doc)中的代码，插图和正文的格式，效率过低，而且无法进行版本管理。

鉴于doc这类格式的缺点，推荐使用markdown。

Markdown实质上是一种标记语言，其出现的目的就是为了把文档编写者从复杂的格式整理中解放出来，将更多的精力放在内容上；而因其语法简单清晰，所以迅速风靡，现在github的项目文档多数都是markdown格式，例如readme.md。

虽然markdown拥有上述优点，并因之风靡于网络，但传统的PDF格式仍旧被大量使用。鉴于此，有多种方案用来实现markdown与PDF格式的转换。

但是多数方案都或受限于网络，或受限于tex套件和pandoc等。因此推荐将markdown转换为html，然后使用浏览器预览的方式，加强阅读体验，还可以使用浏览器的打印功能输出最后的PDF。

hexo可以根据你的markdown文件构建一个本地web站点，并实现站点的预览，其核心就是将markdown文件转换成html的一种转换器。

从nodejs的官网下载稳定版的nodejs的压缩包，解压后，将其bin目录放在PATH下。

运行：

node -v

可以查看到node的版本号，即表示系统可以找到nodejs并成功运行。

运行：

npm -v

可以查看到npm的版本号，即表示系统可以找到nodejs的包管理器npm并成功运行。

在成功安装好上面的npm后，运行：

npm install hexo-cli

即可为当前用户安装hexo，具体的安装目录大致在~/node_modules, 然后添加 ~/node_modules/hexo-cli/bin/到PATH下。

运行：

hexo -v

可以查看hexo-cli的版本即表示hexo安装成功。

hexo安装成功后，可以创建博客了。

hexo init blog

上面的命令可以初始化一个blog目录，也就是静态博客网站的根目录。

启动博客的本地预览，只需cd到上面的根目录，然后hexo serve即可，默认的访问地址是http://localhost:4000/

即：

cd blog
hexo s

通过浏览器打开上面的网址，即可预览博客。

配置文件是_config.yml，在blog目录下，里面可以设置文章标题格式，作者名称等。

创建文章，标题即引号中的内容。

hexo new post "HelloWorld"

创建页面，可以理解为创建一个目录，目录下创建一个index.md。

hexo new page about