拉取主题包

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

启动主题

theme: butterfly根本配置

根本配置紧张是设置网站的标题、描述、SEO、菜单等项,下面我就列出 hexo 的 config(根目录下_config.yml),和主题 Butterfly 的 config(themes 的 Butterfly 下_config.yml),并注释干系项的简介仅供参考。

hexo_config.yml

hexo实战二小我自力博客豪华装修合集

hexo_butterfly_config.yml

创建菜单页面

页面包括标签页(tags)、分类页(categories)、友链页(link)、关于页(about),当然也可以自行添加,比如音乐电影之类。
不过添加这种页面办法都大同小异,以下以标签页举例。

运行命令

hexo new page tags

编辑 MD

运行命令后,会在 source 下根据 butterfly 模板天生对应的 md 文件,tags 便是 tags,不过要将 md 文件的 type 修正为对应的类型,类型见上。

title: 标签页date: 2024-05-02 21:01:24type: "tags"

Page(页面)front-matter

title: 页面名称date: 创建日期type: (tags,link,categories这三个页面须要配置)comments: (是否须要显示评论,默认true)description: 用于SEO优化top_img: (设置顶部图)mathjax: (数学公式显示是否支持)katex: (Tex公式显示是否支持)创建文章

写文章,可以通过命令创建,也可以在 source/_posts 目录下,自行新建 markedown 文件,由于命令也是在_posts 文件夹下新建。

运行命令

hexo new "文章的大标题"

Post(文章)front-matter

title: CentOS7下Tomcat启动慢的缘故原由及办理方案date: 2017-12-02 21:01:24description:文章描述,用于做SEO优化的keywords: 文章SEO关键词top_img: 文章顶部图cover: 文章缩略图(封面图)toc: true (是否显示文章目录)toc_number: true (是否显示文章目录的标识数字)copyright: true (是否显示版权)mathjax: (数学公式显示是否支持)katex: (Tex公式显示是否支持)hide: false (是否隐蔽当前文章)comments: true #是否可评论toc: true #是否显示文章目录categories: "云做事器" #分类tags: #标签 - centOS - tomcat站内搜索添加

站内搜索,我是采取的 hexo-generator-search 插件办理方案,安装完插件,然后配置一下,末了用 hexo 清理再天生一下全站静态,同时在根目录也会天生一个 search.xml,用于做字符串模糊匹配的。

插件安装

npm install hexo-generator-search --save

添加或配置

-config(hexo配置)search: path: search.xml field: post format: html limit: 10000-butterfly-config(butterfly主题配置)local_search: enable: true preload: false CDN:

清理与天生

hexo clean && hexo g

评论系统添加

第三方评论系统我这里利用的是 Gitalk ,Gitalk 是一个基于 GitHub Issue 和 Preact 开拓的评论插件。
利用 GitHub 上岸,能支持多国措辞,至于他的事理,其他博主有先容。
这里就不展开了,如果有韶光往后可能会整体先容一下常用的第三方评论系统,由于我还是希望评论能支持多种办法上岸的,目前没有找到得当的就先选择 Gitalk。

注册运用账号

获取参数

注册成功后拿到 “Client ID” 和 “Client secrets”(点击天生再复制),个中把稳的是 Homepage URL 要设置为 用户名.github.io 精确到 https 的地址。
Authorization callback URL 填写注册的域名,如果绑定了个性化域名就填自己的域名,也是要精确到 https 的位置。

修正 Butterfly 配置

打开 butterfly 主题的配置文件,第一个找到 “gitalk” 项,将上面复制的 client id 和 client secrets 粘贴。

第二个找到 “comments”,将 use 配置为 "gitalk",当然也可以用 valine、Disqus 之类的第三方评论系统。

comments: use: # 利用的第三方评论系统名称 text: true # 是否在按钮旁显示评论名称 # If you set it to true, the comment count will be invalid lazyload: false # 是否设置评论窗为

进入仓库,点击 “Settings”,找到 “Features”, 将 “Issues” 勾选。

文章置顶功能添加

打开 hexo 配置文件 _config.yml,如果前面有 per_page 的关闭,利用的是 hexo-generator-index 插件排序,可以自定义序号和日期排序。

如何要置顶文章,只需在文章 md 的 front-matter 里添加一个 top 参数,数值自定。
文章列表会涌现一个钉子图标,要看到效果则要 hexo 先清理再天生。

添加配置

index_generator: path: '' per_page: 5 # 每页条数 order_by: top: -1 # 置顶: -1.倒序 1.顺序 date: -1 # 日期: -1.倒序 1.顺序

md 文章设置

清理与天生

hexo clean && hexo g

RSS 配置

对付 RSS 输出功能,须要安装 hexo-generator-feed 插件。
末了利用 hexo 清理再天生,博客根目录就会天生 atom.xml

插件安装

npm install hexo-generator-feed --save

添加配置

feed: type: atom path: atom.xml limit: 20

设置 RSS 地址

rss: /atom.xml设置 404 页面

在 hexo 的_config.yml 找到或添加 error_404,设置开启,分别添加标题和背景图。

error_404: enable: true subtitle: 'Page Not Found' background: /img/404.jpg

添加百度统计

先上岸或注册百度统计平台,找到 “利用设置” -> “代码获取” -> “新版统计代码获取”,然后会看到一段 js 代码,只须要复制如下的一个 32 位长度的字符串。
末了将该字符串粘贴到 butterfly 的 config.yml 中的 baidu_analytics 中,支配后一天就可以在后台查看统计报表了。

MarketDown 用法

关于新建的文章,我希望本地能备份一份,有 md 文件和图片,方便上传到其他平台博客。
那要怎么做呢,这里我用一个免费的 md 工具 ——Typora 为例。

创建文件和文件夹

创建一个以文章标题的文件夹,里面再分别创建一 img 文件夹和同文章标题的 md 文件,img 下再创建一个与文章标题同名的文件夹。

Typora 设置

依次找到 “文件” -> “偏好设置” -> "图像" , 将插入图片时的下拉选中 “复制到指定路径”,填入下面的值。

./img/${filename}/

第二步找到 “格式” -> "图像" -> “设置图片根目录”,选择 markdown 文件同级的目录,末了复制图片时就会复制到 img 下的文章同名目录下。

为什么要这样设置?由于 Hexo 的图片在打包前都是在主题包 /source/img 里,而为了方便本地能按文章存储,也方便将本地的文章图片直接丢到 img 下,然后 md 文件放到_post 中。
打包之后就能以仓库图片展示,而且按文章分类存储,往后删除起来也一览无余。

写在末了

这次的优化看起来彷佛是面面俱到了,但实在关于 Hexo 主题还有更细节的处理。
比如可以添加博客看板精灵,酷炫的动态大背景,还有鼠标跟随或点击殊效等等。
但是我这博客目前定位紧张以内容为主,以是暂时就就演示了,当然,如果有用户喜好也可以立时加上去的。

末了呢,便是三部曲的第二篇结束了,那下次就自然地要开始进入 Hexo 章末了一篇。
现在是操持先容一下怎么让博客被各大搜索引擎收录,以及一些推广心得等等。
详细的详细内容未定,更新韶光也还不知道,由于在等我那个小游戏的软著下来,下来后我一定要好好写一篇软著申请避坑的文章,可实在是太难等了!

(我是一个持续摸索个人副业的普通程序员,关注我,和你一起探索更多可能。
——ZERO 开拓)