hexo教程系列——hexo配置教程

本文对hexo的配置文件进行了说明。

网站的配置文件

  • 网站配置文件的存储位置:hexo_blog/_config.yml
  • 配置文件中,冒号后面一定要加空格。
  • hexo官方配置说明
  • 我的配置文件内容如下所示。
    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
    # Hexo Configuration Hexo配置文件
    ## Docs: https://hexo.io/docs/configuration.html
    ## Source: https://github.com/hexojs/hexo/
    # Site 网站信息
    #标题
    title: 学志の博客
    #副标题
    subtitle: 记录学习的技能和遇到的问题
    #网站描述
    description: 本网站是个人博客。记录了作者学习过程中遇到的一系列的问题,以及在解决问题过程中获得的技能和成长。
    #作者
    author: 张学志
    #网站语言,默认英语
    language: zh-Hans
    #时区,默认电脑时区
    timezone:
    #timezone: Asia/Shanghai
    # URL 网址设置
    #如果网站是放在子目录中,将url设置成'http://yoursite.com/child',将root设置成'/child/'
    ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
    #网址
    url: http://zhangxuezhi.com
    #网站根目录。如果网站是放在子目录中,将root设置成'子目录名'
    root: /
    #文章链接地址格式
    permalink: :year/:month/:day/:title/
    permalink_defaults:
    # Directory 目录设置
    #资源文件夹,放在里面的文件会上传到github中
    source_dir: source
    #公共文件夹,存放生成的静态文件
    public_dir: public
    #标签文件夹,默认是tags。实际存放在source/tags中。
    tag_dir: tags
    #档案文件夹,默认是archives。
    archive_dir: archives
    #分类文件夹,默认是categories。实际存放在source/categories中。
    category_dir: categories
    #代码文件夹,默认是downloads/code
    code_dir: downloads/code
    #国际化文件夹,默认跟language相同
    i18n_dir: :lang
    #不需要渲染的文件夹或文件夹,放在[]中
    skip_render:
    # Writing 写作选项
    # 新建博文(帖子)的默认名称
    new_post_name: :title.md # File name of new posts
    #默认布局模板是post,而不是draft和page
    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: false
    #是否支持相关链接
    relative_link: false
    future: true
    #高亮选项
    highlight:
    enable: true
    line_number: true
    auto_detect: true
    tab_replace:
    # Category & Tag 分类和标签
    # 默认分类
    #default_category: uncategorized
    default_category: 未分类
    category_map:
    tag_map:
    # Date / Time format 日期和时间格式
    ## 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 分页配置
    ## Set per_page to 0 to disable pagination
    #每页10篇博文
    per_page: 10
    pagination_dir: page
    # Extensions 拓展插件配置
    ## Plugins: https://hexo.io/plugins/
    # 主题配置
    ## Themes: https://hexo.io/themes/
    #theme: landscape
    theme: next
    # Deployment 部署配置
    ## Docs: https://hexo.io/docs/deployment.html
    deploy:
    type: git
    repo: git@github.com:xuezhisd/xuezhisd.github.io.git
    branch: master

主题的配置文件

  • 默认主题是landscape
  • hexo官方主题页面。从中选择喜欢的主题,下载并放到themes文件中。
  • 我使用的主题是NexT

参考博客