深入理解Hexo

纸上得来终觉浅,绝知此事要躬行

Introduction

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

Structure of Workspace

安装 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

文件或文件夹的功能如下:

ITEMNOTEDETAILS
_config.yml配置文件-
package.json应用程序的信息-
scaffolds模版文件夹新建文章时,将根据scaffold来建立文件,填充指定内容。
source资源文件夹_posts文件夹之外,开头命名为_的文件/文件夹和隐藏的文件将会被忽略。MarkdownHTML文件会被解析并放到 public文件夹,而其他文件会被拷贝过去。
themes主题文件夹-
db.json生成的缓存文件-
public生成的静态文件夹?

More Info see https://hexo.io/zh-cn/docs/setup.

Structure of Configure

More info see https://hexo.io/zh-cn/docs/configuration.

您可以在_config.yml中修改大部分的配置;配置往往与命令相关;暂略详情。

Interface of Commands

More info see https://hexo.io/zh-cn/docs/commands.

COMMANDSDESCRIPTIONDETAILSDEMONOTE
init新建一个网站默认在当前文件夹建立网站hexo init [folder=.]-
new新建一篇文章如果title包含空格的话,请使用引号括起来hexo new [layout=default_layout@config] <title>path/replace/slug
generate生成静态文件简写为hexo ghexo generatedeploy/watch/bail/force
publish发表草稿-hexo publish [layout] <filename>-
server启动服务器-hexo server [--port=4000]port/static/log
deploy部署网站简写为hexo ghexo deploygenerate
render渲染文件-hexo render <file1> [file2] ...output
migrate从其他博客系统迁移内容-hexo migrate <type>-
clean清除缓存文件和已生成的静态文件-hexo clean-
list列出网站资料-hexo list <type>-
version显示Hexo版本-hexo version-
OPTIONSDESCRIPTIONDETAILS
--safe在安全模式下,不会载入插件和脚本-
--debug在终端中显示调试信息并记录到debug.log-
--silent隐藏终端信息-
--config覆写配置文件的路径细则
--cwd /path/to/cwd自定义当前工作目录Current Working Directory
--draft显示source/_drafts文件夹中的草稿文章-

Interoperability of Frameworks

非核心功能。该部分主要是将其他框架的博客转换成合法的hexo结构,多通过其他包来完成该功能;暂略。
More info see https://hexo.io/zh-cn/docs/migration.

Basic Usage

该部分是面向终端用户的教程。

Writing

Config

可以通过修改_config.yml中的default_layout参数来指定默认布局。
More info see https://hexo.io/docs/writing.html.

Front-matter

Front-matter是文件最上方以---分隔的区域,用于指定个别文件的变量。
More info see https://hexo.io/zh-cn/docs/front-matter.

Tag Plugins

标签插件和Front-matter中的标签不同,它们是用于在文章中快速插入特定内容的插件。
More info see http://wrran.com/blog/2019/08/18/learn/hexo/tag_plugins/.

Asset Folders

资源(Asset)代表source文件夹中除了文章以外的所有文件。如将少量图片放在source/images文件夹中,后通过![](/images/image.jpg)访问。
More info see https://hexo.io/zh-cn/docs/tag-plugins.

Data Files

有时您可能需要在主题中使用某些资料,而这些资料并不在文章内,并且是需要重复使用的,那么您可以考虑使用Hexo 3.新增的「数据文件」功能。
此功能会载入source/_data内的YAML或JSON文件,如此一来您便能在网站中复用这些文件了。
More info see https://hexo.io/zh-cn/docs/tag-plugins.

Server

该部分阐述hexo server相关问题,已移植到单独的模块中进行开发;暂略。
More info see https://hexo.io/zh-cn/docs/server.

Generating

生成静态文件;暂略。
More info see https://hexo.io/zh-cn/docs/generating.

Deployments

部署网站;暂略。
More info see https://hexo.io/zh-cn/docs/deployment.

Customization

More info see https://hexo.io/docs/permalinks.

您可以在_config.yml配置中调整网站的永久链接或者在每篇文章的Front-matter中指定。
More info see https://hexo.io/zh-cn/docs/permalinks.

Themes

创建Hexo主题;暂略。
More info see https://hexo.io/zh-cn/docs/themes.

Templates

高级用户如何通过模板来定制网站内容的呈现方式;暂略。
More info see https://hexo.io/zh-cn/docs/templates.

Helpers

辅助函数帮助您在模版中快速插入内容。辅助函数不能在源文件中使用。
More info see https://hexo.io/zh-cn/docs/helpers.

Variables

骨灰级用户的变量索引表。
More info see https://hexo.io/zh-cn/docs/variables.

i18n

常见需求;若要让您的网站以不同语言呈现,您可使用国际化(internationalization)功能;暂略。
More info see https://hexo.io/zh-cn/docs/internationalization.

Plugins

面向将入开发级用户;Hexo有强大的插件系统,使您能轻松扩展功能而不用修改核心模块的源码;暂略。
More info see https://hexo.io/zh-cn/docs/plugins.

References

hexo.io

0%