安装

  • 先安装node 和 git
  • 在git bash下安装Hexo 
    1
    npm install hexo-cli -g
  • 将hexo的node_modules文件夹添加环境变量
  • 进入一个空文件夹
  • 初始化hexo 
    1
    hexo init
  • 安装npm依赖 
    1
    npm install
  • 生成静态页面 
    1
    hexo generate

命令

命令 描述
hexo generate 生成静态页面
hexo server 本地预览 调试
hexo deploy 部署
hexo clean 清除缓存

发布

  • hexo clean
  • hexo generate
  • hexo deploy
  • md文档在source/_posts中
  • 在服务器环境需要加-g
  • md文件中的设置冒号后要加空格 否则会生成出错
  • <!--more--> 截断文章，不显示往下的内容

遇到的坑

hexo-admin插件的deploy报错 error:spawn UNKNOWN

在modules文件夹中的deploy.js中修改源代码如下

1
var proc = spawn((process.platform === "win32" ? "hexo.cmd" : "hexo"), ['d', '-g']);

busuanzi插件一直不显示，通过调试台发现几个span的display属性一直为none

尝试将busuanzi.counter.swig下的display删除还是没用

最终解决方案，在layout/_partials/footer.swig中插入以下代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<div class="busuanzi-count">
    <script async="" src="https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>
    <span class="site-uv">
      <i class="fa fa-user"></i>
      访问用户： <span class="busuanzi-value" id="busuanzi_value_site_uv"></span> 人
    </span>
    <div class="powered-by"></div>
    <br/>
    <span class="site-uv">
      <i class="fa fa-eye"></i>
      访问次数： <span class="busuanzi-value" id="busuanzi_value_site_pv"></span> 次
    </span>
    <br/>
    <span class="site-pv">
      <i class="fa fa-pencil"></i>
      全站共： <span class="post-count">{{ totalcount(site) }}</span> 字
    </span>
</div>

自定义page文件夹下的默认index.md文件删掉 替换成index.html 直接在里面写结构就行了

自定义样式表

_custom.styl已经废弃

新的解决方法：

在配置文件里的custom_file_path下可以自定义样式表目录

live2d

安装

1
npm install --save hexo-helper-live2d

配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
live2d:
  enable: true
  scriptFrom: local
  pluginRootPath: live2dw/
  pluginJsPath: lib/
  pluginModelPath: assets/
  tagMode: false
  debug: false
  model:
    use: live2d-widget-model-wanko
  display:
    position: right
    width: 150
    height: 300
  mobile:
    show: true
  react:
    opacity: 0.7

安装模型

1
npm install live2d-widget-model-shizuku
  • 根目录下创建一个 live2d_models 文件夹.
  • 将 Live2D 模型复制到文件夹中.
  • 将子文件夹的名称输入 _config.yml 的 model.use 中

在右上角实现fork me on github

next/layout/_layout.swig文件中

1
<div class="headband"></div>

在之后插入一下代码

1
<a href="https://your-url" class="github-corner" aria-label="View source on GitHub"><svg width="80" height="80" viewBox="0 0 250 250" style="fill:#fff; color:#151513; position: absolute; top: 0; border: 0; right: 0;" aria-hidden="true"><path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path><path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path><path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"></path></svg></a><style>.github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}</style>