gitbook组织管理书写

1、git

强大的版本管理工作,也适合对书写内容的更新管理。

2、markdown

git管理文本,所以书写要从docx格式转变成markdown.

而typora是一个比较好用markdown书写工具,还提供的markdown转docx等功能。

3、gitbook

是组织文本结构的。还可以预览、制作电子书。

 

gitbook使用过程:

1、安装,全局安装

npm install -g gitbook-cli

2、开始,文档组织

gitbook init

在对应目录下,执行该命令,回生成README.md 和 SUMMARY.md

  • 最重要的就是SUMMARY.md,书籍的目录结构在这里配置。
  • 文件格式md,markdown文件。

3、编辑文档结构

编辑 SUMMARY.md 文件,markdown链接的形式。例如:

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1节:衣](Chapter1/衣.md)
  * [第2节:食](Chapter1/食.md)
  * [第3节:住](Chapter1/住.md)
  * [第4节:行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

注意的链接

再次执行gitbook init命令,会更新文档结构,生成对应的目录和文件。

4、使用markdown工具书写文档

Typora 是所见即所得(实时渲染)的 Markdown 编辑器: https://typora.io/

5、预览文本

gitbook serve
gitbook serve --port 2333

 执行该命令进行预览。

gitbook会对 Markdown 格式的文档进行转换,默认转换为 html 格式,生成文档在 _book目录下。

最后提示 “Serving book on http://localhost:4000”,打开浏览器查看。

6、自定义转换。

gitbook build [书籍路径] [输出路径]
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub

7、git版本管理

文本格式,可以对这个目录用git管理版本。

 

转载于:https://www.cnblogs.com/mitang/p/10992982.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值