欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

mac 搭建基于Hexo-Github的Blog

程序员文章站 2022-03-06 17:38:39
...
  • GitHubPages + Hexo:免费,使用简单,使用者众多

博客搭建

  1. 创建 GitHub 仓库
    mac 搭建基于Hexo-Github的Blog
  • 注意 Respository name 中一定要输入:你的用户名.github.io其他地方不用修改,然后直接点 ”Create repository“ 按钮完成创建即可
  1. 安装博客需要的框架
  • 安装 Homebrew
    $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • 查询Homebrew是否安装成功的命令
    $ brew -v
  • 安装 git
    $ brew install git
  • 查询git是否安装成功的命令
    $ git –version
  • 安装 node.js
    $ brew install node
  • 查询node是否安装成功的命令
    $ node -v
  • 安装 hexo
    $ npm install -g hexo
  • 查询hexo是否安装成功的命令
    $ hexo -v
  1. 安装博客相关插件
  • 自动部署到Github上的插件
    $ npm install hexo-deployer-git --save
  • 安装atom生成插件,便于感兴趣的小伙伴们订阅(RSS订阅)
    $ npm install hexo-generator-feed --save
    然后在本地Blog根目录下的_config.yml文件中,添加以下配置
# Extensions
## Plugins: http://hexo.io/plugins/
#RSS订阅
plugin: -hexo-generator-feed
#Feed Atom
feed:
     type: atom
     path: atom.xml
     limit: 20

在主题目录下的_config.yml目录下,添加如下配置
rss: /atom.xml

  • 安装博客首页生成插件
    $ npm install hexo-generator-index --save
  • 安装tag生成插件
    $ npm install hexo-generator-tag --save
    到此为止,安装完毕
  1. 创建博客、调试、发布
  • 创建本地一个目录,用来创建博客
    $ hexo init Blog
    执行成功后,会创建出一个名为Blog的文件夹
  • 撰写博客内容
    cd到Blog文件夹下,执行命令
    $ hexo new firstBlog
    在Blog/source/_posts中就会新建一个firstBlog.md的文件,然后你就可以编辑你的博客内容了,Visual Studio Code编辑器支持预览,还可以和印象笔记同步
  • 本地调试
    $ sudo hexo server 或 $ sudo hexo s
    然后可以访问http://localhost:4000来查看结果
  • 安装发布插件
    在博客文件夹运行下面命令
    $ npm install hexo-deployer-git --save
    然后在_config.yml文件修改发布的配置,最后一行改为(注意替换yourusername)
# Site
title: 博客的名字
subtitle: 博客副标题
description: 博客描述
author: 博客作者
language: zh-Hans
theme: next //安装的主题名称
deploy:
  type: git  //使用Git 发布
  repo: https://github.com/yourusername/yourusername.github.com.git  //自己的Github仓库地址
  branch: master
  • 运行生成发布
$ sudo hexo g
$ sudo hexo d
  • 如果改动了站点的源码,需要在发布之前
    $ sudo hexo clean
  • 如果成功了就可以通过yourusername.github.com或者yourusername.github.io来访问你的博客了
  1. 配置博客分类内容
  • 新增资源分类页面
hexo new page about
INFO  Created: ~/blog/source/about/index.md
// 打开修改为如下
---
title: about
date: 2016-09-17 13:21:20
tags: 代码库        // 标签
comment: false   // 添加这行关闭评论
---
here is something about me
  • 新添加的菜单需要翻译对应的中文
    打开\themes\next\languages文件夹,创建主站配置语言的对应文件,如:zh-Hans.yml
  1. 自定义博客
  • 更换主题
    如果你对默认的主题不满意,可以通过克隆的方式,把别人的主题克隆到项目"/themes"路径下,喵神的主题在这里,Hexo也有更多主题,比如使用这一套
    git clone https://github.com/iissnan/hexo-theme-next.git themes/next
    然后在blog/themes文件夹下,会看到一个next文件夹,在next中有一个_config.yml文件,它就是主题配置文件,这里略过设置详情;要设置博客主题的话,还是要回到根目录下(Blog文件夹下)的_config.yml文件中,将theme属性由landscape修改为next,还有注意配置的键值之间一定要有空格更多设置
    修改并保存之后,我们再执行命令
$ hexo g
$ hexo d

执行完毕以后,就可以在本地或者git上看到博客的新主题了,更多的主题可以参考知乎

  • 设置网页浏览次数
    打开themes/你的主题/layout/_partial/footer.ejs添加即可
# 脚本
<script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>

# 标签
# pv的方式,单个用户连续点击n篇文章,记录n次访问量
<span id="busuanzi_container_site_pv">
    本站总访问量<span id="busuanzi_value_site_pv"></span>次
</span>
# uv的方式,单个用户连续点击n篇文章,只记录1次访客数
<span id="busuanzi_container_site_uv">
 	总访客数<span id="busuanzi_value_site_uv"></span>人
</span>

mac 搭建基于Hexo-Github的Blog

  • 评论功能
    使用韩国来必力评论,需要注册账号详见官网
    在主题配置文件下添加
    page_comment: true
    \themes\random\layout\_partial文件夹中新建livere.ejs文件并添加如下代码
<section class="livere" id="comments">
    <!-- 来必力City版安装代码 -->
    <div id="lv-container" data-id="city" data-uid="MTAyM***注册成功官方返回的uid****xNzkwMw==">
      <script type="text/javascript">
       (function(d, s) {
           var j, e = d.getElementsByTagName(s)[0];

           if (typeof LivereTower === 'function') { return; }

           j = d.createElement(s);
           j.src = 'https://cdn-city.livere.com/js/embed.dist.js';
           j.async = true;

           e.parentNode.insertBefore(j, e);
       })(document, 'script');
      </script>
    <noscript> 为正常使用来必力评论功能请**JavaScript</noscript>
    </div>
    <!-- City版安装代码已完成 -->
</section>

mac 搭建基于Hexo-Github的Blog
\themes\random\layout\post.ejs文件中添加或修改如下代码

<% if (page.comment || theme.page_comment) { %>
  <%- partial('_partial/livere',{}) %>
<% } %>
  • 顶部加载条
    \themes\random\layout\_partial head.swig或head.ejs文件中添加如下代码
<script src="//cdn.bootcss.com/pace/1.0.2/pace.min.js"></script>
<link href="//cdn.bootcss.com/pace/1.0.2/themes/pink/pace-theme-flash.css" rel="stylesheet">
  <style>
      .pace .pace-progress {
          background: #1E92FB; /*进度条颜色*/
          height: 3px;
      }
      .pace .pace-progress-inner {
           box-shadow: 0 0 10px #1E92FB, 0 0 5px     #1E92FB; /*阴影颜色*/
      }
      .pace .pace-activity {
          border-top-color: #1E92FB;    /*上边框颜色*/
          border-left-color: #1E92FB;    /*左边框颜色*/
      }
  </style>

mac 搭建基于Hexo-Github的Blog

  • 安全运行天数
    \themes\random\layout\_partial footer.swig或footer.ejs页脚部分添加如下代码
# 标签
<span id="timeDate">载入天数...</span><span id="times">载入时分秒...</span>
# 脚本
<script>
    var now = new Date(); 
    function createtime() { 
        var grt= new Date("07/08/2018 12:00:00");//此处修改你的建站时间或者网站上线时间 
        now.setTime(now.getTime()+250); 
        days = (now - grt ) / 1000 / 60 / 60 / 24; dnum = Math.floor(days); 
        hours = (now - grt ) / 1000 / 60 / 60 - (24 * dnum); hnum = Math.floor(hours); 
        if(String(hnum).length ==1 ){hnum = "0" + hnum;} minutes = (now - grt ) / 1000 /60 - (24 * 60 * dnum) - (60 * hnum); 
        mnum = Math.floor(minutes); if(String(mnum).length ==1 ){mnum = "0" + mnum;} 
        seconds = (now - grt ) / 1000 - (24 * 60 * 60 * dnum) - (60 * 60 * hnum) - (60 * mnum); 
        snum = Math.round(seconds); if(String(snum).length ==1 ){snum = "0" + snum;} 
        document.getElementById("timeDate").innerHTML = "本站已安全运行 "+dnum+" 天 "; 
        document.getElementById("times").innerHTML = hnum + " 小时 " + mnum + " 分 " + snum + " 秒"; 
    } 
    setInterval("createtime()",250);
</script>

mac 搭建基于Hexo-Github的Blog

  • 在每篇文章末尾统一添加“本文结束”标记
    接着打开\themes\vno\layout\post.ejs文件,在post-body之后, post-footer之前添加如下代码
<div>
    <div style="text-align:center;color: #ccc;font-size:14px;">-------------本文结束<i class="fa fa-paw"></i>感谢您的阅读-------------</div>
</div>  
  • 添加打赏功能,使用iframe嵌入打赏
    把下面代码添加到你想要的位置,一般是在<article>标签内,如\themes\vno\layout\post.ejs
    标签内
    mac 搭建基于Hexo-Github的Blog
    <iframe src="https://gsl201600.github.io/RewardCode" style="overflow-x:hidden;overflow-y:hidden; border:0xp none #fff; min-height:240px; width:100%;" frameborder="0" scrolling="no" allowtransparency="true"></iframe>
    把该项目添加到你的网站,修改相关参数为你的打赏码,即可实现项目地址
  • 在Hexo博客上添加可爱的Live 2D模型
    安装npm包
    $ npm install --save hexo-helper-live2d
    然后在Blog的配置文件_config.yml中添加如下配置,详细配置可以参考文档
live2d:
  enable: true
  scriptFrom: local
  pluginRootPath: live2dw/
  pluginJsPath: lib/
  pluginModelPath: assets/
  tagMode: false
  debug: false
  model:
    use: live2d-widget-model-shizuku
  display:
    position: right
    width: 150
    height: 300
  mobile:
    show: true

然后下载模型,模型名称可以到这里参考,一些模型的预览可以在这里
$ npm install live2d-widget-model-shizuku
下载完之后,在Blog根目录中新建文件夹live2d_models,然后在node_modules文件夹中找到刚刚下载的live2d模型,将其复制到live2d_models中,然后编辑配置文件中的model.use项,将其修改为live2d_models文件夹中的模型文件夹名称
一切就绪之后,用hexo server命令启动服务器,稍等一下就可以看到右下角出现了一个可爱的萌萌哒的妹纸!不过因为所有东西都在Github上托管的原因,可能Live2D不能马上加载出来

  • Hexo操作指令一览
$ hexo clean      #清理缓存
$ hexo generate   #生成静态文件
$ hexo server     #启动本地服务器
$ hexo deploy    #部署
或者
$ hexo clean      #清理缓存
$ hexo g          #生成静态文件
$ hexo s          #启动本地服务器
$ hexo d         #部署
  • homebrew操作指令一览
// 安装 homebrew
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
// 卸载 homebrew
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"
// 查看版本
$ brew -v
// 下载软件:brew install 软件名
如:$ brew install htop, 安装htop
// 如需要图形安装的软件 要加cask
如:$ brew cask install google-chrome
// 卸载软件:brew uninstall 软件名
如: $ brew cask uninstall google-chrome
// 软件搜索:brew search 软件名
如: $ brew search google
// 列出已安装的包
$ brew list
// 查看软件相关信息:brew info 软件名
如:$ brew info google-chrome
// 删除 Homebrew下载的包
$ brew cleanup
// 更新 Homebrew
$ brew update
  • 附:给Hexo搭建的博客增加百度和谷歌的搜索引擎验证
  1. 验证站点
    搜索引擎验证的方法有好几种,下面选择 HTML标签验证 验证方法,其他的方法有兴趣可以自己去试一下
  • 首先打开 百度搜索引擎验证 ,点击 添加网站 ,输入自己的 博客 地址
  • 输完后选择 HTML标签验证 ,然后将下方的 meta 代码复制下来,网页先不要关
    mac 搭建基于Hexo-Github的Blog
  • 重新开一个页面,打开谷歌搜索引擎验证,点击添加属性,一样输入自己的博客地址
  • 输完后选择备用方法下的HTML 标记,然后将下方的meta代码复制下来,网页也不要关
    mac 搭建基于Hexo-Github的Blog
  • 打开本地博客主题下的layout/_partial 文件夹,有一个名为head的文件,使用HTML编辑器打开,将刚才复制的两句meta代码粘贴进去
  • 保存文件后,输入以下命令将博客重新部署到GitHub服务器
    hexo clean && hexo g && hexo d
  • 然后分别点击刚才百度、谷歌验证页面的验证按钮进行站点验证
  1. 生成站点地图
  • 打开终端cd到本地博客目录下,输入以下命令安装sitmap插件
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save
  • 打开本地博客目录下的_config.yml文件,修改url参数为你博客的首页地址,这样是为了保证能正确生成sitemap.xml文件中的地址
url: http://jonzzs.cn # 修改成你博客的首页地址
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:
  • 添加以下配置
# 自动生成sitemap
sitemap: 
  path: sitemap.xml
baidusitemap: 
  path: baidusitemap.xml
  • 输入以下命令重新部署博客
    hexo clean && hexo g && hexo d
  1. 将站点地图提交谷歌
  • 打开谷歌站点控制台进入站点控制台,先点击测试站点地图,测试通过后再点击提交站点地图
    mac 搭建基于Hexo-Github的Blog
  • 百度主动推送
    首先,在Hexo根目录下,安装本插件:$ npm install hexo-baidu-url-submit --save
    然后,同样在根目录下,把以下内容配置到_config.yml文件中:
baidu_url_submit:
  count: 3 ## 提交最新的3个链接
  host: www.hui-wang.info ## 在百度站长平台中注册的域名
  token: your_token ## 请注意这是您的秘钥, 所以请不要把博客源代码发布在公众仓库里!
  path: baidu_urls.txt ## 文本文档的地址, 新链接会保存在此文本文档里

其次,记得查看_config.ym文件中url的值, 必须包含是百度站长平台注册的域名,比如:

# URL
url: http://www.hui-wang.info
root: /
permalink: :year/:month/:day/:title/

最后,加入新的deployer:

deploy:
- type: git ## 这是原来的deployer
  repo: https://github.com/yourusername/yourusername.github.com.git  //自己的Github仓库地址
  branch: master
- type: baidu_url_submitter ## 这是新加的

执行hexo deploy的时候,新的连接就会被推送了

  • 百度自动推送
    安装自动推送JS代码的网页,在页面被访问时,页面URL将立即被推送给百度,修改主题目录下的layout/post.swig文件,末尾添加自动推送代码,代码如下
<script>
(function(){
    var bp = document.createElement('script');
    var curProtocol = window.location.protocol.split(':')[0];
    if (curProtocol === 'https') {
        bp.src = 'https://zz.bdstatic.com/linksubmit/push.js';        
    }
    else {
        bp.src = 'http://push.zhanzhang.baidu.com/push.js';
    }
    var s = document.getElementsByTagName("script")[0];
    s.parentNode.insertBefore(bp, s);
})();
</script>
  1. site:域名测试是否成功

附:我的博客地址

相关标签: iOS