当前位置:   article > 正文

Gitbook&Typora&GitHub&Git 属于你的线上书_github 存放电子书

github 存放电子书

扫描关注微信公众号pythonfan,获取更多项目源码。
在这里插入图片描述在这里插入图片描述
示例:
Machine Vision Applications Cookbook with TensorFlow2

1、Gitbook安装

1.1 下载node.js

下载地址https://nodejs.org/zh-cn/download/releases/,下载版本为Node.js 12.X的,默认安装接即可。

打开Node.js command prompt,输入node -v 查看安装的版本。
在这里插入图片描述

1.2 安装Gitbook

打开node.js command prompt,运行下面命令,安装cnpm:

npm install cnpm -g --registry=https://registry.npm.taobao.org
  • 1

运行命令,安装gitbook:

cnpm install -g gitbook-cli
  • 1

gitbook版本
在这里插入图片描述

1.3 初始化电子书

新建电子书存放路径

mkdir e:\AnfanyBook
  • 1

打开,电子书存放路径

cd /d e:\AnfanyBook
  • 1

初始化电子书

gitbook init 
  • 1

执行完后,文件夹中出现两个文件 —— README.md 和 SUMMARY.md

  • README.md —— 书籍的介绍写在这个文件里
  • SUMMARY.md —— 书籍的目录结构在这里设置
1.4 查看电子书

在电子书目录下运行

gitbook serve
  • 1
1.5 配置插件

插件可以让自己电子书的发布页面更丰富多彩。在电子书文件夹子内新建一个book.json文件,打开电子书目录,运行gitbook install 即可。

book.json文件示例:

 {
  "title":"TensorFlow2 Object Detection API全流程文档",
  "author":"AnFany",
  "language" : "zh-hans",
   "plugins": ["anchors",
               "tbfed-pagefooter",
               "donate",
               "chapter-fold",
               "splitter",
               "back-to-top-button",
                "github@2.0.0",
                "hide-element",
                "code",
                "-sharing",
                "sharing-plus",
                "auto-scroll-table"
],
   "pluginsConfig": {
        "tbfed-pagefooter": {
               "copyright": "Copyright &copy AnFany 2020",
                "modify_label": "最近修订时间:",
                "modify_format": "YYYY-MM-DD HH:mm:ss"
        },
          "donate": {
                "wechat": "figure/0.1.jpg",
                 "alipay": "figure/0.0.jpg",
                 "title": "",
                  "button": "神来之笔",
                  "alipayText": "支付宝赞助",
                  "wechatText": "微信赞助"
        },
           "github" :{
                    "url": "https://github.com/Anfany"
       },
           "hide-element":{
                       "elements":[".gitbook-link"]
      },
           "sharing":{
                        "douban": false,
                        "facebook": false,
                        "google": false,
                        "linkedin": false,
                        "qq": false,
                        "twitter": false,
                        "weibo": false,
                        "whatsapp": false,
                         "all": ["douban", "facebook", "google", 
                                 "linkedin","twitter", 
                                 "qq", "weibo","whatsapp"]
     }
   }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
1.6 电子书输出为pdf
1.6.1 安装Calibre

下载地址https://calibre-ebook.com/download,选择适合系统的版本,默认安装即可。并将安装路径添加到系统变量,cmd窗口输入ebook-convert,验证安装。

1.6.2 输出pdf

生成PDF,使用下面命令生成PDF文件:

gitbook pdf {resource} {file}
  • 1

{resource} 资源路径可以相对路径或绝对路径
{file} 生成文件路径

2、Typora编辑器

推荐使用Typora作为.md文件编辑器,下载地址https://typora.io/
软件界面:
在这里插入图片描述
该markdown编辑器的优点在于:所见即所得,简洁也简单;

3、电子书托管到GitHub

利用Git将本地的电子书同步到GitHub,并利用GitHub的Github Pages服务发布电子书。

注意:此过程需要有github的账号,有邮箱就可注册。

电子书各个文件结构图类似如下:
在这里插入图片描述

3.1 安装Git

Git下载地址https://git-scm.com/downloads,默认安装即可。

3.2 更改hosts文件

为了解决GitHub中图片的显示问题。Window系统打开C:\Windows\System32\drivers\etc,记事本方式打开hosts文件,添加下面内容

# GitHub Start 
140.82.113.3      github.com
140.82.114.20     gist.github.com

151.101.184.133    assets-cdn.github.com
151.101.184.133    raw.githubusercontent.com
151.101.184.133    gist.githubusercontent.com
151.101.184.133    cloud.githubusercontent.com
151.101.184.133    camo.githubusercontent.com
151.101.184.133    avatars0.githubusercontent.com
199.232.68.133     avatars0.githubusercontent.com
199.232.28.133     avatars1.githubusercontent.com
151.101.184.133    avatars1.githubusercontent.com
151.101.184.133    avatars2.githubusercontent.com
199.232.28.133     avatars2.githubusercontent.com
151.101.184.133    avatars3.githubusercontent.com
199.232.68.133     avatars3.githubusercontent.com
151.101.184.133    avatars4.githubusercontent.com
199.232.68.133     avatars4.githubusercontent.com
151.101.184.133    avatars5.githubusercontent.com
199.232.68.133     avatars5.githubusercontent.com
151.101.184.133    avatars6.githubusercontent.com
199.232.68.133     avatars6.githubusercontent.com
151.101.184.133    avatars7.githubusercontent.com
199.232.68.133     avatars7.githubusercontent.com
151.101.184.133    avatars8.githubusercontent.com
199.232.68.133     avatars8.githubusercontent.com
# GitHub End
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28

如果提示没有权限保存文件,则需要修改文件属性,教程参见
https://jingyan.baidu.com/article/25648fc1f875e7d091fd0089.html

3.3 上传到GitHub

登录GitHub,新建一个仓库,
在这里插入图片描述

在这里插入图片描述
点击创建仓库,出现下面页面:
在这里插入图片描述
请勿关闭当前页面。

3.4 Git上传

Git安装完毕后,在电子书的目录下,点击Git Bash Here。
在这里插入图片描述

  1. git初始化
git init  
  • 1

在这里插入图片描述
此时该电子书文件夹内已经生成了一个隐藏文件.git。
在这里插入图片描述

  1. 远程仓库
    在这里插入图片描述
    运行上面红框内的命令
git remote add origin https://github.com/Anfany/Object-Detection-with-TensorFlow-gpu-2.2.git
  • 1
  1. 添加文件到暂存区
git add .  
  • 1

在这里插入图片描述

  1. 提交文件

提交描述可自定义

git commit -m “first”
  • 1

在这里插入图片描述

  1. 推送到仓库

推送到仓库的master分支,运行命令

git push -u origin master
  • 1

在这里插入图片描述
刷新刚才未关闭的GitHub页面。
在这里插入图片描述

4、GitHub Pages发布电子书

4.1 移动文件

将电子书文件夹内的除_book,.git文件以外的所有文件剪切出去。
在这里插入图片描述

然后将_book文件夹内的所有文件复制出来粘贴到该文件夹内,并将_book文件夹删除。
在这里插入图片描述

4.2 推送到新的分支

在当前的目录下点击Git Bash Here ,

新建一个分支

git checkout -b githubpages
  • 1

在这里插入图片描述
注意红框内变为新建的分支,其中githubpages为自定义名称。依次执行添加文件,提交文件,推送文件命令:

git add .
  • 1

在这里插入图片描述

git commit -m “github pages first”
  • 1

在这里插入图片描述

git push origin githubpages
  • 1

在这里插入图片描述

4.3 查看结果

打开GitHub的该仓库的页面,显示如下
在这里插入图片描述
点击Settings,找到GitHub Pages
在这里插入图片描述
第二个红框里面的内容设置为新建的分支名称。
在这里插入图片描述
点击保存,页面刷新完毕后,再次回到该位置,即可找到电子书发布到GitHub Pages生成的网址。
在这里插入图片描述

5、克隆电子书仓库到本地

新建文件夹,在该文件夹内运行Git Bash Here

 git clone https://github.com/Anfany/Object-Detection-with-TensorFlow-gpu-2.2.git
  • 1

速度较慢,需要等待。

6、更新电子书

电子书的更新涉及到GitHub以及GitHub Pages的两部分内容,实现原理是一样的,都是把相应的文件推送到对应的分支。GitHub上的内容是推送到master,GitHub Pages的是将gitbook serve生成的_book里面的文件推送到githubpages分支。
步骤如下:

  1. 新建一个文件夹,运行Git Bash Here;
  2. 克隆项目
  • master:git clone 项目.git
  • githubpages分支:git clone 项目.git -b githubpages
  1. 添加更改的文件到暂存区
git add .
  • 1
  1. 提交
git commit -m “change”
  • 1
  1. 推送
git push
  • 1
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/小惠珠哦/article/detail/773293
推荐阅读
相关标签
  

闽ICP备14008679号