hexo博客和gitbook配置

Blog blog hexo gitbook

创建时间:2019-10-06 08:36

阅读:

gitbook简介
hexo博客搭建
hexo博客使用
引用

环境：ubuntu16.04

gitbook简介
hexo博客搭建
hexo博客使用
引用

gitbook简介

创作和管理电子书，是目前最流行的开源书籍写作方案
gitbook基于Node.js 开发，需要通过 Node.js 包管理工具 NPM 安装

简单来说Node.js就是运行在服务端的JavaScript
npm 常用命令

npm update <name>   # 更新指定包
npm install npm -g  # 全局更新自己 
npm view <package> version  #查看包版本号

环境配置

nodejs

gitbook

  sudo apt-get install nodejs   # 可能还需要安装nodejs-legacy 这是因为需要node 但是最好直接使用node升级 文章末尾
  sudo apt-get install npm
  sudo npm install gitbook-cli -g   #全局安装
  # 可能需要安装 ebook-convert    Binary install或者Source install
  sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

常用命令

gitbook init    #初始化 生成 README.md SUMMARY.md
gitbook serve   #启动服务 浏览器打开 http://localhost:4000/

定义目录结构

先定义好结构，然后通过gitbook init自动生成目录结构对应的文件夹和Markdown文件

先创建好文件夹和Markdown文件再来编辑目录结构

 # Summary

 * [项目简介](README.md)
 * [快速开始](docs/快速开始.md)
  * [环境搭建](docs/环境搭建.md)
  * [简单使用](docs/简单使用.md)
 * [学入学习](docs/深入学习)

hexo博客搭建

常用命令参考hexo官网

ubuntu 搭建
搭建参考

  sudo apt install nodejs
  sudo apt install npm

  sudo npm install n -g
  sudo n stable

  sudo npm install hexo-cli

windows 搭建
参考windows下Hexo博客搭建过程

由于之前已经在ubuntu配置过github page，所以这里只需要下载安装NodeJs

  // 使用windows powershell可以安装
  npm install -g hexo

  // 使用git的终端进行操作
  hexo init blog  # 初始化, 如果已经有则不需要
  hexo clean
  hexo g
  hexo s
  hexo d

hexo博客使用

博客撰写工具

可以使用markdown语言进行快速编写,参考Markdown
软件可以使用visual studio code结合插件Markdown Preview Enhanced.可以预览公式,可参考知乎文章在 VSCode 下用 Markdown Preview Enhanced 愉快地写文档

引用自己的文章

{% post_link 文章文件名(不要后缀) 文章标题(可选) %}

hexo 本地图片，避免图床

官网有相关说明，hexo图片上传说明

1. 设置站点配置_config.yml: 将post_asset_folder: false改为post_asset_folder: true
2. 执行 npm install hexo-asset-image –save 装插件(或者npm install https://github.com/CodeFalling/hexo-asset-image --save)
3. 执行hexo new [xxxx],生成xxxx.md和xxxx文件夹
4. 把要引用的图片拷贝到xxxx文件夹中
5. 使用\![]\(xxxx/example.jpg)来引用本地图片

hexo 配置pdf显示

安装hexo-pdf插件
```
 npm install -save hexo-pdf
```
拷贝pdf到资源文件夹
与文章同名的资源文件夹在配置图片时已经配置过,这里直接用
文章中引用, 注意写法, 只需要把pdf文件名改好就行,前面的pdf不能修改
```
 {% pdf pdf文件名 %}
```
外部链接使用外部链接：
```
 {% pdf http://7xov2f.com1.z0.glb.clouddn.com/bash_freshman.pdf %}
```

添加目录

这是在visual studio code中使用的
可以在想要添加目录的地方加入下面这句话,就能自动为文章增加目录,Awesome!
还可以设置需要显示的目录级别,在文章开头可以通过 ctrl+鼠标左键 的方式跳转到对应内容

<!-- @import "[TOC]" {cmd="toc" depthFrom=2 depthTo=3 orderedList=false} -->

踩过的坑

hexo用着用着报错，提示node版本太低

升级node：

 node -v     #查看当前版本
 sudo npm cache clean -f #清楚node缓存 有时候不用也可以
 sudo npm install n -g   #安装node版本管理工具n
 sudo n stable           #安装最新版node

 sudo n 8.9.4            #安装指定版本
 node -v

报错：The “mode“ argument must be integer. Received an instance of Object
主要原因是node版本过高，下载之前版本node

引用

转载请注明来源，欢迎对文章中的引用来源进行考证，欢迎指出任何有错误或不够清晰的表达。可以邮件至 yangbenbo@whu.edu.cn