乐趣区

gitbook使用教程

1. 说明
gitbook 网站是一个简单的个人在线书籍网站,在这里可以把自己的文档整理成书籍发布出来,便于阅读。gitbook 网站:https://legacy.gitbook.com/
本文主要讲解在 gitbook 网站上发布一个书籍文档和使用 gitbook 提供的工具在本地开发一个书籍文档部署到自己的服务上
在此之前你需要会如下准备:

账号:github 有账号,gitbook 使用 github 账号注册
git:代码管理工具
Markdown:gitbook 主要使用 MD 语法来编写书籍的
gitbook 工具:如果你在本地开发需要安装此插件,下面有介绍
nodejs 环境:gitbook 插件需要的运行环境
一款 Markdown 编辑器:方便本地开发,推荐 Typora 或 gitbook 自己的编辑器 gitbook editor

2. 在 gitbook 网站上创建一本文档书籍
此种方式是使用 github 网站加 gitbook 网站的方式来创建书籍的。首先你要有一个 github 账号,然后在 github 网站中创建了一个 repo 仓库,用于存放书籍内容的仓库。注意:gitbook 网站有时需要使用代理才能打开。
2.1 登陆 gitbook 网站
gitbook 网站支持直接使用 github 账号登陆的,推荐直接使用 github 账号登陆。打开 gitbook 网站:https://legacy.gitbook.com/ 点击右上角的 Sign In 登陆,然后选择 Sign in with GitHub 选择使用 github 账号进行登陆。第一次登陆 gitbook 网站时,需要 github 网站的认证,还需要到注册 github 网站的邮箱中点击确认。
2.2 创建一本书
2.2.1 点击新建一本书按钮
登陆网站后,点击右上角的用户图标,然后选择 Your Profile。然后就会在右上角看见 + new 按钮,点击此按钮就是创建一本书。或者在 gitbook 的 dashboard 页面有一个 New Book 按钮,点击也可以创建一个书籍:或者打开此链接,直接进入创建书籍页面:https://legacy.gitbook.com/new
2.2.2 在创建书籍中选择 github

退出移动版