最近工作在研究 RADIUS,发现一本好书《FreeRADIUS Beginner's Guide》于是想自己翻译以下,所以就利用gitbook来制作这本电子书。
主要涉及到工具有如下:
- Gitbook :与GitHub没有任何关系,主要利用 MarkDown 语法来编写(也可利用客户端编辑);
- Github:代码托管平台,可以利用GIT版本控制;(Linux下直接使用GIT操作)
- disqus :提供第三方评论功能。(需要注册授权,配置关联脚本)
具体的操作步骤如下:
一. 注册 gitbook (此处使用 github 账户登录); New Book --> Create book --> Edit Book (使用MarkDown语法) 二. 关联 Gitbook和 Github:有两种方式,直接在 github上建立一仓库,然后同步到 gitbook中;或者在 gitbook中创建然后sync到github。 此处采用第二种:Setting --> Github(选择一个github上已存在的空仓库) -->sync 三. disqus 插件的安装: disqus 插件主要是提供第三方评论功能。 下面给刚刚配置的电子书添加评论功能: 1. 注册 disqus账号 https://disqus.com/ 2. 右上角 Setting --> Add Disqus To Site --> 最下面 GET STARTED --> I want to install ... 3. 填写网站 name 和分类 --> Create Site 4. 填写 Website URL如 http://iluqian.gitbooks.io 5.在Advanced中,将gitbook.com
和gitbooks.io
填写 6. Gitbook配置disqus,在所选书籍目录下:创建book.json文件,脚本如下:
{"title": "freeradius-beginner-s-guide",
"version": "1",
"description": "freeradius 新手指南",
"author": "liujie <iliujie59@gmail.com>",
"plugins": ["disqus"],
"pluginsConfig": {
"disqus": {
"shortName": "freeradius"
}
}
}