hexo+github创建个人博客--深入篇


  • 内容简介

    此篇文章介绍的是个人博客的一些配置内容,包含博客项目的介绍、主题配置、图床配置以及各种第三方功能插件的使用,若还未搭建个人博客的哥们可以先参考hexo+github创建个人博客–基础篇搭建出自己的个人博客。


  • hexo项目介绍

    1.目录结构介绍

    • .deploy #需要部署的文件
    • node_modules #Hexo插件
    • public #生成的静态网页文件
    • scaffolds #模板
    • source #博客正文和其他源文件,404、favicon、CNAME 都应该放在这里
    • _drafts #草稿
    • _posts #文章
    • themes #主题
    • _config.yml #全局配置文件
    • package.json

    2.全局配置文件介绍

    title: 个人博客     //页面标题
    subtitle: 玉面小飞龙 //小标题
    description: 贼溜 //描述
    author: Little Dragon //作者
    language: zh-CN //语言
    timezone: //时区


    # URL


    ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'

    url: https://halomelody.github.io/ //个人域名
    root: / //根目录
    permalink: :year/:month/:day/:title/ //文章创建后生成的目录结构
    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:


    # Home page setting


    # path: Root path for your blogs index page. (default = '')


    # per_page: Posts displayed per page. (0 = disable pagination)


    # order_by: Posts order. (Order by date descending by default)

    index_generator: //分页设置
    path: ''
    per_page: 5
    order_by: -date


    # 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: 5
    pagination_dir: page


    # Extensions


    ## Plugins: https://hexo.io/plugins/


    ## Themes: https://hexo.io/themes/

    theme: yilia //主题配置


    # Deployment


    ## Docs: https://hexo.io/docs/deployment.html

    deploy: //发布对应的github账号
    type: git
    repo: git@github.com:haloMelody/haloMelody.github.io.git
    branch: master

  • 主题配置

    1.主题选择

    • 网上好的主题有很多,可以点击选择,本文介绍的是yilia主题

    2.配置主题

    • 从github上下载主题

      git clone https://github.com/litten/hexo-theme-yilia.git
    • 将主题配置到个人博客中,在根目录的全局配置文件中修改此变量(主题项目中也有_config.yml配置文件)

      theme: yilia
    • 主题配置文件介绍(摘要)


      # Header,主题页面显示链接

      menu:
      主页: /
      所有文章: /archives


      # Content


      # 文章太长,截断按钮文字

      excerpt_link: more

      # 文章卡片右下角常驻链接,不需要请设置为false

      show_all_link: '展开全文'

      # 数学公式

      mathjax: false

      # 是否在新窗口打开链接

      open_in_new: false


      # 打赏


      # 打赏type设定:0-关闭打赏; 1-文章对应的md文件里有reward:true属性,才有打赏; 2-所有文章均有打赏

      reward_type: 1

      # 打赏wording

      reward_wording: 老板大气,谢谢老板!

      # 支付宝二维码图片地址,跟你设置头像的方式一样。比如:/assets/img/alipay.jpg

      alipay: http://ou36vgj5u.bkt.clouddn.com/image/blog/alipay.JPG

      # 微信二维码图片地址

      weixin: http://ou36vgj5u.bkt.clouddn.com/image/blog/wechatpay.JPG


      # 目录


      # 目录设定:0-不显示目录; 1-文章对应的md文件里有toc:true属性,才有目录; 2-所有文章均显示目录

      toc: 1

      # 根据自己的习惯来设置,如果你的目录标题习惯有标号,置为true即可隐藏hexo重复的序号;否则置为false

      toc_hide_index: true

      # 目录为空时的提示

      toc_empty_wording: '目录,不存在的…'


      # 是否有快速回到顶部的按钮

      top: true


      # Miscellaneous,网站统计

      baidu_analytics: '24451a8b853bb443019686be21dfdff4'
      google_analytics: ''
      favicon: http://ou36vgj5u.bkt.clouddn.com/image/blog/fav.ico


      #你的头像url

      avatar: http://ou36vgj5u.bkt.clouddn.com/image/blog/head.jpg


      #是否开启分享

      share_jia: true


      #评论:1、多说;2、网易云跟帖;3、畅言;4、Disqus 不需要使用某项,直接设置值为false,或注释掉


      #具体请参考wiki:https://github.com/litten/hexo-theme-yilia/wiki/


      #1、多说

      duoshuo: false

      #2、网易云跟帖

      wangyiyun: false

      #3、畅言

      changyan_appid: false
      changyan_conf: false

      #4、Disqus 在hexo根目录的config里也有disqus_shortname字段,优先使用yilia的

      disqus: false

      #disqus_shortname: halomelody



      # slider的设置

      slider:
      # 是否默认展开tags板块
      showTags: true


      # 智能菜单


      # 如不需要,将该对应项置为false


      # 比如


      #smart_menu:


      # friends: false

      smart_menu:
      innerArchive: '文章查找'
      friends: '友链'
      aboutme: '关于我'
      #tagcloud: '标签'


      #friends:

      aboutme: little dragon


      # 页面统计 true为开启


      #page_count: false



      # 站点统计 true为开启


      #site_count: true
    • 弹框配置

      • 首先需要具备hexo中nodeJS版本高于6.2才可以生效(下载最新的nodeJS->得到的hexo可以即可满足,可以通过hexo -v查看nodeJS版本)

      hexo-yilia-pop

      • 在根目录配置文件中添加如下内容:

        jsonContent:  
        meta: false
        pages: false
        posts:
        title: true
        date: true
        path: true
        text: true
        raw: false
        content: false
        slug: false
        updated: false
        comments: false
        link: false
        permalink: false
        excerpt: false
        categories: false
        tags: true
      • 执行清除,生成,其服务等操作查看效果

    • 标签配置

      title: hexo+github创建个人博客--深入篇
      tags:
      - hexo
      - github
      - yilia
    • 文章分类

      title: hexo+github创建个人博客--深入篇
      categories: 瞎搞
    • 目录配置

      title: hexo+github创建个人博客--深入篇
      toc: true
    • 内容截断

      • 主题配置文件中配置截断显示的文字,excerpt_link: more ,此处显示为more
      • 在文章中键入该注释,即可在该位置生效:
        <!-- more -->
    • 相册功能(待实现)


  • github同步本地博客

    1.提交

    • 在本地配置好个人博客,发布使用后,为防止电脑更换或突发事件导致电脑文件丢失,可以讲博客项目上传至github上保存,需要时再更新到本地即可(此时我们提交的分支为修改后的默认分支–hexo,详细介绍请看hexo+github创建个人博客–基础篇中的仓库设计),提交命令为:

      git add .       //将文件加入到提交缓存
      git commit -m "comment" //添加文件注释
      git push origin hexo //提交到某分支
    • 提交以后会发现主题文件没有提交上去,是因为此时的主题文件是另一个仓库的git文件,需要将本地主题文件中的.git文件夹删掉,再次提交即可


    2.更新

    • 在本地项目中运行命令:

      git pull    //更新到本地
      git status //查看文件对比后的状态
    • 首次更新代码需要执行以下命令(注意不要执行hexo init命令):

      git clone  xxx  //复制github仓库路径
      npm install hexo //安装插件
      npm install hexo-deployer-git //发布到git上时必要的插件

  • 其他功能配置

    1.七牛云图床(供博客图床使用,可选择性进行)

    • 七牛云介绍

    挺好的一个云服务网站,注册后可以免费领取10G免费空间等等,可以将博客中需要使用的图片上传到注册的服务器上,可以加快图片的加载速度,至少比在github上的速度快很多。

    • 七牛云账号创建和设置

    进入七牛云官网注册,按照流程进行,登陆后选择对象存储,此时可以选择绑定域名(需要已备案),在内容管理中可以上传图片,复制图片的链接即可在再网页上访问

    2.评论功能

    • 第三方的评论插件有很多种,具体介绍可以参考wiki,根据自己的情况选择

    • yilia主题中已经集成了duoshuo,畅言,网易云跟帖,disqus这几款评论插件,按照提示修改配置文件即可

    • 鉴于此时还没有备案的域名,所以提供另外一个评论插件的配置-来必力,有备案域名的朋友可以考虑畅言

      1. 进入来必力,注册,登陆,点击右上角选择管理页面

      2. 选择生成一个city版本的评论系统,绑定自己的域名,填写必要信息,最后会生成一份JS代码

      livere-js

      1. 在博客项目的…\themes\yilia\layout\_partial\post目录下新建livere.ejs文件,将此段代码copy进去,为了方便灵活的管理,进行如下修改:

        data-uid="<%=theme.livere_uid%>" //将此处的ID配置在主题配置文件中
      2. 在主题配置文件中加入:

        livere: true    //开启或关闭
        livere-uid: 'your-livere-uid'
      3. 最后需要将创建的livere.ejs文件引入到文章中,打开…\themes\yilia\layout\_partial\article.ejs文件,在以下位置插入如下代码:

        <% if (!index && post.comments){ %>
        <% if (theme.livere && theme.livere_uid){ %>
        <%- partial('post/livere', {
        key: post.slug,
        title: post.title,
        url: config.url+url_for(post.path)
        }) %>
        <% } %>
        <% } %>
      4. 生成发布查看效果即可,之后可以通过来必力对评论进行管理,并且可以设置邮箱提醒功能

      5. 可以通过在文章md文件中通过comments: false 来关闭某篇文章的评论功能


    3.统计功能

    • yilia主题中集成了google_analytics和baidu_analytics的统计功能,选择一种进行注册,绑定域名即可,但是页面不会有显示的效果,此处,我集成了一个第三方统计插件-不蒜子,按照官网提示操作步骤进行即可,详细如下:

      1. 打开\themes\yilia\layout\_partial目录下的footer.ejs文件,首先最最后copy以下一行代码:

        <script async src="//dn-lbstatics.qbox.me/busuanzi/2.3/busuanzi.pure.mini.js"></script>
      2. 此处为了方便灵活管理,可以通过配置文件控制显示,选择合适的位置(我选择加在footer.ejs中),可以加入如下配置:

        <div class="footer-left">
        &copy; <%= date(new Date(), 'YYYY') %> <%= config.author || config.title %>
        <% if (theme.site_count){ %>
        <span id="busuanzi_container_site_pv">本站被踩过<span id="busuanzi_value_site_pv"></span></span>
        <% } %>
        <% if (theme.user_count){ %>
        <span id="busuanzi_container_site_uv"><span id="busuanzi_value_site_uv"></span>人踩过</span>
        <% } %>
        </div>
      3. 预览效果为:

        count-2

      4. 在文章标题后面显示文章的访问量,在\themes\yilia\layout\_partial下的article.ejs中的以下位置加入:

        <header class="article-header">
        <%- partial('post/title', {class_name: 'article-title'}) %>
        <% if (theme.page_count && !index){ %>
        </br>
        <a class="article-count-a-tag" href="javascript:void(0);">
        <span class="icon-sort"></span>
        <span id="busuanzi_container_page_pv" class="article-count-a-span">
        被偷看了:<span id="busuanzi_value_page_pv"></span>
        </span>
        </a>
        <% } %>
        <% if (!post.noDate){ %>
        <%- partial('post/date', {class_name: 'archive-article-date', date_format: null}) %>
        <% } %>
        </header>
      5. 此处有一个小细节就是判断条件中加入 !index 判断条件,在主页时不显示,点击进入某文章时才显示统计的效果,最后还需要在…\themes\yilia\source的main.css中加入自定义的class,我定义的为:

        .article-count-a-tag{color:gray;font-size:14px;} 
        .article-count-a-span{color:#ef7522;font-size:14px;}
      6. 最终效果为:

        count-1


    (未完待续 ……)


本文作者: little-dragon
个人博客: http://littledragon.cn
版权声明: 原创文章,有问题请评论中留言。非商业转载请注明作者及出处。

智能推荐

注意!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系我们删除。



 
© 2014-2019 ITdaan.com 粤ICP备14056181号  

赞助商广告