精华内容
下载资源
问答
  • GitBook

    2021-01-06 16:45:22
    <div><p>This PR switches the book over to the <code>gitbook</code> format, simplifying the build process and setup :book: :boom: . <p><img alt="screen shot 2015-01-14 at 21 28 17" src=...
  • gitbook

    2020-11-25 05:07:58
    <div><h4>Problem <p>gitbook <h4>Proposed Solution <p>mdbook</p><p>该提问来源于开源项目:solana-labs/solana</p></div>
  • Gitbook

    2021-01-22 15:19:34
    gitbook -V 输入以上命令后,一直提示以下内容: CLI version: 2.3.2 Installing GitBook 3.2.3 解决方法: 第一步配置淘宝源: npm config set registry=http://registry.npm.taobao.org -g 第二步:切换...

    安装问题: 

    gitbook -V
    

    输入以上命令后,一直提示以下内容:

    CLI version: 2.3.2
    Installing GitBook 3.2.3
    

    解决方法:

    第一步配置淘宝源:

    npm config set registry=http://registry.npm.taobao.org -g

    第二步:切换到安装目录:

    cd /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/
    

    第三步:全局安装 graceful-fs

    npm install graceful-fs@latest --save

    第四步:随便在电脑目录创建一个文件夹:在文件夹中打开终端执行命令

    gitbook init

    上面提示:

    TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Promise

    是因为版本太新,把node换成旧的版本:

    打开https://npm.taobao.org/mirrors/node/ 随意下载一个旧的版本,我是下载的https://npm.taobao.org/mirrors/node/v12.20.1/ 下面的node-v12.20.1-x64.msi

    重新卸载node,安装12版本node,在文件夹中执行,不会报错了

    gitbook init
    warn: no summary file in this book
    info: create README.md
    info: create SUMMARY.md
    info: initialization is finished
    

    使用:

     

     

    展开全文
  • gitBook

    2019-07-16 18:19:54
    gitBook搭建 1、安装node.js 由于gitBook依赖于node.js,因此首先需要安装node.js,node.js安装下载 https://nodejs.org/en/ cmd命令行安装node.js npm install -g gitbook-cli 安装gitBook后,就会多出一个gitBook...

    gitBook搭建

    1、安装node.js

    由于gitBook依赖于node.js,因此首先需要安装node.js,node.js安装下载 https://nodejs.org/en/

    cmd命令行安装node.js

    npm install -g gitbook-cli
    

    安装gitBook后,就会多出一个gitBook命令

    2、安装Typora(很好的支持macOs\windows\Linux的markdown编辑工具)

    下载地址:https://typora.io/

    3、Git安装

    下载地址https://git-scm.com/downloads
    安装git可以进行编辑的文件版本管理

    4、快速使用

    首先需要创建一个文件夹例:myBook,然后cmd切换到myBook文件夹下,执行

    gitbook init
    

    进行初始化,文件夹下会看到两个文件

    README.md —— 书籍的介绍写在这个文件里
    SUMMARY.md —— 书籍的目录结构在这里配置
    

    然后启动Typora对这两个文件进行编辑,首先readme.md中进行前言编写

    在summary.md中进行目录编写

    * [前言](README.md)
    * [第一章](Chapter1/README.md)
      * [第1节:安装node.js](Chapter1/安装node.js.md)
      * [第2节:安装Typora](Chapter1/安装Typora.md)
      * [第3节:安装Git](Chapter1/安装Git.md)
      * [第4节:进行使用](Chapter1/进行使用.md)
    * [第二章](Chapter2/README.md)
    * [第三章](Chapter3/README.md)
    * [第四章](Chapter4/README.md)
    

    让后再次切换到myBook文件夹下,执行

    gitbook init
    

    GitBook会查找SUMMARY.md文件中描述的目录以及文件,如果没有则会进行创建。然后我们对每一个文件我们就可以进行编辑了。

    5、预览gitBook

    通过执行 gitbook serve我们可以通过浏览器来预览gitBook,我们可以通过 http://localhost:4000
    来预览书籍

    6、构建书籍

    可以通过bulid命令可以指定路径 gitbook build [书籍路径] [输出路径]

    serve命令指定端口 gitbook serve --port 8008

    生成PDF格式的电子书 gitbook pdf ./ ./mybook.pdf

    生成epub 格式的电子书 gitbook epub ./ ./mybook.epub

    生成mobi格式电子书 gitbook mobi ./ ./mybook.mobi

    7、使用Git做版本管理

    在 mybook 目录下执行git init 初始化仓库,执行 git remote add 添加远程仓库(你得先在远端建好)。接着就可以 commit,push,pull …

    最后

    gitBook的安装以及使用就结束了

    展开全文
  • GitBook 从懵逼到入门

    万次阅读 多人点赞 2018-07-18 16:36:57
    本文从 “是什么”、“为什么”、“怎么办”、“好不好” 四个维度来介绍 GitBook,带你从黑暗之中走出来,get 这种美妙的写作方式。 是什么?  在我认识 GitBook 之前,我已经在使用 Git 了,毋容置疑,...

    本文从 “是什么”、“为什么”、“怎么办”、“好不好” 四个维度来介绍 GitBook,带你从黑暗之中走出来,get 这种美妙的写作方式。


    是什么?

    在我认识 GitBook 之前,我已经在使用 Git 了,毋容置疑,Git 是目前世界上最先进的分布式版本控制系统。

    我认为 Git 不仅是程序员管理代码的工具,它的分布式协作方式同样适用于很多场合,其中一个就是写作(这会是一个引起社会变革的伟大的工具!)。所以在我发现 GitBook 之前,实际上我已经无数次想象过它的使用场景了。

    咋一看 GitBook 的名字,你可能会认为它是关于 Git 的一本书。而当你有所了解之后,你也许会认为它是一个使用 Git 构建电子书的工具。其实不然,GitBook 与 Git 的关系,就像雷锋塔和雷锋那样,没有一点关系!

    这里写图片描述

    实际上,GitBook 是一个基于 Node.js 的命令行工具,支持 Markdown 和 AsciiDoc 两种语法格式,可以输出 HTML、PDF、eBook 等格式的电子书。所以我更喜欢把 GitBook 定义为文档格式转换工具
      
    所以,GitBook 不是 Markdown 编辑工具,也不是 Git 版本管理工具。市面上我们可以找到很多 Markdown 编辑器,比如 Typora、MacDown、Bear、MarkdownPad、MarkdownX、JetBrains’s IDE(需要安装插件)、Atom、简书、CSDN 以及 GitBook 自家的 GitBook Editor 等等。

    这里写图片描述

    但 GitBook 又与 Markdown 和 Git 息息相关,因为只有将它们结合起来使用,才能将它们的威力发挥到极致!因此,通常我们会选择合适的 Markdown 编辑工具以获得飞一般的写作体验;使用 GitBook 管理文档,预览、制作电子书;同时通过 Git 管理书籍内容的变更,并将其托管到云端(比如 GitHub、GitLab、码云,或者是自己搭建的 Git 服务器),实现多人协作。

    实际上,GitBook Editor 对于新手来说是个不错的选择,它集成了 GitBook、Git、Markdown 等功能,还支持将书籍同步到 gitbook.com 网站,使我们可以很方便地编辑和管理书籍。但是不幸的是,GitBook Editor 的注册和登录需要翻墙,即便注册成功了也可能登录不上,似乎是因为网站最近在升级。

    这里写图片描述

    因此,我推荐,也是我目前使用的搭配是 GitBook + Typora + Git


    为什么?

    通常,我们最开始学习和使用的办公软件就是 Word、Excel 和 PowerPoint。这里不是说它们已经过时了,不是说 GitBook 能够替代它们。

    相反,Microsoft 的办公软件很优秀并且经受了时间的考验,但是正因为它功能丰富,导致稍显臃肿(二八定律:80%的时间里我们只会只用20%的功能),同时因为它存在以二进制格式保存、软件不兼容、格式不兼容、难以进行版本控制、难以实时分享预览、难以多人协作等短板。而这恰恰是 GitBook + Markdown + Git 的长处。

    简单来说,GitBook + Markdown + Git 带来的好处有:

    • 语法简单
    • 兼容性强
    • 导出方便
    • 专注内容
    • 团队协作

    所以,如果你和我一样,不满足于传统的写作方式,正在寻找一种令人愉悦的写作方式,那么该尝试使用 GitBook 啦!

    这里写图片描述

    当然,GitBook 不是万能的,当我们需要复杂排版时,依然需要依托于 Word 等工具。但不用担心,因为我们可以把 Markdown 格式的文档导出为 Word 格式,再进一步加工。


    怎么办?

    怎么安装

    当你听了我的怂恿,并决定尝试使用 GitBook 的时候,首先面临的问题是 —— 如何搭建 GitBook 环境?

    因为 GitBook 是基于 Node.js,所以我们首先需要安装 Node.js(下载地址:https://nodejs.org/en/download/),找到对应平台的版本安装即可。

    现在安装 Node.js 都会默认安装 npm(node 包管理工具),所以我们不用单独安装 npm,打开命令行,执行以下命令安装 GitBook:

    npm install -g gitbook-cli
    

    安装完之后,就会多了一个 gitbook 命令(如果没有,请确认上面的命令是否加了 -g)。

    上面我推荐的是 GitBook + Typora + Git,所以你还需要安装 Typora(一个很棒的支持 macOS、Windows、Linux 的 Markdown 编辑工具)和 Git 版本管理工具。戳下面:

    • Typora 下载地址:https://typora.io/
    • Git 下载地址:https://git-scm.com/downloads

    Typora 的安装很简单,难点在于需要翻墙才能下载(当然你也可以找我要)。Git 的安装也很简单,但要用好它需要不少时间,这里就不展开了(再讲下去怕你要跑啦~)。

    怎么使用

    想象一下,现在你准备构建一本书籍,你在硬盘上新建了一个叫 mybook 的文件夹,按照以前的做法,你会新建一个 Word 文档,写上标题,然后开始巴滋巴滋地笔耕。但是现在有了 GitBook,你首先要做的是在 mybook 文件夹下执行以下命令:

    gitbook init
    

    执行完后,你会看到多了两个文件 —— README.md 和 SUMMARY.md,它们的作用如下:

    • README.md —— 书籍的介绍写在这个文件里
    • SUMMARY.md —— 书籍的目录结构在这里配置

    这时候,我们启动恭候多时的 Typora 来编辑这两个文件了:

    这里写图片描述

    编辑 SUMMARY.md 文件,内容修改为:

    # 目录
    
    * [前言](README.md)
    * [第一章](Chapter1/README.md)
      * [第1节:衣](Chapter1/衣.md)
      * [第2节:食](Chapter1/食.md)
      * [第3节:住](Chapter1/住.md)
      * [第4节:行](Chapter1/行.md)
    * [第二章](Chapter2/README.md)
    * [第三章](Chapter3/README.md)
    * [第四章](Chapter4/README.md)
    
    

    然后我们回到命令行,在 mybook 文件夹中再次执行 gitbook init 命令。GitBook 会查找 SUMMARY.md 文件中描述的目录和文件,如果没有则会将其创建。

    Typora 是所见即所得(实时渲染)的 Markdown 编辑器,这时候它是这样的:

    这里写图片描述

    接着我们执行 gitbook serve 来预览这本书籍,执行命令后会对 Markdown 格式的文档进行转换,默认转换为 html 格式,最后提示 “Serving book on http://localhost:4000”。嗯,打开浏览器看一下吧:

    这里写图片描述

    当你写得差不多,你可以执行 gitbook build 命令构建书籍,默认将生成的静态网站输出到 _book 目录。实际上,这一步也包含在 gitbook serve 里面,因为它们是 HTML,所以 GitBook 通过 Node.js 给你提供服务了。

    当然,build 命令可以指定路径:

    gitbook build [书籍路径] [输出路径]
    

    serve 命令也可以指定端口:

    gitbook serve --port 2333
    

    你还可以生成 PDF 格式的电子书:

    gitbook pdf ./ ./mybook.pdf
    

    生成 epub 格式的电子书:

    gitbook epub ./ ./mybook.epub
    

    生成 mobi 格式的电子书:

    gitbook mobi ./ ./mybook.mobi
    

    如果生成不了,你可能还需要安装一些工具,比如 ebook-convert。或者在 Typora 中安装 Pandoc 进行导出。

    除此之外,别忘了还可以用 Git 做版本管理呀!在 mybook 目录下执行 git init 初始化仓库,执行 git remote add 添加远程仓库(你得先在远端建好)。接着就可以愉快地 commit,push,pull … 啦!

    不是程序员的小伙伴可能不太喜欢用命令行,那其实版本管理这部分可以下载安装 Git 或 GitHub 这些客户端程序,在图形界面上操作也是可以完成工作的。


    好不好?

    额… 你觉得好不好嘛?

    反正我觉得挺好的,特别是对我这种懒得排版,又想随时随地写作的宝宝来说。而且能够查看每个版本内容变更的情况,同时又避免了硬盘单一故障带来的风险。

    在这里插入图片描述


    对了,经常有人问我怎么学 Markdown,给大家推荐一本书:

    在这里插入图片描述

    《了不起的Markdown》(博文视点出品)

    展开全文

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 7,361
精华内容 2,944
关键字:

gitbook