当前位置:   article > 正文

Typora+Gitbook写作并导出pdf_readme.md summary.md

readme.md summary.md

安装Gitbook

1.首先安装node,查看版本

  1.  node -v
  2.  # v12.16.1

2.安装gitbook,查看版本

  1.  npm install gitbook-cli -g
  2.  # 查看版本
  3.  gitbook -V
  4.  CLI version: 2.3.2
  5.  GitBook version: 3.2.3

Gitbook基本操作

gitbook安装成功以后就可以进行操作了,使用Typora就可以。

1.初始化一本书

  1.  # 执行init命令会在当前目录下创建README.md和SUMMARY.md文件
  2.  $> gitbook init
  3.  warn: no summary file in this book
  4.  info: create README.md
  5.  info: create SUMMARY.md
  6.  info: initialization is finished

README.md是说明文档,而 SUMMARY.md 其实就是书的章节目录,其默认内容如下所示:

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

2.启动gitbook,然后在浏览器地址栏中输入 http://localhost:4000 便可预览书籍

 gitbook serve

3.生成网页而不开启服务器,可以使用gitbook build命令

导出pdf

参考文档

首先说明,将gitbook导出为pdf的可选方式本身就不多,这是我觉得还比较好的其中一种。但是缺点也非常明显。导出到pdf是黑白的,不支持代码高亮,还markdown的高亮语法。我认为多少有些不可接受,但是苦于没有其他方式,所以还是用了这一种。

此种方式需要基于Python或者docker,由于我对Python比较熟悉,所以选用了前者,后者尝试了一下有报错,解决不了。

1.安装Python

2.手动安装安装weasyprint依赖,见官网。在安装Python依赖的时候可能会出现版本冲突的情况,这时候查看错误日志,比如aaa依赖冲突了,可以使用pip install aaa单独再安装一次一般就成功了。

3.克隆此github仓库到本地

4.解压克隆的代码后进入此代码根目录,执行pip install -r requirements.txt安装所需依赖

5.执行python gitbook.py {url}导出pdf。比如gitbook本地启动url为http://localhost:4000/second.html,启动gitbook以后,执行python gitbook.py http://localhost:4000/即可导出对应pdf。

效果如下,只能说差强人意,勉强能用吧。

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/我家自动化/article/detail/773247
推荐阅读
相关标签
  

闽ICP备14008679号