启程
触发
-->原来用 jekll 新建的博客,但是不满意:
- 没有目录
- 发布不方便,标签系统
- 更换主题十分不便
- 另有原因:弃Jekyll投Hexo
-->基于美观的强迫症,重新搭建 hexo 博客,主要参考:
- 俊宇的搭建指南
- Create and host your blog for free with hexo & Github
- 开始使用 - NexT 使用文档
- 如何使用 Hexo 和 GitHub Pages 搭建这个博客 | uchuhimo's blog
基本信息
- 终端的使用
- git , github 与 github pages 的使用
- Hexo 基本知识
- 安装步骤
- 目录体系与各部分文件作用
创建步骤
1.Git 与 HEXO 本地环境的基本配置
- Hexo
- Requirement
- NODE.js
- mac 用 brew 安装:
brew install NODE.js
- node/8.2.1
- npm node 的包管理器
- mac 用 brew 安装:
- GIT
- NODE.js
- Install:
npm install -g hexo-cli
- Requirement
2.测试本地环境与初步部署
-
跟随操作即可-->Create and host your blog for free with hexo & Github
-
至此,基本的博客就创建好了.
3.主题更改与配置
- 选定 next 主题
- 参考:
- 说明
- npm 安装所需的插件
- 注册所需的功能的服务商账号
- 站点_config.yml与主题_config.yml的设置
- 跟随使用手册与教材操作即可
问题解决
Q0:npm install -g hexo-cli
安装失败
- 错误信息:
1 | npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@^1.0.0 (node_modules/hexo-cli/node_modules/chokidar/node_modules/fsevents): |
-
搜索:
-
npm install -g hexo-cli failed
issue is with npm version 5+ I rolledback to npm@4.6.1 and was able to install hexo-cli without any issues.
-
-
尝试0:将 npm 版本退回4.6.1
npm install -g npm@4.6.1
- 无效
-
尝试1:
- npm doctor
- npm install -g hexo-cli
- 成功:
- 有可能是网咯的问题,多运行几次继续下载即可
- npm doctor 生效
Q1:Error with DTrace (Mac OS X)
-
错误信息:
Error: Cannot find module './build/Debug/DTraceProviderBindings'
- 该错误不影响博客的正常使用,但是每运行一次 hexo 命令就会跑出来,十分难受.
-
搜索0:直接google错误信息
- 方案0:官方文档
- Troubleshooting | Hexo
- DTrace安装存在问题,因此重新安装简约版
$ npm install hexo --no-optional
- 直接安装或则卸载原来的 hexo
npm uninstall -g hexo-cli
再安装,均无效
- 方案1:github issue
-
Still getting lots of DtraceProviderBindings errors on OS X · Issue #216 · trentm/node-bunyan
1
2npm install -g build essential
npm rebuild -
无效
-
- 方案3:安装 dtrace-provider 模块
- Still getting lots of DtraceProviderBindings errors on OS X · Issue #216 · trentm/node-bunyan
- npm install dtrace-provider
- 无效
- 方案4:OS X EI 系统升级至 10.11.6
- 在 app store 中更新
- 成功解决问题
- 方案0:官方文档
日常操作
-
命令简写
$ hexo new == hexo n $ hexo generate == hexo g $ hexo server == hexo s $ hexo deploy == hexo d
-
初始化
$ hexo init [folder] #初始化目录
-
调试
$ hexo clean #清除缓存 $ hexo g #生产静态文件至 public 目录 $ hexo s --debug #启动本地服务器(调试模式) $ hexo s --draft #本地预览草稿
-
部署
$ hexo clean #清除缓存 $ hexo g #生产静态文件至 public 目录 $ hexo d #项目部署 $ hexo d -g #先生成后部署
-
写作
$ hexo new [layout] <title> # 新建文章 $ hexo new draft <title> # 新建草稿 $ hexo publish <title> # 草稿发布成文章
-
其他
-
首页文章显示摘要,添加在正文之前
1
2<blockquote class="blockquote-center"> 摘要 </blockquote>
<!--more--> -
脚注/上标/下标/缩写
- form: hexo-renderer-markdown-it
<sub>
H2O<sup>
x2<ins>
Inserted- Footnotes
^[1]
- form: hexo-renderer-markdown-it
TimeLog
- 170708 NBR-hugh publish
- 170707 NBR-hugh init