HexoHexo

Hexo Docs(一)- 开始准备

2015-06-01  本文已影响919人  lupeng

折腾Hexo这货已经有一段时间了,之前也不愿意去看官方文档,到处搜索如何搭建,如何设置等等,但是有时也无法找到自己想要的内容,于是只能研究官方文档了,奈何是英文的,从没有完整看完。最近静下心来,把Hexo Docs从头看了一遍,将官方文档的大体内容翻译(当然谈不上翻译,只是列出主要内容)了一下,这里只是用自己的话介绍一下主要功能,无用的东西就省略了。

官方Docs分为了4个部分,分别为:开始准备、基础用法、自定义、其他。Hexo的主要内容是在基础用法和自定义这两部分上。

这部分主要介绍了什么是Hexo、如何安装以及基本配置。

Hexo是一个快速的、简单的、功能强大的博客框架。你可以通过Markdown语言写文章,然后hexo帮你生成一个带有漂亮主题的静态页面。

1、安装

安装hexo的前提是要有Node.js以及Git,至于什么是Git和Node以及如何安装他们可以自行搜索了解。

安装完Node以及Git后,通过下面的命令安装Hexo:

npm install -g hexo-cli

2、启动

在电脑中找个目录,并进入目录,执行下面几个命令,hexo就准备就绪了。

hexo init
npm install

上面两条命令,第一条是初始化目录,会自动生成一些基础文件和目录,第二条命令是安装运行hexo的一些必要的组件。

OK,运行完,你会看到你的当前目录下,会自动创建一些目录,如下:

.
├── _config.yml
├── package.json
├── scaffolds/
├── scripts/
├── source/
|   ├── _drafts
|   └── _posts
└── themes/

下面依次介绍上面各个文件或者目录的用途:

3、配置

前面说了,主要配置就是_config.yml这个文件了,所以来看看怎么配置它了。配置也是分了几个大块的。

(1)首先是Site部分,也就是站点的一些参数设置:

(2)接下来是URL部分设置:

如果网址是次级目录,比如:http://example.com/blog,那么就要设置urlhttp://example.com/blog,并且root要设置为/blog/

(3)再接下来就是目录配置:

上面这一部分的值,我基本上没有改过,默认的就行了。

(4)接着是写作配置了:

这一部分也可以基本不变,默认值就行。

(5)接下来是分类和标签的设置:

(6)日期和时间格式配置:

Hexo使用的Moment.js来处理时间的。

(7)分页设置:

(8)最后就是扩展配置:

4、命令

这块主要介绍了hexo的一些命令的使用方法。

5、迁移

从其他博客站点迁移文章到hexo中,像类似Jekyll和Octopress只要把.md的文章拷贝过来就OK了,还有一些需要安装插件。

(1)RSS

首先安装插件npm install hexo-migrator-rss --save,待安装完成后,运行命令hexo migrate rss <source>就可以从RSS迁移所有文章了。source可以是一个文件路径或者URL

(2)Jekyll & Octopress

直接拷贝_posts文件夹里的文章到hexo的source/_posts就OK了,然后修改new_post_name参数为对应文章title命名规则就行了,如:year-:month-:day-:title.md

(3)WordPress

安装插件npm install hexo-migrator-wordpress --save,使用WordPress导出功能导出文章,然后运行命令hexo migrate wordpress <source>source为导出文件

(4)Joomla

安装插件npm install hexo-migrator-joomla --save,使用J2XML组件导出Joomla文章,然后运行命令hexo migrate joomla <source>source为导出文件

导出或者导入,可能出现一些问题,可以自行百度搜索。

上一篇 下一篇

猜你喜欢

热点阅读