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
Raw

上一节：分分钟部署一个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文件

应用数据，默认安装了 EJS，Stylus 和 Markdown 来渲染。如果你不需要可以卸载它们。

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.yml中default_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

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

下一节：开始写作吧