Gitbook - 标签 - 研发日志 · R&D Loghttps://rd163.visword.com/tags/gitbook/Gitbook - 标签 - 研发日志 · R&D LogHugo -- gohugo.iozh-CNwhutluohui@gmail.com (小智晖)whutluohui@gmail.com (小智晖)本作品采用知识共享署名-非商业性使用 4.0 国际许可协议进行许可。Sun, 12 Jan 2025 00:00:00 +0800GitBook CLI 命令行速览https://rd163.visword.com/posts/gitbookcli/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbookcli/<p>GitBook CLI 是 GitBook 官方早期提供的命令行工具，可以把一批 Markdown 文件组织成结构化的电子书或文档站点，支持生成静态网站、PDF、EPUB、MOBI 等多种格式。它在前端文档、API 手册、内部知识库等场景曾经非常流行。</p>Gitbook 基本安装https://rd163.visword.com/posts/gitbook-how-to-use/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-how-to-use/<p>本文介绍 Gitbook 旧版命令行工具（Legacy CLI）的安装前置条件、安装步骤与版本校验方法，并补充当前在新版 Node.js 环境下的兼容性注意事项。Gitbook 的安装本质上是「准备 Node.js 运行时 → 通过 npm 安装 CLI → 校验版本」三步。</p>Gitbook 简介https://rd163.visword.com/posts/gitbook-intro/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-intro/ 图书项目结构

README.md 和 SUMMARY.md 是 Gitbook 项目中最核心的两个文件。其中 README.md 是 Gitbook 官方规定的必需文件,SUMMARY.md 虽然是可选的，但几乎是实际项目里不可或缺的"目录骨架"——一本最简单的 Gitbook 至少需要 README.md,而只要章节多于一篇，通常都会配上 SUMMARY.md。它们在一本书中承担不同的作用。

]]>GitBook 使用入门https://rd163.visword.com/posts/gitbook-get-started/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-get-started/

GitBook 是一个基于 Node.js 的命令行工具（Command Line Interface, CLI）,可使用 Git/GitHub 和 Markdown 来制作精美的电子书与技术文档。

本文是 GitBook 系列的开篇，面向第一次接触 GitBook 的读者，介绍它的定位、安装方式、目录结构和最常用的命令，帮助你从零搭出一本能在线阅读的电子书。后续章节会分别讲解项目结构、命令行速览与输出格式。

]]>Gitbook 输出PDFhttps://rd163.visword.com/posts/gitbook-pdfandebook/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-pdfandebook/<p>GitBook 命令行工具(<code>gitbook-cli</code>)支持把 Markdown 写成的书籍导出为 PDF 文件，便于打印、归档或在无网络环境下阅读。本篇整理 PDF 导出的命令、依赖、配置项以及常见问题。</p>Gitbook 输出格式https://rd163.visword.com/posts/gitbook-output/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-output/<p>GitBook 命令行工具（<code>gitbook-cli</code>）可以把 Markdown 或 AsciiDoc 写成的源文件，构建为多种可分发的内容形态。本篇先对几种常见的输出格式做整体介绍，具体的操作细节在后续文章展开。</p>Gitbook 输出为静态网站https://rd163.visword.com/posts/gitbook-outfile/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-outfile/Gitbook Legacy CLI 的默认输出形态是静态网站(一组纯 HTML/CSS/JavaScript 文件)。只要本地的 SUMMARY.md、book.json 与各章节 Markdown 都已就绪，就可以用 CLI 自带的两条命令把它渲染成可以直接放到任意 Web 服务器上的静态站点。本文介绍这两种构建方式:gitbook serve(边预览边生成)与 gitbook build(只构建、不启动服务)。

]]>