当前位置: 首页 > news >正文

在Coding.net上搭建并配置 gitbook电子书 的记录

一、安装Node.js

1、去node.js官网下载安装包,根据自己电脑下载对应的版本,我这里下载的是64位安装程序(下载地址:下载 | Node.js 中文网)
在Coding.net上搭建并配置 gitbook电子书 的记录

2、一路默认安装,当然这里截图说明安装node.js时候,node.js和npm都被安装了,并加入了环境变量(node.js和npm的关系类似python和pip的关系,npm是一个包管理工具)

3、安装完成可以重新通过命令看版本号 node -v npm -v

在Coding.net上搭建并配置 gitbook电子书 的记录

二、安装gitbook程序

执行命令npm install -g gitbook-cli,默认下载的国外镜像,如果网速不好,可能会略慢,耐心等待

下载好后出现版本号,安装成功(我等了4分钟)

在Coding.net上搭建并配置 gitbook电子书 的记录

可以使用gitbook -V 来检查是否安装成功。

三、配置仓库

进入Coding.net创建仓库

创建2个仓库 fox 和 fox-doc (仓库名字随意取):

fox-doc: GitBook 源文件
fox: GitBook 生成的静态文件

克隆

克隆这 2 个仓库到本地的同一个文件夹下(yourname换成你的账号名) (我这里克隆到G:Ggitbook)

git clone git@git.coding.net:yourname/fox.git
git clone git@git.coding.net:yourname/fox-doc.git

四、本地查看

这一步就可以做一本书,然后放在本地服务器上看看了。

创建文件 README.md 和 SUMMARY.md,它们是 GitBook 最重要的 2 个文件,README.md 对书进行介绍,在 SUMMARY.md 中描述书的目录结构,其内容可参考如下:

README.md:

本书用于介绍 Pandora 项目的使用说明

SUMMARY.md:

# Summary

* [简介](README.md)
* [第一章](chapter1/README.md)
    * [第一节](chapter1/section1.md)
    * [第二节](chapter1/section2.md)
* [第二章](chapter2/README.md)
    * [第一节](chapter2/section1.md)
    * [第二节](chapter2/section2.md)
* [结束](end/README.md)

执行 gitbook init

在书籍目录(我的是G:Ggitbook)右键打开git bash,

在Coding.net上搭建并配置 gitbook电子书 的记录

执行gitbook init命令

在Coding.net上搭建并配置 gitbook电子书 的记录

会自动创建 SUMMARY.md 中描述的目录结构对应的文件夹和文件,每次执行这个命令都会创建还没有还不存在的文件和文件夹,但是不会影响已经创建的,所以不用担心多次执行 gitbook init 导致数据丢失

执行 gitbook serve

在Coding.net上搭建并配置 gitbook电子书 的记录

在浏览器里访问 http://localhost:4000 就可以看到上面写的书了,以后常用的也是这个命令,当文件变化后可以在网页中及时看到新的变化

补充:

Windows 中 gitbook serve 运行后,当文件发生变化时不是自动更新网页而是退出,可以使用下面的脚本来运行 gitbook serve 解决这个问题:

@Echo off
:Start
call gitbook serve
goto Start

把上面的文件保存为 gs.bat 放到 GitBook 目录中,运行 gs.bat 就可以了。

五、上传到Coding

复制 fox-doc/_book 中的文件到 fox 目录下(不是直接复制_book文件夹,而是复制里面的文件)

在Coding.net上搭建并配置 gitbook电子书 的记录

进入fox目录,右键打开git bash,依次执行下面命令

git add -A
git commit -m "test"
git push

访问 https://coding.net 中的仓库 fox,找到 Pages 服务,一键开启

在Coding.net上搭建并配置 gitbook电子书 的记录

访问 http://yourname.coding.me/fox 就可以看到我们使用 GitBook 写的内容了

五、脚本自动化

第四步每次上传都要执行三个命令,枯燥无味还容易出错,所以写个脚本自动化执行。

类 Unix 可以使用 shell 脚本 fox-doc/deploy.sh 进行自动化处理:

gitbook build
cd ../fox
rm -rf *
cp -r ../fox-doc/_book/* .
git add -A
git commit -m "test"
git push

在 fox-doc 目录中执行 sh deploy.sh 就可以把 GitBook 生成的网页发布到网上了

Windows 可以使用 Bat 脚本 fox-doc/deploy.bat 进行自动化处理:

call gitbook build
cd ..\fox
del /Q *
rd /S /Q gitbook
xcopy /E ..\fox-doc\_book\* .
git add -A
git commit -m "test"
git push
cd ..\fox-doc

在 fox-doc 目录中执行 deploy.bat 就可以把 GitBook 生成的网页发布到网上了
等待几秒后,cmd窗口会自动关闭。

del /Q * 删除 目录下的所有文件
rd /S /Q gitbook 删除 gitbook 目录及其所有子目录和文件
call cmd 在当前窗口运行第三方程序,运行完后继续往下执行
start cmd 会打开新窗口运行第三方程序


参考:
详解Gitbook制作精美电子书 - 云+社区 - 腾讯云
GitBook 入门 | 公孙二狗
GitBook 使用 Coding.net 的 Pages 访问 | 公孙二狗
GitBook 从懵逼到入门 - 卢小喵的学习笔记 - CSDN博客
gitbook 入门 - </script> - 博客园

相关文章:

  • 易语言 引号换行符自动替换 源码
  • iphone短信全部已读的方法
  • 易语言去除html标签方法
  • sql删除表所有记录 命令
  • IntelliJ Idea 向上/下插入空行快捷键
  • jquery 选择class下第几个元素
  • 两两独立为什么不能推出相互独立
  • 易语言 显示中文引号的方法
  • 易语言将JS对象转为json文本
  • java核心技术卷1 第11版 勘误表
  • InputStream.read 何时返回0
  • Java StringReader 用处
  • java日期年月日pattern
  • idea java.lang.ClassNotFoundException: com.mysql.jdbc.Driver
  • idea new新建 没有package包
  • 【编码】-360实习笔试编程题(二)-2016.03.29
  • Java多态
  • Lsb图片隐写
  • Sequelize 中文文档 v4 - Getting started - 入门
  • Vue 2.3、2.4 知识点小结
  • 分享一个自己写的基于canvas的原生js图片爆炸插件
  • 小程序上传图片到七牛云(支持多张上传,预览,删除)
  • 用Canvas画一棵二叉树
  • 自定义函数
  • ionic入门之数据绑定显示-1
  • 不要一棍子打翻所有黑盒模型,其实可以让它们发挥作用 ...
  • ​什么是bug?bug的源头在哪里?
  • # Swust 12th acm 邀请赛# [ E ] 01 String [题解]
  • ### Error querying database. Cause: com.mysql.jdbc.exceptions.jdbc4.CommunicationsException
  • #[Composer学习笔记]Part1:安装composer并通过composer创建一个项目
  • #include到底该写在哪
  • #微信小程序:微信小程序常见的配置传值
  • #我与Java虚拟机的故事#连载13:有这本书就够了
  • #我与虚拟机的故事#连载20:周志明虚拟机第 3 版:到底值不值得买?
  • (0)Nginx 功能特性
  • (安全基本功)磁盘MBR,分区表,活动分区,引导扇区。。。详解与区别
  • (附程序)AD采集中的10种经典软件滤波程序优缺点分析
  • (附源码)spring boot火车票售卖系统 毕业设计 211004
  • (附源码)springboot“微印象”在线打印预约系统 毕业设计 061642
  • (附源码)springboot课程在线考试系统 毕业设计 655127
  • (汇总)os模块以及shutil模块对文件的操作
  • (每日持续更新)信息系统项目管理(第四版)(高级项目管理)考试重点整理第3章 信息系统治理(一)
  • (原)Matlab的svmtrain和svmclassify
  • (转)菜鸟学数据库(三)——存储过程
  • (转)程序员疫苗:代码注入
  • .gitignore文件—git忽略文件
  • .NET Core 成都线下面基会拉开序幕
  • .NET/C# 异常处理:写一个空的 try 块代码,而把重要代码写到 finally 中(Constrained Execution Regions)
  • /var/log/cvslog 太大
  • [20170705]diff比较执行结果的内容.txt
  • [BT]BUUCTF刷题第8天(3.26)
  • [C++] 如何使用Visual Studio 2022 + QT6创建桌面应用
  • [C++]18:set和map的使用
  • [C++]指针与结构体
  • [Deep Learning] 神经网络基础