美文网首页关于hexohexo互联网科技
自建博客系列(六)Hexo博客的常用配置修改

自建博客系列(六)Hexo博客的常用配置修改

作者: 海天心Y2kking | 来源:发表于2017-02-07 10:49 被阅读114次

    我的自建博客之路系列的前面几篇文章中,我们已经一起在本地和github、coding搭建起了自己的hexo博客站点,更换了Next主题,并且绑定了自己选择的个人独立域名,但是还未发表过文章,站点的配置还是原来的默认值。在本节,我们来进行个性化的设置,按照自身需要情况将站点打造成自己的。

    这里首先要知道在 Hexo 中有两份主要的配置文件,其名称都是 _config.yml,它们均是用于站点配置使用的。其中,一份位于站点根目录下(比如我的:D:\hexo_config.yml),主要包含 Hexo 本身整站的配置;另一份位于主题目录(D:\hexo\themes\next_config.yml)下,这份配置由主题作者提供,主要用于配置主题相关的选项。为了描述方便,在以下说明中,将前者称为站点配置文件, 后者称为主题配置文件。下面我们先来看看站点配置文件的配置修改。


    修改配置文件时的注意点

    1. 请使用Notepad++或者Sublime Text 2之类的程序,不要使用Windows自带的记事本。(如已忽略,产生中文乱码请修改文件编码格式为UTF-8。)
    • 本人用的是Notepad++,需要的朋友可以到此处——npp_6.9.2——下载。
    1. 不要忽略了冒号后面的空格。

    一、站点配置文件中可设置的功能

    1.网站

    参数 描述
    title 网站标题
    subtitle 网站副标题
    description 网站描述
    author 您的名字
    language 网站使用的语言
    timezone 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York,Japan, 和 UTC 。

    2.网址

    项目 价格 数量
    url 网址
    root 网站根目录
    permalink 文章的 永久链接 格式 :year/:month/:day/:title/
    permalink_default 永久链接中各部分的默认值

    3、目录

    参数 描述 默认值
    source_dir 资源文件夹,这个文件夹用来存放内容。 source
    public_dir 公共文件夹,这个文件夹用于存放生成的站点文件。 public
    tag_dir 标签文件夹 tags
    archive_dir 归档文件夹 archives
    category_dir 分类文件夹 categories
    code_dir Include code 文件夹 downloads/code
    i18n_dir 国际化(i18n)文件夹 :lang
    skip_render 跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。

    4、文章

    参数 描述 默认值
    new_post_name 新文章的文件名称 :title.md
    default_layout 预设布局 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 代码块的设置

    5、分类 & 标签

    参数 描述 默认值
    default_category 默认分类 uncategorized
    category_map 分类别名
    tag_map 标签别名

    6、日期-时间格式)日期 / 时间格式

    Hexo 使用 Moment.js 来解析和显示时间。

    参数 描述 默认值
    date_format 日期格式 YYYY-MM-DD
    time_format 时间格式 H:mm:ss

    7、分页

    参数 描述 默认值
    per_page 每页显示的文章量 (0 = 关闭分页功能) 10
    pagination_dir 分页目录 page

    8、扩展

    参数 描述
    theme 当前主题名称。值为false时禁用主题
    deploy 部署部分的设置

    二、可能需要安装的插件

    1.添加百度/谷歌/本地 自定义站点内容搜索

    在站点的根目录下执行以下命令:

    npm install hexo-generator-searchdb --save
    

    2.hexo-generator-feed 用于生成RSS订阅

    npm install hexo-generator-feed --save
    

    3.hexo-generator-sitemap 用于生成搜索引擎网站地图

    npm install hexo-generator-sitemap --save
    

    4.其他插件

    更多插件请移步Hexo官方插件页了解

    三、我个人目前的一些相关设置

     title: Dream Come True
     subtitle: 现实梦想
     description: The Pursuit of Happyness
     author: 海天心Y2kking
     avatar: /images/avatar.png
     email: 182036669@qq.com #你的联系邮箱
     language: zh-Hans #语言包,需要主题自带才可设置。如Jcaman自带简繁英,设置简体中文填入 zh-CN
     timezone:
    
     # URL #这项暂不配置,绑定域名后,欲创建sitemap.xml需要配置该项
     ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
     url: http://cometrue.top  #站点域名
     root: /
     permalink: :year/:month/:day/:title/  #文章永久链接格式,可添加.html后缀,如 :title.html
     permalink_defaults:
    
     # Directory
     source_dir: source
     public_dir: public
     tag_dir: tags
     archive_dir: archives
     category_dir: categories
     code_dir: downloads/code
     i18n_dir: :lang
     skip_render:
     
     # Writing
     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: false
     relative_link: false
     future: true
     highlight:
       enable: true
       line_number: true
       auto_detect: false
       tab_replace:
    
     # Category & Tag
     default_category: uncategorized
     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
     per_page: 10
     pagination_dir: page
     
     
     # Extensions  主题选择
     ## Plugins: https://hexo.io/plugins/
     ## Themes: https://hexo.io/themes/
     theme: next  #当前主题名称
     
     # Deployment
     ## Docs: https://hexo.io/docs/deployment.html
     deploy:
       type: git
       repo:
           github: git@github.com:yusmile/yusmile.github.io.git,master
           coding: git@git.coding.net:yusmile/yusmile.git,master    
           message: 'Daily updated:{{now("YYYY-MM-DD HH:mm:ss")}} by 海天心Y2kking personal PC'
     
     # 自己另外添加的功能
     #1.baidu_analytics
     baidu_analytics: 8759f43af3e04f8088e92ff251867945
    
     #2.站内搜索 Local Search  添加百度/谷歌/本地 自定义站点内容搜索。  需在站点的根目录下执行以下命令:$      npm install hexo-generator-searchdb --save
     search:
     path: search.xml
     field: post
     format: html
     limit: 10000
    
     #3.Feed 订阅
     feed: # 需安装插件:npm install hexo-generator-feed --save
       type: atom
       path: atom.xml
       limit: 20
       hub:    
     
     #4.自动生成sitemap  SEO推广,需执行以下命令,安装插件npm install hexo-generator-sitemap --save
     sitemap:
    path: sitemap.xml
     baidusitemap:
        path: baidusitemap.xml  
    
      #5.内容分享服务
     # JiaThis 分享服务
     jiathis: true
     # 百度分享服务
     baidushare: true
     # 多说分享服务
     duoshuo_share: true
     duoshuo_hotartical: true  # 多说热评文章 true 或者 false
     duoshuo_shortname: yusmile
     # Disqus Disqus插件,如果使用的话
     #disqus_shortname:
    

    四、检查成果

    现在执行

    hexo clean
    hexo generate
    hexo server
    

    打开localhost:4000查看效果了。

    一切顺利 ^_^

    访问HEXO官方文档


    既然来了,留下个喜欢再走吧,鼓励我继续创作……
    如果喜欢我的文章,那就关注我的简书账号吧,我们一起做朋友~~
    欢迎关注个人微信公众号:海天心

    相关文章

      网友评论

        本文标题:自建博客系列(六)Hexo博客的常用配置修改

        本文链接:https://www.haomeiwen.com/subject/tfceittx.html