Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书

这篇具有很好参考价值的文章主要介绍了Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

查看原文

一、安装 Nodejs

若要在 Windows 10 系统即本地使用 Gitbook,需要安装 gitlab-cli 工具,而 gitbook-cli 工具是基于 Nodejs的,因此首先需要安装 Nodejs

如果是初学者,可以参考 Nodejs----基于 Windows 10 系统安装 Nodejs 安装 Nodejs,这里需要注意,本文验证过安装 16.20.1 版本的 Nodejs是可以的,因此这里建议也安装 16.20.1 版本,不要安装更高的版本,如果手头上涉及多个前端项目,那么本文这里还是直接推荐参考 nvm----在 Windows10 系统同时安装管理多个Nodejs版本并能进行灵活便捷的切换工具 通过安装nvm,从而可以在 Windows 系统上安装多个 Nodejs 版本,这样在后续项目开发中可以做到灵活切换 Nodejs 的版本。本文就以 nvm 工具的方式演示

二、安装 Gitbook

(1)首先通过 nvm 查看本地已经安装了的 Nodejs 的版本,如下,这里已经安装了三个版本
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(2)因此这里可以通过 nvm use 16.20.1 命令切换 Nodejs 的版本,切换完成后,再次查看,如下确认 Nodejs 版本已经切换到 16.20.1 版本了。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(3)然后即可开始安装 gitbook-cli 包了,执行如下命令

npm install gitbook-cli -g

(4) 然后执行如下命令查看 gitbook-cli 的版本号并安装 gitbook

gitbook -V

(5) 此时有可能会出现如下错误,如果没有出现则直接跳过本步骤,如果出现了如下错误,则需要去解决一下。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

根据这里的报错提示,去打开 D:\ProgrameFile\nvm\v16.20.1\global\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js 文件,找到287行代码,可以看出如果有调用 statFix 函数则会触发这个问题。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

在这个文件中搜索 staFix 函数调用的位置,如下所示,只有如下三行在调用
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

这里也在网上查询了一些资料,发现好多人遇到过此问题,而且反馈只需要将此三行注释掉即可,因此这里我们同样也将此三行代码注释掉,如下图所示。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

然后保存,再此执行 gitbook -V 命令,如下图所示,可以看到已经安装成功了。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

三、gitbook 的使用方法

(1)这里就以 https://github.com/redrose2100/docs 代码仓为例展示了,将此 docs 项目下载到本地后,比如想写一本关于 Linux 的电子书,这里在 docs 项目中新建一个文件夹 linux,用于存放即将编写的电子书。目录结构如下所示:
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(2)在cmd窗口中进入到 linux 的文件夹,然后执行 gitbook init 命令,这里又遇到了如下所示的错误。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

此时需要找到文件 C:\Users\Administrator.gitbook\versions\3.2.3\lib\init.js,然后将 72 行注释掉,然后修改为 73行的代码
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook
即将

return fs.writeFile(filePath, summary.toText(extension));

修改为:

return summary.toText(extension).then(stx=>{return fs.writeFile(filePath, stx);});

保存后,重新执行 gitbook init 命令,此时可以看到可以执行成功了。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(3)此时会新生成两个文件 README.md 和 SUMMARY.md,目录结构如下图所示:
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(4)此时暂时先不做任何修改,然后直接执行 gitbook serve 命令启动服务,如下图所示:
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(5)根据提示然后在浏览器中打开 http://localhost:4000/ ,即可打开电子书的页面了,如下图所示:
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

四、设计电子书的目录结构

首先需要规划一下电子书的目录结构,比如我们想写一本关于Linux的电子书,然后大概设计如下目录:

第一章 Linux 概述
   1.1 Linux 简介
   1.2 Linux 特点
   1.3 Linux 的发展历史
第二章 Linux 常用命令
   2.1 用户与权限管理命令
   2.2 文件管理命令
   2.3 磁盘管理命令
第三章 shell 编程
   3.1 条件语句
   3.2 循环语句
   3.3 shell 编程实例

(1)首先在 linux 文件下创建三个文件夹,比如 ch01、ch02、ch03,用于存放三章内容,然后在每一个创建的子文件夹中继续创建md文件,比如 ch01/1_1.md, ch01/1_2.md, ch01/1_3.md, ch02/2_1.md, ch02/2_2.md, ch02/2_3.md, ch03/3_1.md, ch03/3_2.md, ch03/3_3.md, 此时的文件目录结构如下图所示:
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

(2)linux/README.md 文档可以理解为电子书的前言,而 SUMMARY.md 则是目录文件,这里比如先将 README.md 文档内容修改为如下内容:

# 前言

这是一本关于 Linux 的技术实战类型的书籍

(3)然后重点就是写 SUMMARY.md 文档,即编写目录了,这里根据电子书籍规划目录,可以编写 SUMMARY.md 文件的内容如下:

# 目录

* [前言](README.md)

* [第一章 Linux 概述]()
   * [1.1 Linux 简介](ch01/1_1.md)
   * [1.2 Linux 特点](ch01/1_2.md)
   * [1.3 Linux 的发展历史](ch01/1_3.md)
* [第二章 Linux 常用命令]()
   * [2.1 用户与权限管理命令](ch02/2_1.md)
   * [2.2 文件管理命令](ch02/2_2.md)
   * [2.3 磁盘管理命令](ch02/2_3.md)
* [第三章 Linux shell 编程]()
   * [3.1 条件语句](ch03/3_1.md)
   * [3.2 循环语句](ch03/3_2.md)
   * [3.3 shell 编程实例](ch03/3_3.md)

(4)将 gitbook serve 命令停止,然后重新执行 gitbook serve 命令,然后再根据提示打开 http://localhost:4000/ ,结果如下图所示,可以看出,此时已经和我们心中想象的电子书的格式差不多了。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

五、设置 gitbook 常用配置

(1)在linux 文件夹即与 SUMMARY.md 同一目录下创建 book.json 文件,文件内容如下所示:

{
    "title": "Linux 从入门到精通",
    "author": "redrose2100",
    "description": "Linux 从入门到精通",
    "language": "zh-hans",
    "gitbook": "3.2.3",
    "links": {
        "sidebar": {
            "GitHub": "https://github.com/redrose2100/docs"
        }
    }
}

其中:

  • title:书名
  • author:作者
  • description: 简要描述
  • language: 语言,这里使用 zh-hans 可以将页面切换为中文
  • gitbook: gitbook 的版本号,在安装的时候可以看到
  • links.sidebar: 可以设置连接,比如设置github链接调转到 docs 代码仓库地址

(2)再一次重新执行 gitbook serve 命令,然后重新打开 http://localhost:4000/ ,如下图所示,此时页面上原本英文的全部切换为中文了,而且在左侧还增加了一个 Github 链接,点击后是可以跳转到 github 上 docs 代码仓的。
Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书,gitbook,windows,gitbook

至此,在Windows上就将gitbook成功的运行起来了,当然为了能够编写出更加丰富多彩的电子书,后续还有许多功能比如常用的插件、比如屏蔽不必要的信息等,都需要继续进一步去优化,后续优化将在其他文章中继续详细展开,这里就暂时不在展开了。文章来源地址https://www.toymoban.com/news/detail-762592.html

到了这里,关于Gitbook----基于 Windows 10 系统本地安装配置 Gitbook 编写属于自己的电子书的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • Windows10系统下YOLOv5配置(Tesla P40 24GB、CUDA10.2) 二、安装

    操作系统:Windows10 显卡: Tesla P40  24GB CUDA版本:10.2 YOLOv5版本:4.0 下载相应版本的CUDA按默认一路安装到底 下载相应版本的cuDNN,解压,将bin中、include中、lib中文件分别复制到CUDA相应安装目录 bin中文件  include中文件  lib中文件 Python Releases for Windows | Python.org The official home

    2024年02月07日
    浏览(43)
  • windows10下设置本地apache\nginx站点部署ssl证书,使本地配置的域名可以用https访问

    首先我们需要下载openssl来生成证书文件: 去官方网址下载https://slproweb.com/products/Win32OpenSSL.html; 下载好了,双击exe文件,然后就下一步,下一步安装完成; 安装之后配置环境变量,新建一个系统变量OPENSSL_HOME,值就是你安装目录下的bin,然后在系统变量path,增加%OPENSSL_HO

    2024年02月15日
    浏览(44)
  • Python3.10动态修改Windows系统(win10/win11)本地IP地址(静态IP)

    一般情况下,局域网里的终端比如本地服务器设置静态IP的好处是可以有效减少网络连接时间,原因是过程中省略了每次联网后从DHCP服务器获取IP地址的流程,缺点是容易引发IP地址的冲突,当然,还有操作层面的繁琐,如果想要切换静态IP地址,就得去网络连接设置中手动操

    2024年02月03日
    浏览(51)
  • 基于GitHub代码库训练模型本地化AI代码自动补全 - Tabby Windows10

    参考: https://github.com/TabbyML/tabby 已经有好几款类似强劲的代码补全工具,如GitHub Copilot,Codeium等,为什么还要选择Tabby? Tabby除了和其他工具一样支持联网直接使用之外, 还支持本地化部署 。 即对内部代码安全性要求很高时,可以采取Tabby项目模型的本地化部署,不用担心本

    2024年02月02日
    浏览(118)
  • windows10/11系统实现本地账户密码登录微软账户 微软账户取消pin登录

    Windows 10支持两种账户登录模式,一种是使用了多年的通过本地用户账户来登录系统,另一种则是使用Microsoft账户来登录系统。使用Microsoft账户登录Windows系统是从Windows 8开始支持的登录模式,这种登录模式会自动连接到微软,然后对账户信息与系统设置进行自动同步。 简单来

    2024年02月13日
    浏览(50)
  • windows10下安装和配置nodejs环境

    官方下载地址:下载最新LTS windows版本:  16.15.0  (includes npm 8.5.5)  Node.js ,如下图 安装可以更改安装路径(我的是默认地址 C:Program Files ) 其余的都是选择 下一步, 安装  测试是否安装 成功 打开开始菜单中输入cmd,打开cmd命令窗口,分别输入如下命令 node -v 查看node的版本 npm

    2023年04月26日
    浏览(45)
  • Windows10 系统安装教程

    多虚不如少实。         下载前景:网上下载的 windows10 系统一般都有捆绑软件,用户体验不爽,所以建议到 正规渠道下载 windows10 系统的不同版本。另外网上也有一些 windows10 系统的镜像文件 可以直接一键安装,非常不推荐这种简单的安装方法,不利于电脑垃圾的清理,

    2024年02月10日
    浏览(43)
  • 【Windows 10】Prometheus监控平台安装以及配置windows Exporter探针

    Prometheus是一个开放性的监控解决方案,用户可以非常方便的安装和使用Prometheus并且能够非常方便的对其进行扩展。 在Prometheus的架构设计中,Prometheus Server并不直接服务监控特定的目标,其主要任务负责数据的收集,存储并且对外提供数据查询支持。因此为了能够能够监控到

    2024年02月04日
    浏览(52)
  • Windows10安装配置MySQL超详细教程(最新)

    用网盘或者去官网下载Mysql,我这里下载的是社区版,与企业版区别不大 官网下载链接:https://dev.mysql.com/downloads/mysql/ 第一个安装包比较小, 第二个安装包比较大, 因为包含调试工具,我这里下载的是第一个。 选择下方的 “No thanks, just start my download.”,进入下载。 这里的 解

    2023年04月08日
    浏览(45)
  • Windows10系统spark3.0.0配置

    Windows10系统基本环境:spark3.0. 0 +hadoop3.1. 0 +scala2.12.0+java jdk1.8。 环境变量配置路径:电脑→属性→高级系统设置→环境变量 path中加入:%JAVA_HOME%/bin。 注:jdk版本不宜过高。 cmd验证: java -version 官方下载网址:https://www.scala-lang.org/ 选择对应版本,这里我选择的是scala2.12.0版本

    2024年04月26日
    浏览(35)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包