个人博客建设——Hexo的_config.yml配置参数注释 背景 我的CN華少博客 建设也有一段时间了，这段时间想去更新一下文章，突然发现原来的源码被我不知道弄到哪里去了，于是乎我又准备重新建一个项目，并在其基础上更换一套新的模板，并与Typore中的.md文件进行使用尝试，近期这几篇可能就是这个系列来进行了。
正文 本篇用于记录我在创建后的Hexo中进行注释的_config.yml，便于后续进行修改时不记得哪个是干啥的了o(╯□╰)o，所有注释均参考了官方文档进行记录，对于其各个部分进行了模块划分，便于进行阅读使用。下面是我进行注释后的配置文件。有需要的同学可以直接拿去进行修改。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 ###################################### # 网站 # 网站标题 title: CN華少的个人博客 # 网站副标题 subtitle: 个人博客 # 网站描述 description: '' # 网站的关键词。支持多个关键词。 keywords: null # 您的名字 author: CN華少 # 网站使用的语言。对于简体中文用户来说，使用不同的主题可能需要设置成不同的值，请参考你的主题的文档自行设置，常见的有 zh-Hans和 zh-CN。 language: zh-CN # 网站时区。Hexo 默认使用您电脑的时区。请参考 时区列表 进行设置，如 America/New_York, Japan, 和 UTC 。一般的，对于中国大陆地区可以使用 Asia/Shanghai。 timezone: Asia/Shanghai ###################################### # 网址 # 网址, 必须以 http:// 或 https:// 开头 url: https://cnhuashao.com # root 网站根目录 # 文章的 永久链接 格式 permalink: ':year/:month/:day/:title/' # 永久链接中各部分的默认值 permalink_defaults: null # 改写 permalink 的值来美化 URL pretty_urls: # 是否在永久链接中保留尾部的 index.html，设置为 false 时去除 trailing_index: true # 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效) trailing_html: true ##################################### # 目录 # 资源文件夹，这个文件夹用来存放内容。 source_dir: source # 公共文件夹，这个文件夹用于存放生成的站点文件。 public_dir: public # 标签文件夹 tag_dir: tags # 归档文件夹 archive_dir: archives # 分类文件夹 category_dir: categories # Include code 文件夹，source_dir 下的子目录 code_dir: downloads/code # 国际化（i18n）文件夹 i18n_dir: ':lang' # 跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。 # 您可使用 glob 表达式来匹配路径。 skip_render: null ###################################### # 文章 # 新文章的文件名称 new_post_name: ':title.md' # 预设布局 default_layout: post # 把标题转换为 标题大写 titlecase: true # 在新标签中打开链接 external_link: # 在新标签中打开链接 enable: true # 对整个网站（site）生效或仅对文章（post）生效 field: site # 需要排除的域名。主域名和子域名如 www 需分别配置 exclude: '' # 把文件名称转换为 (1) 小写或 (2) 大写 filename_case: 0 # 显示草稿 render_drafts: false # 启动 Asset 文件夹 资源（Asset）代表 source 文件夹中除了文章以外的所有文件，例如图片、CSS、JS 文件等。 post_asset_folder: false # 把链接改为与根目录的相对位址 relative_link: false # 显示未来的文章 future: true # 代码块的设置, 请参考 Highlight.js 进行设置 highlight: enable: true line_number: true auto_detect: false tab_replace: '' wrap: true hljs: false # 代码块的设置, 请参考 PrismJS 进行设置 prismjs: enable: false preprocess: true line_number: true tab_replace: '' index_generator: path: '' per_page: 10 order_by: '-date' ################################### # 分类 & 标签 # 默认分类 default_category: uncategorized # 分类别名 category_map: null # 标签别名 tag_map: null meta_generator: true ################################## # Hexo 使用 Moment.js 来解析和显示时间。 # 日期格式 date_format: YYYY-MM-DD # 时间格式 time_format: HH:mm:ss # 当 Front Matter 中没有指定 updated 时 updated 的取值 # mtime: 使用文件的最后修改时间。这是从 Hexo 3.0.0 开始的默认行为。 # date: 使用 date 作为 updated 的值。可被用于 Git 工作流之中，因为使用 Git 管理站点时，文件的最后修改日期常常会发生改变 # empty: 直接删除 updated。使用这一选项可能会导致大部分主题和插件无法正常工作。 updated_option: mtime ################################### # 分页 # 每页显示的文章量 (0 = 关闭分页功能) per_page: 10 # 分页目录 pagination_dir: page ################################## # 在 Hexo 配置文件中，通过设置 include/exclude 可以让 Hexo 进行处理或忽略某些目录和文件夹。你可以使用 glob 表达式 对目录和文件进行匹配。 # Hexo 默认会忽略隐藏文件和文件夹（包括名称以下划线和 . 开头的文件和文件夹，Hexo 的 _posts 和 _data 等目录除外）。通过设置此字段将使 Hexo 处理他们并将它们复制到 source 目录下。 include: null # Hexo 会忽略这些文件和目录 exclude: null # Ignore files/folders ignore: null ################################## # 扩展 # 当前主题名称。值为false时禁用主题 theme: icarus # 部署部分的设置 deploy: type: '' # Include/Exclude Files/Folders # include: # - ".nojekyll" # 包括 'source/css/_typing.css' # - "css/_typing.css" # 包括 'source/_css/' 中的任何文件，但不包括子目录及其其中的文件。 # - "_css/*" # 包含 'source/_css/' 中的任何文件和子目录下的任何文件 # - "_css/**/*" #exclude: # 不包括 'source/js/test.js' # - "js/test.js" # 不包括 'source/js/' 中的文件、但包括子目录下的所有目录和文件 #- "js/*" # 不包括 'source/js/' 中的文件和子目录下的任何文件 #- "js/**/*" # 不包括 'source/js/' 目录下的所有文件名以 'test' 开头的文件，但包括其它文件和子目录下的单文件 #- "js/test*" # 不包括 'source/js/' 及其子目录中任何以 'test' 开头的文件 #- "js/**/test*" # 不要用 exclude 来忽略 'source/_posts/' 中的文件。你应该使用 'skip_render'，或者在要忽略的文件的文件名之前加一个下划线 '_' # 在这里配置一个 - "_posts/hello-world.md" 是没有用的。 #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"
本文声明： 知识共享许可协议 cn華少 采用 知识共享署名-非商业性使用 4.0 国际许可协议 进行许可。
