【博客搭建2】Sakura主题的配置

提示：该文章适合纯新手，效果可进入我的博客bigdataxy.cc进行查看。

---

Hexo有许多的个性化主题可供选择，可通过Hexo官网Themes | Hexo进行查看，我的个人博客是使用的Sakura主题，github地址为honjun/hexo-theme-sakura (github.com)，下面按照我的修改内容进行记录。

主题下载安装

github下载安装包

进入上述github地址，点击 **Download ZIP ** 下载压缩包，压缩包里面就已经配置好了很多source内容，为后面省去很多麻烦。

下载好之后解压到博客根目录（此时会有提示有重复文件，点击替换文件）。接着在cmd中运行nmp i安装依赖。

相关文件介绍

该部分主要简单介绍各文件的作用，方便在对应位置进行修改，知道后会对该主题结构更加清晰，同时方便站点维护，也可以跳过该部分，直接按照之后的步骤进行操作即可。

• languages 这个文件夹中存放的是语言文件，主要是博客中的一些字符以简体中文、繁体中文、英文显示的定义。

• layout 这个是布局文件夹，所有的博客页面HTML和JavaScript以ejs模板存放在这，

  • Search 这里存放的是页内搜索的ejs文件
  • _partial 这里的和 _widget 都是公共的页面，可以引入到HTML的任意位置

• source 这个文件夹和博客根目录下的source文件夹是一样的，都是为了存放主题相关的文件

  • css 这里存放css文件
  • fonts 字体文件
  • images 图片
  • js js文件

• _config.yml文件，主题配置文件。

CDN搭建

国内加载github的资源比较慢，需要使用CDN加速来优化网站打开速度，于是使用jsDeliver+github搭建免费的cdn。jsDelivr 是一个免费开源的 CDN 解决方案，用于帮助开发者和站长。包含 JavaScript 库、jQuery 插件、CSS 框架、字体等等 Web 上常用的静态资源。

这里可以理解为，在github创建一个素材库，可以存放图片，视频，音乐等资源，对存放的资源可以直接通过链接进行访问，这里借助jsDeliver加速素材的访问。之后站点各模块的头像、背景以及文章内容图片均会运用该方式进行访问及存储。

第一步：创建github仓库

第二步：克隆Github仓库到本地

在任意目录创建一个空文件，右键进入Git Bash Here，输入git clone + 仓库连接

之后对仓库会克隆到本地，对cdn进行相关操作，这里的操作为你想建立的一些列路径和加进去的图片。

我这里是这样的。

第三步：上传需要的资源

在进入cdn目录，右键Git Bash Here，对操作好的文件进行提交。

// 查看状态
git status
// 初始化
git init
// 添加到库中（点有空格）
git add .
// 提交更新（引号内 为自定义信息说明）
git commit -m '提交说明'
// 推送至远程仓库 
git push origin main

第四步：发布仓库

点击Draft a new release建立发布版本

进行版本号自定义，版本号是为你最新一次的更新内容做个标签，若你之后再次更新，需要再次更新版本号，之前的版本号同样可以使用，只不过没有新更新的内容。

对于更新内容不多的情况下，可以直接在github进行操作。

第五步：通过jsDeliver引用资源

使用方法：

https://cdn.jsdelivr.net/gh/你的用户名/你的仓库名@发布的版本号/文件路径

例如：

https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.01/img/custom/avatar.jpg

注意：版本号不是必需的，是为了区分新旧资源，如果不适用版本号，将会直接引用最新资源。

文件修改

blog目录下的_config配置

blog目录下的_config.yml文件，对该文件进行如下修改：

• 修改**title: ** 与 author:。
• 将 url的值修改为网站主URl（如：http://xxx.github.io）
• 建议修改permalink，可修改为短连接。安装插件 npm install hexo-abbrlink --save

主题配置文件修改和添加：

 #permalink: :year/:month/:day/:title/ #主题默认文章链接配置
 permalink: post/:abbrlink.html #修改
 
 ## 启用算法生成不重复文件编号，添加
 abbrlink:
 	  alg: crc16   #算法： crc16(default) and crc32
 	  rep: hex   #进制： dec(default) and hex: dec #输出进制：十进制和十六进制，默认为10进制。丨dec为十进制，hex为十六进制

主题目录下的_config配置

其中标明【改】的是需要修改部门，标明【选】是可改可不改（建议不用改），标明【非】是不用改的部分。

# site name
# 站点名，即网站的左上角的名称 【改】
prefixName: さくら荘その
siteName: hojun

# favicon and site master avatar
# 站点的favicon和头像 输入图片路径（下面的配置是都是cdn的相对路径，没有cdn请填写完整路径，建议使用jsdeliver搭建一个cdn啦，先去下载我的cdn替换下图片就行了，简单方便~）【改】
favicon: /images/favicon.ico
avatar: /img/custom/avatar.jpg

# 站点url 【改为自己的博客的网址】
url: https://sakura.hojun.cn

# 站点介绍（或者说是个人签名）【改】
description: Live your life with passion! With some drive!

# 站点cdn，没有就为空 【改】  若是cdn为空，一些图片地址就要填完整地址了，比如之前avatar就要填https://cdn.jsdelivr.net/gh/honjun/cdn@1.6/img/custom/avatar.jpg
cdn: https://cdn.jsdelivr.net/gh/honjun/cdn@1.6

# 开启pjax 【选】
pjax: 1

# 站点首页的公告信息 【改】
notice: hexo-Sakura主题已经开源，目前正在开发中...

# 懒加载的加载中图片 【选】
lazyloadImg: https://cdn.jsdelivr.net/gh/honjun/cdn@1.6/img/loader/orange.progress-bar-stripe-loader.svg

# 站点菜单配置 【选】
menus:
  首页: { path: /, fa: fa-fort-awesome faa-shake }
  归档: { path: /archives, fa: fa-archive faa-shake, submenus: { 
    技术: {path: /categories/技术/, fa: fa-code }, 
    生活: {path: /categories/生活/, fa: fa-file-text-o }, 
    资源: {path: /categories/资源/, fa: fa-cloud-download }, 
    随想: {path: /categories/随想/, fa: fa-commenting-o },
    转载: {path: /categories/转载/, fa: fa-book }
  } }
  清单: { path: javascript:;, fa: fa-list-ul faa-vertical, submenus: { 
    书单: {path: /tags/悦读/, fa: fa-th-list faa-bounce }, 
    番组: {path: /bangumi/, fa: fa-film faa-vertical }, 
    歌单: {path: /music/, fa: fa-headphones },
    图集: {path: /tags/图集/, fa: fa-photo }
  } }
  留言板: { path: /comment/, fa: fa-pencil-square-o faa-tada }
  友人帐: { path: /links/, fa: fa-link faa-shake }
  赞赏: { path: /donate/, fa: fa-heart faa-pulse }
  关于: { path: /, fa: fa-leaf faa-wrench , submenus: { 
    我？: {path: /about/, fa: fa-meetup}, 
    主题: {path: /theme-sakura/, fa: iconfont icon-sakura },
    Lab: {path: /lab/, fa: fa-cogs },
  } }
  客户端: { path: /client/, fa: fa-android faa-vertical }
  RSS: { path: /atom.xml, fa: fa-rss faa-pulse }

# Home page sort type: -1: newer first，1: older first. 【非】
homePageSortType: -1

# Home page article shown number) 【非】
homeArticleShown: 10

# 背景图片 【选】
bgn: 8

# startdash面板 url, title, desc img 【改】
startdash: 
  - {url: /theme-sakura/, title: Sakura, desc: 本站 hexo 主题, img: /img/startdash/sakura.md.png}
  - {url: http://space.bilibili.com/271849279, title: Bilibili, desc: 博主的b站视频, img: /img/startdash/bilibili.jpg}
  - {url: /, title: hojun的万事屋, desc: 技术服务, img: /img/startdash/wangshiwu.jpg}


# your site build time or founded date
# 你的站点建立日期 【改】
siteBuildingTime: 07/17/2018


# 社交按钮(social)  url, img PC端配置 【改】
social:
  github: {url: http://github.com/honjun, img: /img/social/github.png}
  sina: {url: http://weibo.com/mashirozx?is_all=1, img: /img/social/sina.png}
  wangyiyun: {url: http://weibo.com/mashirozx?is_all=1, img: /img/social/wangyiyun.png}
  zhihu: {url: http://weibo.com/mashirozx?is_all=1, img: /img/social/zhihu.png}
  email: {url: http://weibo.com/mashirozx?is_all=1, img: /img/social/email.svg}
  wechat: {url: /#, qrcode: /img/custom/wechat.jpg, img: /img/social/wechat.png}

# 社交按钮(msocial)  url, img 移动端配置 【改】
msocial:
  github: {url: http://github.com/honjun, fa: fa-github, color: 333}
  weibo: {url: http://weibo.com/mashirozx?is_all=1, fa: fa-weibo, color: dd4b39}
  qq: {url: https://wpa.qq.com/msgrd?v=3&uin=954655431&site=qq&menu=yes, fa: fa-qq, color: 25c6fe}

# 赞赏二维码（其中wechatSQ是赞赏单页面的赞赏码图片）【改】
donate:
  alipay: /img/custom/donate/AliPayQR.jpg
  wechat: /img/custom/donate/WeChanQR.jpg
  wechatSQ: /img/custom/donate/WeChanSQ.jpg

# 首页视频地址为https://cdn.jsdelivr.net/gh/honjun/hojun@1.2/Unbroken.mp4，配置如下 【选】
movies:
  url: https://cdn.jsdelivr.net/gh/honjun/hojun@1.2
  # 多个视频用逗号隔开，随机获取。支持的格式目前已知MP4,Flv。其他的可以试下，不保证有用
  name: Unbroken.mp4

# 左下角aplayer播放器配置 主要改id和server这两项，修改详见[aplayer文档] 【选】
aplayer: 
  id: 2660651585
  server: netease
  type: playlist
  fixed: true
  mini: false
  autoplay: false
  loop: all
  order: random
  preload: auto
  volume: 0.7
  mutex: true

# Valine评论配置【选】
valine: flase
v_appId: GyC3NzMvd0hT9Yyd2hYIC0MN-gzGzoHsz
v_appKey: mgOpfzbkHYqU92CV4IDlAUHQ

其他细节修改

模块内容及背景

这里用友人帐举例，在/source/links/index.md进行修改内容及背景图片。其他模块内容及背景图片可在该目录下对应的md文件中修改。

layout: links
title: links
date: 2018-12-19 23:11:06
keywords: 友人帐
description: 
comments: true
photos: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/links.jpg
links:
  - group: 个人项目
    desc: 充分说明这家伙是条咸鱼 < (￣︶￣)>
    items:
    - url: /
      img: https://cloud.moezx.cc/Picture/svg/landscape/fields.svg
      name: Google
      desc: Google 镜像
    - url: /
      img: https://cloud.moezx.cc/Picture/svg/landscape/fields.svg
      name: Google
      desc: Google 镜像
  - group: 小伙伴们
    desc: 欢迎交换友链 ꉂ(ˊᗜˋ)
    items:
    - url: /
      img: https://cloud.moezx.cc/Picture/svg/landscape/fields.svg
      name: Google
      desc: Google 镜像
    - url: /
      img: https://cloud.moezx.cc/Picture/svg/landscape/fields.svg
      name: Google
      desc: Google 镜像

模块背景及布局

友人帐的布局主要在/themes/sakura/layout/links.ejs，其他模块的布局在该目录下的ejs文件中修改。

归档与清单的背景及描述

在 /themes/sakura/language/zh-cn.yml修改：

#category
技术:
    zh: 小肖要进步！~
    en: Geek – Only for Love
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/coding.jpg
生活:
    zh: 生活的本质是当下
    en: life is the most important
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/writing.jpg
转载:
    zh: 站在前辈的肩膀上
    en: Bai piao lalalaaa
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/ziyuan.jpg
资源:
    zh: 快来，有好东西
    en: Bai piao lalalaaa again
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/ziyuan.jpg
随想:
    zh: 一些小心思...
    en: ddd
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/think.jpg

#tag
悦读:
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/reading.jpg

图集:
    img: https://cdn.jsdelivr.net/gh/Bigdata-xy/cdn@1.02/img/banner/photo.jpg    

底部内容修改

在/themes/Sakura/layout_partial中可修改底部显示内容。

关于“我？”对话修改

在/themes/Sakura/source/js中的botui.js进行修改即可。

——上面配置过程中若遇到问题，可查看官方文档，csdn，也可在平台进行私信，看到会及时回复

注：在配置过程中可将要修改的对应文件备份后，进行修改查看各种修改后的效果，若改乱了可使用备份文件还原

---