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
`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
`root`	The root directory of your website
`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 settings
`highlight.enable`	Enable syntax highlight	`true`
`highlight.auto_detect`	Enable auto-detection if no language is specified	`false`
`highlight.line_number`	Display line number Enabling this option will also enable `wrap` option	`true`
`highlight.tab_replace`	Replace tabs by n space(s); if the value is empty, tabs won’t be replaced	`''`
`highlight.wrap`	Wrap the code block in `<table>`	`true`
`highlight.hljs`	Use the `hljs-*` prefix for CSS classes	`false`

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`
`use_date_for_updated`	Use the date of the post in `post.updated` if no updated date is provided in the front-matter. Typically used with Git workflow	`true`

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

Overriding Theme Config

ธีมของ hexo เป็น project ที่ไม่พึ่งพาไฟล์อื่นๆใน hexo และธีมนั้นจะมีไฟล์
_config.yml ของตน แม้ว่าธีมนั้นมีไฟล์การตั้งค่าของตน
แต่คุณก็ยังสามารถตั้งค่าได้ในไฟล์ _config.yml ท่ีอยู่ใน root repository ของ
hexo

ตัวอย่างของการตั้งค่า:

# _config.yml
theme_config:
  bio: "My awesome bio"

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

ผลการตั้งค่าธีม:

{
  bio: "My awesome bio",
  logo: "a-cool-image.png"
}