hexo环境搭建
什么是Hexo?
1
| Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
|
安装前提
1 2 3 4 5 6 7
| 安装 Hexo 相当简单。然而在安装前,您必须检查电脑中是否已安装下列应用程序:
- Node.js - Git
这两个应用程序的mac、windows的安装就不讲了,官网就有这部分“ https://hexo.io/zh-cn/docs/ ”
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
| 我的环境是在Linux上搭建的
安装 Node.js 的最佳方式是使用 nvm。
$ wget -qO- https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
安装完成后,重启终端并执行下列命令即可安装 Node.js。
$ nvm install stable
安装Hexo
所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
$ npm install -g hexo-cli
|
建站
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
1 2 3
| $ hexo init <folder> $ cd <folder> $ npm install
|
新建完成后,指定文件夹的目录如下:
1 2 3 4 5 6 7 8
| . ├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes
|
_config.yml
1
| 网站的 配置 信息,您可以在此配置大部分的参数。
|
package.json
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
| 应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装,您可以自由移除。
package.json { "name": "hexo-site", "version": "0.0.0", "private": true, "hexo": { "version": "" }, "dependencies": { "hexo": "^3.0.0", "hexo-generator-archive": "^0.1.0", "hexo-generator-categories": "^0.1.0", "hexo-generator-index": "^0.1.0", "hexo-generator-tag": "^0.1.0", "hexo-renderer-ejs": "^0.1.0", "hexo-renderer-stylus": "^0.2.0", "hexo-renderer-marked": "^0.2.4", "hexo-server": "^0.1.2" } }
|
scaffolds
1 2 3
| 模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的markdown文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。
|
source
1
| 资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
|
themes
1
| 主题 文件夹。Hexo 会根据主题来生成静态页面。
|
配置
关于Hexo的大部分配置都在_config.yml。
网站
1 2 3 4 5 6 7 8 9 10
| 参数 描述 title 网站标题 subtitle 网站副标题 description 网站描述 author 您的名字 language 网站使用的语言 timezone 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York, Japan, 和 UTC 。
其中,description主要用于SEO,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。
|
网址
1 2 3 4 5 6 7 8
| 参数 描述 默认值 url 网址 root 网站根目录 permalink 文章的 永久链接 格式 :year/:month/:day/:title/ permalink_defaults 永久链接中各部分的默认值
网站存放在子目录 如果您的网站存放在子目录中,例如 http://yoursite.com/blog,则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。
|
目录
1 2 3 4 5 6 7 8 9 10 11 12
| 参数 描述 默认值 source_dir 资源文件夹,这个文件夹用来存放内容。 source public_dir 公共文件夹,这个文件夹用于存放生成的站点文件。 public tag_dir 标签文件夹 tags archive_dir 归档文件夹 archives categories_dir 分类文件夹 categories code_dir Include code 文件夹 downloads/code i18n_dir 国际化(i18n)文件夹 :lang skip_render 跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。
提示 如果您刚刚开始接触Hexo,通常没有必要修改这一部分的值。
|
文章
1 2 3 4 5 6 7 8 9 10 11 12
| 参数 描述 默认值 new_post_name 新文章的文件名称 :title.md default_layout 预设布局 post auto_spacing 在中文和英文之间加入空格 false titlecase 把标题转换为 title case false external_link 在新标签中打开链接 true filename_case 把文件名称转换为 (1) 小写或 (2) 大写 0 render_drafts 显示草稿 false post_asset_folder 启动 Asset 文件夹 false relative_link 把链接改为与根目录的相对位址 false future 显示未来的文章 true highlight 代码块的设置
|
分类 & 标签
1 2 3 4
| 参数 描述 默认值 default_categories 默认分类 uncategorized categories_map 分类别名 tag_map 标签别名
|
日期 / 时间格式
1 2 3 4 5
| Hexo 使用 Moment.js 来解析和显示时间。
参数 描述 默认值 date_format 日期格式 YYYY-MM-DD time_format 时间格式 H:mm:ss
|
分页
1 2 3
| 参数 描述 默认值 per_page 每页显示的文章量 (0 = 关闭分页功能) 10 pagination_dir 分页目录 page
|
扩展
1 2 3
| 参数 描述 theme 当前主题名称。值为false时禁用主题 deploy 部署部分的设置
|
指令
init
1 2 3
| $ hexo init [folder]
新建一个网站。如果没有设置 `folder` ,Hexo 默认在目前的文件夹建立网站。
|
new
1 2 3
| $ hexo new [layout] <title>
新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
|
generate
选项 |
描述 |
-d, –deploy |
文件生成后立即部署网站 |
-w , --watch |
监视文件变动 |
publish
1 2
| $ hexo publish [layout] <filename> 发表草稿。
|
server
1 2
| $ hexo server 启动服务器。默认情况下,访问网址为: http://localhost:4000/。
|
参数 |
描述 |
-o , --output |
设置输出路径 |
migrate
1 2 3
| $ hexo migrate <type>
从其他博客系统 迁移内容。
|
clean
1 2 3 4
| $ hexo clean 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令
|
list
1 2
| $ hexo list <type> 列出网站资料。
|
version
1 2
| $ hexo version 显示 Hexo 版本。
|
选项
安全模式
1 2 3
| $ hexo --safe
在安全模式下,不会载入插件和脚本。当您在安装新插件遭遇问题时,可以尝试以安全模式重新执行。
|
调试模式
简洁模式
自定义配置文件的路径
1 2 3
| $ hexo --config custom.yml
自定义配置文件的路径,执行后将不再使用 _config.yml。
|
显示草稿
1 2 3
| $ hexo --draft
显示 source/_drafts 文件夹中的草稿文章。
|
自定义CWD
1 2 3
| $ hexo --cwd /path/to/cwd
自定义当前工作目录(Current working directory)的路径。
|
基本操作
写作
执行以下命令开创建一片新文章
1 2 3
| hexo new [layout] <title>
您可以在命令中指定文章的布局(layout),默认为 post,可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。
|
布局(layout)
1
| Hexo 有三种默认布局:post、page 和 draft,它们分别对应不同的路径,而您自定义的其他布局和 post 相同,都将储存到 source/_posts 文件夹。
|
布局 |
路径 |
post |
source/_posts |
page |
source |
draft |
source/_drafts |