使用github page 搭建 个人主页和gitbook

创建仓库

打开Github首页,登录后新建一个仓库。

提醒要注意仓库的名称,比如我的帐号是shipengqi,那么仓库名称应该是:shipengqi.github.io。

项目的root目录下建立一个index.html

在浏览器访问,比如:https://shipengqi.github.io,恭喜你,个人网站搭好了。

我的blog Pooky Lofe 使用hexo搭建

绑定个人域

申请域名

解析域名到github pages的ip上

设置Custom domain

进入仓库,点击Settings

创建一本书

创建一个新的仓库


创建一个新文件,名为SUMMARY.md,里面填入:

1
2
# Summary
* [前言](README.md)

创建书

  1. 首先进入gitbook的官网
  2. 用github登录
  3. 点+NewBook
  4. Install GitBook

  5. create book
  6. 同步GitHub

  7. GitBook的book页面默认没有download按钮的

  8. 更新失败,无法转换成pdf/mobi/epub格式

问题

开启github page,默认使用jekyll主题,jekyll会将这种格式[webstie](guide.md)自动转换为guide.html
但是注意如果在markdown语法中使用的html语法,如<a href="guide.md"></a>是不会转换的。