Configuration

คุณสามารถแก้ไขการตั้งค่าของเว็บไซต์ใน _config.yml หรือในไฟล์ alternate config file

Site

Setting	Description
`title`	The title of your website
`subtitle`	The subtitle of your website
`description`	The description of your website
`keywords`	The keywords of your website. Supports multiple values.
`author`	Your name
`language`	The language of your website. Use a 2-lettter ISO-639-1 code. Default is `en`.
`timezone`	The timezone of your website. Hexo uses the setting on your computer by default. You can find the list of available timezones here. Some examples are `America/New_York`, `Japan`, and `UTC`.

URL

Setting	Description	Default
`url`	The URL of your website, must starts with `http://` or `https://`
`root`	The root directory of your website	`url's pathname`
`permalink`	The permalink format of articles	`:year/:month/:day/:title/`
`permalink_defaults`	Default values of each segment in permalink
`pretty_urls`	Rewrite the `permalink` variables to pretty URLs
`pretty_urls.trailing_index`	Trailing `index.html`, set to `false` to remove it	`true`
`pretty_urls.trailing_html`	Trailing `.html`, set to `false` to remove it (does not apply to trailing `index.html`)	`true`

Website in subdirectory
ถ้าเว็บไซต์ของคุณอยู่ใน subdirectory (เช่น http://example.org/blog )
ตั้งค่า url เป็น http://example.org/blog และตั้งค่า root เป็น /blog/

Setting	Description	Default
`source_dir`	Source folder. Where your content is stored	`source`
`public_dir`	Public folder. Where the static site will be generated	`public`
`tag_dir`	Tag directory	`tags`
`archive_dir`	Archive directory	`archives`
`category_dir`	Category directory	`categories`
`code_dir`	Include code directory (subdirectory of `source_dir`)	`downloads/code`
`i18n_dir`	i18n directory	`:lang`
`skip_render`	Paths that will be copied to `public` raw, without being rendered. You can use glob expressions for path matching. For example, `skip_render: mypage/*/` will output `source/mypage/index.html` and `source/mypage/code.js` without altering them.

Writing

Setting	Description	Default
`new_post_name`	The filename format for new posts	`:title.md`
`default_layout`	Default layout	`post`
`titlecase`	Transform titles into title case?	`false`
`external_link`	Open external links in a new tab?
`external_link.enable`	Open external links in a new tab?	`true`
`external_link.field`	Applies to the whole `site` or `post` only	`site`
`external_link.exclude`	Exclude hostname. Specify subdomain when applicable, including `www`	`[]`
`filename_case`	Transform filenames to `1` lower case; `2` upper case	`0`
`render_drafts`	Display drafts?	`false`
`post_asset_folder`	Enable the Asset Folder?	`false`
`relative_link`	Make links relative to the root folder?	`false`
`future`	Display future posts?	`true`
`highlight`	Code block syntax highlight settings, see Highlight.js section for usage guide
`prismjs`	Code block syntax highlight settings, see PrismJS section for usage guide

Category & Tag

Setting	Description	Default
`default_category`	Default category	`uncategorized`
`category_map`	Category slugs
`tag_map`	Tag slugs

Date / Time format

hexo ใช้ Moment.js มาจัดการวันเดือนปี

Setting	Description	Default
`date_format`	Date format	`YYYY-MM-DD`
`time_format`	Time format	`HH:mm:ss`
`updated_option`	The `updated` value to used when not provided in the front-matter	`mtime`

updated_option
updated_option controls the updated value when not provided in the front-matter:

mtime: Use file modification date as updated. It is the default behavior of Hexo since 3.0.0

date: Use date as updated. Typically used with Git workflow when file modification date could be different.

empty: Simply drop updated when not provided. May not be compatible with most themes and plugins.

use_date_for_updated is deprecated and will be removed in next major version. Please use updated_option: 'date' instead.

Setting	Description	Default
`per_page`	The amount of posts displayed on a single page. `0` disables pagination	`10`
`pagination_dir`	Pagination directory	`page`

Extensions

Setting	Description
`theme`	Theme name. `false` disables theming
`theme_config`	Theme configuration. Include any custom theme settings under this key to override theme defaults.
`deploy`	Deployment settings
`meta_generator`	Meta generator tag. `false` disables injection of the tag.

Include/Exclude Files or Folders

ในไฟล์การตั้างค่า ตั้งค่า include/exclude ได้เพื่อทำให้ hexo
จัดการหรือละเลยไฟล์หรือ folder เฉพาะ

include and exclude options only apply to the source/ folder, whereas ignore option applies to all folders.

Setting	Description
`include`	Hexo by default ignores hidden files and folders, but setting this field will make Hexo process them
`exclude`	Hexo process will ignore files list under this field
`ignore`	Ignore files/folders

ตัวอย่าง:

# Include/Exclude Files/Folders
include:
  - ".nojekyll"
  # Include 'source/css/_typing.css'.
  - "css/_typing.css"
  # Include any file in 'source/_css/'.
  - "_css/*"
  # Include any file and subfolder in 'source/_css/'.
  - "_css/**/*"

exclude:
  # Exclude 'source/js/test.js'.
  - "js/test.js"
  # Exclude any file in 'source/js/'.
  - "js/*"
  # Exclude any file and subfolder in 'source/js/'.
  - "js/**/*"
  # Exclude any file with filename that starts with 'test' in 'source/js/'.
  - "js/test*"
  # Exclude any file with filename that starts with 'test' in 'source/js/' and its subfolders.
  - "js/**/test*"
  # Do not use this to exclude posts in the 'source/_posts/'.
  # Use skip_render for that. Or prepend an underscore to the filename.
  # - "_posts/hello-world.md" # Does not work.

ignore:
  # Ignore any folder named 'foo'.
  - "**/foo"
  # Ignore 'foo' folder in 'themes/' only.
  - "**/themes/*/foo"
  # Same as above, but applies to every subfolders of 'themes/'.
  - "**/themes/**/foo"

Each value in the list must be enclosed with single/double quotes.

include: and exclude: do not apply to the themes/ folder. Either use ignore: or alternatively, prepend an underscore to the file/folder name to exclude.

* Notable exception is the source/_posts folder, but any file or folder with a name that starts with an underscore under that folder would still be ignored. Using include: rule in that folder is not recommended.

Using an Alternate Config

path ของไฟล์การตั้งค่าจะถูกตั้งค่าได้โดยการเพิ่ม flag --config หลังคำสั่ง
path นั้นสามารถชี้ถึงไฟล์การตั้งค่าท่ีมีรูปแบบเป็น YAML หรือ JSON
หรือมีหมวกไฟล์ท่ีตัดรายชื่อด้วยเครื่องหมายจุลภาค

# use 'custom.yml' in place of '_config.yml'
$ hexo server --config custom.yml

# use 'custom.yml' & 'custom2.json', prioritizing 'custom2.json'
$ hexo server --config custom.yml,custom2.json

การใช้ไฟล์ต่างๆจะทำให้เกิดการเปลี่ยนแปลงของไฟล์การตั้งค่าและ
การเปลี่ยนแปลงนั้นจะถูกบันทึกอยู่ในไฟล์ _multiconfig.yml
สำหรับการตั้งค่า parameter เดียวกันนั้น value ท่ีอยู่ตัวหลังจะเกิดผล
ไม่ว่ามีไฟล์ JSON และ YAML เป็นจำนวนเท่าไร ก็ปฏิบัติตามกฏอย่างนี้
มีสิ่งท่ีต้องระวังคือ no spaces are allowed in the list

ยกตัวอย่างเช่น ในตัวอย่างท่ีกล่าวข้างต้น ถ้่า foo: bar อยู่ในไฟล์ custom .yml แต่ "foo": "dinosaur" อยู่ในไฟล์ custom2.json ไฟล์
_multiconfig.yml นั้นจะมีการตั้งค่าเป็น foo: dinosaur

Alternate Theme Config

Hexo themes are independent projects, with separate _config.yml files.

Instead of forking a theme, and maintaining a custom branch with your settings, you can configure it from somewhere else.

theme_config in site’s primary configuration file

Supported since Hexo 2.8.2

# _config.yml
theme: "my-theme"
theme_config:
  bio: "My awesome bio"
  foo:
    bar: 'a'

# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
  foo:
    baz: 'b'

Resulting in theme configuration:

{
  bio: "My awesome bio",
  logo: "a-cool-image.png",
  foo: {
    bar: "a",
    baz: "b"
  }
}

dedicated _config.[theme].yml file

Supported since Hexo 5.0.0

The file should be placed in your site folder, both yml and json are supported. theme inside _config.yml must be configured for Hexo to read _config.[theme].yml

# _config.yml
theme: "my-theme"

# _config.my-theme.yml
bio: "My awesome bio"
foo:
  bar: 'a'

# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
  foo:
    baz: 'b'