Skip to content

Latest commit

 

History

History
286 lines (225 loc) · 8.26 KB

config.md

File metadata and controls

286 lines (225 loc) · 8.26 KB

上一节:分分钟部署一个Hexo环境

准备启程

一旦安装了Hexo,运行以下命令初始化Hexo在目录

$ hexo init <folder>
$ cd <folder>
$ cnpm install

一旦初始化,你的项目文件夹是这个样子:

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

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

  • _config.yml站点配置文件,很多全局配置都在这个文件中。
  • package.json 应用数据。从它可以看出hexo版本信息,以及它所默认或者说依赖的一些组件。
  • scaffolds 模版文件。当你创建一篇新的文章时,hexo会依据模版文件进行创建,主要用在你想在每篇文章都添加一些共性的内容的情况下。
  • scripts 放脚本的文件夹, 就是放js文件的地方
  • source 这个文件夹就是放文章的地方了,除了文章还有一些主要的资源,比如文章里的图片,文件等等东西。这个文件夹最好定期做一个备份,丢了它,整个站点就废了。
  • themes 主题文件夹。

配置

_config.yml配置文件

站点配置文件,你可以在这里进行大多数配置。

网站设置

配置 描述
title 站点名字,也就是html的title,会显示在浏览器标签上
subtitle 站点副标题,会显示在首页上,可以不填
description 站点描述,可以不填
author 作者名称
language 语言
timezone 站点时区,默认是电脑时间

链接设置

配置 描述
url 站点网址
root 站点根目录
permalink 文章的永久网址链接,默认是:year/:month/:day/:title/,指的什么意思?比如我一篇叫『love』的文章是在2012年1月1日写的,那么它对应的链接就是http://yoururl/2012/01/01/love/
permalink_default

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

目录设置

配置 描述
source_dir source目录,默认值为source
public_dir public目录,静态网站生成的地方,默认值为public
tag_dir tag目录
archive_dir Archive目录
category_dir 分类目录
code_dir 代码目录
i18n_dir i18n目录
skip_render 不想被渲染的路径

写作设置

配置 描述
new_post_name 新建文章默认文件名,默认值为 :title.md,比如你执行命令hexo new hello,就会默认在_post目录下创建一个hello.md的文件
default_layout 默认布局
titlecase
external_link 在新标签中打开一个外部链接,默认为true
filename_case 转换文件名,1代表小写;2代表大写;默认为0,意思就是创建文章的时候,是否自动帮你转换文件名,默认就行,意义不大
render_drafts 是否渲染_drafts目录下的文章,默认为false
post_asset_folder 是否启用Asset Folder,默认为false,至于什么是Asset Folder,后面有讲解
relative_link 使链接相对于根文件夹,默认false
future 是否显示未来日期文章,默认为true
highlight 代码块设置

分类 & 标签

配置 描述
default_category 默认分类,默认为无分类,当然你可以设置一个默认分类。
category_map 分类缩略名
tag_map 标签缩略名

日期格式化

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

配置 描述
date_format 日期格式,默认为MMM D YYYY,一般我们喜欢使用YYYY-MM-DD的格式,其他格式模版可以查看Moment.js
time_format 时间格式,默认为H:mm:ss

分页

配置 描述
per_page 一页显示多少篇文章,0 为不分页,默认值为 10
pagination_dir 分页目录,默认值为page

扩展

配置 描述
theme 主题配置,此处填上主题名就OK了,当然在themes目录下一定要有你配置的主题文件夹
deploy 部署配置,将本地public目录也就是网站部署到服务器上的配置

package.json文件

应用数据,默认安装了 EJSStylusMarkdown 来渲染。如果你不需要可以卸载它们。

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-category": "^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

脚手架文件夹。当你创建一个新文章,Hexo基于scaffolds文件夹里的类型来创建。

scripts

脚本文件夹。扩展Hexo最简单的方法,它会自动执行这个文件夹下的JavaScript文件。

命令

init

$ hexo init [folder]

初始化一个网站。如果没有提供folder,Hexo会在当前目录设置网站。

new

$ hexo new [layout] <title>

创建一篇文章,如果不指定layout,那么就使用_config.ymldefault_layout的值,标题中如果有空格,将整个title放到引号中。 比如,hexo new "hello world"创建一篇叫hello world的文章。

generate

$ hexo generate

生成静态文件:

选项 描述
-d, --deploy 生成完后直接部署
-w, --watch 监控文件的改变

publish

$ hexo publish [layout] <filename>

发布为草稿

server

$ hexo server

启动一个本地服务,默认情况下访问 http://localhost:4000/

选项 描述
-p, --port 指定端口
-s, --static 仅服务静态文件
-l, --log 开启日志

deploy

$ hexo deploy

部署你的站点

选项 描述
-g, --generate 表示在部署前先重新生成一下站点

render

$ hexo render <file1> [file2] ...

渲染文件

选项 描述
-o, --output 输出到指定文件,我没用过

migrate

$ hexo migrate <type>

迁移到其他模块的命令。

clean

$ hexo clean

删除缓存文件db.json以及生成的public目录,当你修改了某些样式或者配置时,如果发现hexo g后也没有反应,就可以执行一下这个命令。

list

$ hexo list <type>

列出所有路由

version

$ hexo version

显示hexo的版本信息到控制台

Options

Safe mode

$ hexo --safe

安全模式,使所有插件和脚本不生效

Debug mode

$ hexo --debug

日志详细信息输出到终端。

Silent mode

$ hexo --silent

静默模式,不在终端上显示任何信息

Customize config file path

$ hexo --config custom.yml

使用一个自定义配置文件替换默认_config.yml

Display drafts

$ hexo --draft

显示草稿文章(位于source/_drafts目录下)

Customize CWD

$ hexo --cwd /path/to/cwd

自定义当前工作目录路径,假如你没在工作目录下,可以使用这个命令指定一下工作目录路径

下一节:开始写作吧