Hexo使用说明笔记
本文简要介绍如何使用Hexo在github上搭建一个个人博客网站,关于Hexo的详细使用说明,还请参考官方文档
1、文件简介
在Hexo生成的目录下,大致有一下几个文件夹/文件:
public 生成的网站文件,发布的站点文件。
source资源文件夹,用于存放内容。
tag 标签文件夹。
archive归档文件夹。
category分类文件夹。
downloads/code include code文件夹。
:lang i18n_dir 国际化文件夹。
_config.yml 配置文件
- 配置说明
# Hexo Configuration ## Docs: https://hexo.io/docs/configuration.html ## Source: https://github.com/hexojs/hexo/ # Site,参数说明:title 网站标题;subtitle 网站副标题;description 网站描述,在搜索引擎中可被搜索的信息,可以配置描述关键字;author 作者姓名;language 网站语言;timezone 网站时区; # 默认使用电脑本地时区,可以用时区表指定,如America/New_York,UTC等。 title: Binglumeng's Blog subtitle: Just do what you want ! author: 冰路梦 language: timezone: # URL ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/' # 参数说明:url 网址;root 网址根目录,要是网站存放在子目录,这里就要配置到子目录路径,如url是https://binglumeng.github.io ,而https://binglumeng.github.io/blog才是文件路径,那么root就要设置为/blog/; # permalink 文章永久链接格式,:year/:month/:day/:title/ ;permalink_defaults 永久链接中各部分的默认值。 url: https://binglumeng.github.io/ # root就是网址路径path root: /binglumeng/ permalink: :year/:month/:day/:title/ permalink_defaults: # Directory 目录参数说明:source_dir 资源文件夹,用于存放内容,默认值source;public_dir 公共文件夹,存放生成的站点文件,默认值public; # tag_dir 标签文件夹 默认值tag;archive_dir 归档文件夹 默认值archives;category_dir 分类文件夹,默认值categories; # code_dir include code 文件夹,默认值 downloads/code ;i18n_dir 国际化文件夹 ,默认值 :lang ;skip_render 跳过指定的渲染,可以使用glob表达式来匹配路径。 source_dir: source public_dir: public tag_dir: tags archive_dir: i_dont_wanna_use_default_archives category_dir: categories code_dir: downloads/code i18n_dir: :lang skip_render: # Writing 文章相关参数:new_post_name 新文章文件名 ,默认值:title.md ; # default_category 预设布局,默认值 post ; # auto_spacing 中英文之间加入空格,默认 false; # titlecase 把标题转换为title case 默认值 false; # external_link 新标签中打开链接 ,默认值 true; # filename_case 把文件名转换为(1)小写或(2)大写。默认值0; # render_drafts 显示草稿,默认值false; # post_asset_folder 启动Asset文件夹,默认值false; # relative_link 把链接改为与根目录的相对路径位置,默认值false; # future 显示未来的文章,默认值true; # highlight 代码块设置 new_post_name: :title.md # File name of new posts default_layout: post titlecase: false # Transform title into titlecase external_link: true # Open external links in new tab filename_case: 0 render_drafts: false post_asset_folder: true relative_link: false future: true highlight: enable: true line_number: true auto_detect: true tab_replace: # Category & Tag 分类和标签 ,default_categorty 默认分类,默认值 uncategorized; # category_map 分类别名;tag_map 标签别名 default_category: uncategorized category_map: tag_map: # Date / Time format 日期时间格式 date_format 日期格式 ,默认是YYYY-MM-DD ;time_format 时间格式 ,H:mm:ss ## Hexo uses Moment.js to parse and display date ## You can customize the date format as defined in ## http://momentjs.com/docs/#/displaying/format/ date_format: YYYY-MM-DD time_format: HH:mm:ss # Pagination 分页 per_page 每页显示的文章数,0表示关闭分页。默认值10; # pagination_dir 分页目录,默认值page ## Set per_page to 0 to disable pagination per_page: 10 pagination_dir: page # Extensions 扩展,theme 当前主题的名称 ,false表示禁止使用主题。 ## Plugins: https://hexo.io/plugins/ ## Themes: https://hexo.io/themes/ theme: binglumeng # Deployment 部署的设置 ## Docs: https://hexo.io/docs/deployment.html deploy: type: git repo: https://github.com/ branch: master
package.json 包信息
指令说明
使用hexo首先要安装node.js和git。本文演示为windows系统下,linux和mac请参照官方文档。
- init
hexo init [folder] # 在cmd命令下,cd到你所需要建立博客的文件夹,执行此命令,其中folder为可选指令,若不写,则默认当前目录。
- new
hexo new [layout] <title> # layout为可选项,默认使用_