mac 搭建基于Hexo-Github的Blog
程序员文章站
2022-03-06 17:38:39
...
- GitHubPages + Hexo:免费,使用简单,使用者众多
博客搭建
-
创建 GitHub 仓库
- 注意 Respository name 中一定要输入:
你的用户名.github.io
其他地方不用修改,然后直接点 ”Create repository“ 按钮完成创建即可
- 安装博客需要的框架
- 安装 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
- 安装博客相关插件
- 自动部署到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
到此为止,安装完毕
- 创建博客、调试、发布
- 创建本地一个目录,用来创建博客
$ 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
来访问你的博客了
- 配置博客分类内容
- 新增资源分类页面
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
- 自定义博客
- 更换主题
如果你对默认的主题不满意,可以通过克隆的方式,把别人的主题克隆到项目"/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>
- 评论功能
使用韩国来必力评论,需要注册账号详见官网
在主题配置文件下添加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>
在\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>
- 安全运行天数
在\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>
- 在每篇文章末尾统一添加“本文结束”标记
接着打开\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
的标签内 <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搭建的博客增加百度和谷歌的搜索引擎验证
- 验证站点
搜索引擎验证的方法有好几种,下面选择HTML标签验证
验证方法,其他的方法有兴趣可以自己去试一下
- 首先打开 百度搜索引擎验证 ,点击
添加网站
,输入自己的博客
地址 - 输完后选择
HTML标签验证
,然后将下方的meta
代码复制下来,网页先不要关
- 重新开一个页面,打开谷歌搜索引擎验证,点击
添加属性
,一样输入自己的博客
地址 - 输完后选择
备用方法
下的HTML 标记
,然后将下方的meta
代码复制下来,网页也不要关
- 打开本地博客主题下的layout/_partial 文件夹,有一个名为head的文件,使用HTML编辑器打开,将刚才复制的两句meta代码粘贴进去
- 保存文件后,输入以下命令将博客重新部署到GitHub服务器
hexo clean && hexo g && hexo d
- 然后分别点击刚才百度、谷歌验证页面的验证按钮进行站点验证
- 生成站点地图
- 打开终端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
- 将站点地图提交谷歌
- 打开谷歌站点控制台进入站点控制台,先点击
测试
站点地图,测试通过后再点击提交
站点地图
- 百度主动推送
首先,在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>
- 用
site:域名
测试是否成功
上一篇: iOS组件化(一):创建本地私有库
下一篇: 总结提高百度权重最有影响力的四大点
推荐阅读
-
Linux基于php-fpm模式的lamp搭建phpmyadmin的方法
-
创建基于ASP.NET core 3.1 的RazorPagesMovie项目(三)-已搭建基架的Razor页面解释和更新
-
在Ubuntu上搭建一个基于webrtc的多人视频聊天服务实例代码详解
-
给Python的Django框架下搭建的BLOG添加RSS功能的教程
-
用Mac在CoreOS上搭建WordPress的教程
-
基于webpack4搭建的react项目框架的方法
-
一行代码在Linux服务器上搭建基于.Net Core的博客
-
Centos 6.5环境实现本地局域网搭建YUM的方法【基于HTTP】
-
详解基于Centos7+Nginx+Tomcat8的负载均衡服务器的搭建
-
基于Prometheus和Grafana的监控平台 - 环境搭建