GitBook Editor不能pull新Book时的处理

2024-06-02 13:01:28

1.1 GitBook Editor不能获取新Book时的处理

1.1.1 概念说明

l GitBook Editor是客户端程序，用于内容的编辑与开发。

l Git是在CMD中执行的命令行，可以用于本地与服务端的同步操作（主要是首次从服务端拉取文件）。

1.1.2 场景说明

笔者在GitBook网站创建新的Book后，虽然在Gitbook Editor上可以看到该Book名称，但是单击书名后，却一致处于同步状态，无法进入编辑视图。查看本地存储目录，始终无法获取到相应的md文件。

1.1.3 解决办法

步骤 1 进入Gitbook Editor在本地的仓库目录。

Gitbook Editor的本地仓库目录如“C:\Users\wht\GitBook\Library\hting”所示，路径中“hting”是gitbook的用户名，即在本地仓库下为不同的gitbook账号分别创建了不同的存储目录。

步骤 2 在该目录下打开CMD或PowerShell窗口。

可以按住“shift”键并单击鼠标右键选择“在此次打开PowerShell”。

步骤 3 执行如下命令将gitbook服务端的Book文件同步到本地。

git clone https://git.gitbook.com/hting/my-api-book.git

上述命令中的路径即要同步的书的git路径。

在首次执行该命令时，会要求输入用户名和密码。

该命令执行结束后，即可在该目录下看到已pull下来的md文件，此时再打开Gitbook Editor就可以打开该Book了。

1.1.4 其它说明

除了在GitBook Editor中进行Book的编辑外，也可以使用其它Markdown编辑器直接编辑本地仓库下的md文件，然后通过命令或打开GitBook Editor将本地修改push到服务端。

1.2 Gitbook的文档结构说明

新创建一本Book时会生成两个md文件：

l README.md：可以理解为书的封面，默认为Book的第一个Topic。

l SUMMARY.md：用于定义Book的结构信息，将所有的md文件组织在一起，相当于Dita中的ditmap文件。

样例如下：

GitBook Editor不能pull新Book时的处理相关推荐

gitbook 插入图片_【整理】Gitbook和Gitbook Editor使用心得
1.用其他编辑器如VSCode创建新章节,然后回到Gitbook中继续编辑内容由于Gitbook中的新建章节New Article时输入标题是输入的中文而生成的新章节的md文件的文件名是中文的拼 ...
GitBook Editor使用教程
新写了篇MarkDown新手教程,比较详细,建议看这个MarkDown新手教程.下面的就不用看了. 说明:以下教程关键符号会用小括号()括起来.自己在使用的时候别连小括号一块儿用了,比如:用(#).( ...
MFC 关于new出一个新对话框时，退出对话框内存泄漏的问题解决
MFC 关于new出一个新对话框时,退出对话框内存泄漏的问题解决参考文章: (1)MFC 关于new出一个新对话框时,退出对话框内存泄漏的问题解决 (2)https://www.cnblogs.co ...
docker pull下载镜像时的报错及其解决方法
docker pull下载镜像时的报错及其解决方法参考文章: (1)docker pull下载镜像时的报错及其解决方法 (2)https://www.cnblogs.com/it-artical/p ...
[WPF]winfom中ShowWPF新窗口时TextBox等控件无法输入问题解决方法 .
项目使用ElementHost方式加载WPF,刚才直接在WPF中使用Show,而不是ShowDialog新开窗口时,窗口中的控件无法输入,但可以直接粘贴. 原来是因为WinForm与WPF实现Inpu ...
《编写高质量代码：改善c程序代码的125个建议》——建议4-1：整数转换为新类型时必须做范围检查...
本节书摘来自华章计算机<编写高质量代码:改善c程序代码的125个建议>一书中的第1章,建议4-1,作者:马伟更多章节内容可以访问云栖社区"华章计算机"公众号查看. ...
python笔记 print+‘\r‘ （打印新内容时删除打印的旧内容）
\r 表示将光标的位置回退到本行的开头位置配合end=''不换行,实现打印新内容时删除旧内容 1 倒计时举例 1.1 '\r'+end='' import time for i in range(1 ...
python创建文件夹覆盖_Python 创建新文件时避免覆盖已有的同名文件的解决方法...
思路:创建文件时,先检查是否有同名文件(使用os.path.isfile),如果有,则在文件名后加上编号n来创建. 关键点: 1. 使用os.path.isfile判断文件是否存在 2. 使用递归函数 ...
oracletns中不存在名称为_关于数据库：向SQL Developer添加新连接时未显示Oracle TNS名称...
我正在尝试使用SQL Developer连接到oracle数据库. 我已经安装了.Net oracle驱动程序并将tnsnames.ora文件放在 C:\Oracle\product\11.1.0\c ...

最新文章

热门文章