Hexo | Ceilzcx's blog = hexo-blog

# Hexo 操作手册

# 一、建站

# 1.1 安装 Hexo

1	npm install -g hexo-cli

# 1.2 新建项目

1	hexo init <folder>

# 1.3 项目结构

_config.yml ：网站配置信息

参数	描述
`title`	网站标题
`subtitle`	网站副标题
`description`	网站描述
`keywords`	网站的关键词。支持多个关键词。
`author`	您的名字
`language`	网站使用的语言。对于简体中文用户来说，使用不同的主题可能需要设置成不同的值，请参考你的主题的文档自行设置，常见的有 `zh-Hans` 和 `zh-CN` 。
`timezone`	网站时区。Hexo 默认使用您电脑的时区。请参考时区列表进行设置，如 `America/New_York` , `Japan` , 和 `UTC` 。一般的，对于中国大陆地区可以使用 `Asia/Shanghai` 。
参数	描述	默认值
:---------------------------	:-----------------------------------------------------------	:--------------------------
`url`	网址，必须以 `http://` 或 `https://` 开头
`root`	网站根目录	`url's pathname`
`permalink`	文章的永久链接格式	`:year/:month/:day/:title/`
`permalink_defaults`	永久链接中各部分的默认值
`pretty_urls`	改写 `permalink` 的值来美化 URL
`pretty_urls.trailing_index`	是否在永久链接中保留尾部的 `index.html` ，设置为 `false` 时去除	`true`
`pretty_urls.trailing_html`	是否在永久链接中保留尾部的 `.html` , 设置为 `false` 时去除 (对尾部的 `index.html` 无效)	`true`
参数	描述	默认值
--------------	------------------------------------------------------------	----------------
`source_dir`	资源文件夹，这个文件夹用来存放内容。	`source`
`public_dir`	公共文件夹，这个文件夹用于存放生成的站点文件。	`public`
`tag_dir`	标签文件夹	`tags`
`archive_dir`	归档文件夹	`archives`
`category_dir`	分类文件夹	`categories`
`code_dir`	Include code 文件夹， `source_dir` 下的子目录	`downloads/code`
`i18n_dir`	国际化（i18n）文件夹	`:lang`
`skip_render`	跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 `public` 目录中。您可使用 glob 表达式来匹配路径。

:----------------------	:-----------------------------------------------------------	:--------
参数	描述	默认值
`new_post_name`	新文章的文件名称	:title.md
`default_layout`	预设布局	post
`auto_spacing`	在中文和英文之间加入空格	false
`titlecase`	把标题转换为 title case	false
`external_link`	在新标签中打开链接	true
`external_link.enable`	在新标签中打开链接	`true`
`external_link.field`	对整个网站（ `site` ）生效或仅对文章（ `post` ）生效	`site`
`external_link.exclude`	需要排除的域名。主域名和子域名如 `www` 需分别配置	`[]`
`filename_case`	把文件名称转换为 (1) 小写或 (2) 大写	0
`render_drafts`	显示草稿	false
`post_asset_folder`	启动 Asset 文件夹	false
`relative_link`	把链接改为与根目录的相对位址	false
`future`	显示未来的文章	true
`highlight`	代码块的设置，请参考 Highlight.js 进行设置
`prismjs`	代码块的设置，请参考 PrismJS 进行设置

package.json ：应用程序信息，导入的依赖
scaffolds ：模板文件夹
source ：资源文件夹
themes ：主题文件夹

hexo