Gitbook 与Ditamap的区别

在Dita中把文档分解为不同的Topic，在Gitbook中则把文档分解为不同的md文件，但是Topic和md文件并不是等价的概念，Topic是粒度更细的划分，而md则是粗粒度的划分。一般而言对一个Book而言，一个章节创建一个md文件即可，在该md文件中可以有一级标题，二级标题等序列。

从发布形式上看，md文件之间被插入了分页符。也就是说，当需要分页的时候就需要再插入一个新的md文件了。对应如下场景：

Book是一本书：不同章节用不同的md文件写作。
Book是一个文档包：不同的分册用不同的md文件写作。

Gitbook 与Ditamap的区别相关推荐

gitbook使用及book.json详细配置
安装安装命令:1 npm install -g gitbook-cli test 安装完成之后,你可以使用下面的命令来检验是否安装成功. $ gitbook -V CLI version: 2.3. ...
简单实用 | 用Gitbook做笔记 / 写书过程全记录
用Gitbook写随笔 1. 准备 2. 开始写书 2.1 创建书籍 2.2 撰写书籍 2.2.1 生成目录 2.2.2 写你所想 2.3 构建书籍 2.4 预览书籍 2.5 生成书籍 3 发布书籍 ...
什么是Cookie和Session？—— Cookie和Session的区别？—— 一文教你理解清楚什么是Cookie和Session，以及常见的开发面试问题？
cookie和session区别 cookie和session 背景说明 1.cookie 1.1.定义 1.2.作用 1.3.组成(种类和参数) 1.3.1.会话 Cookies .永久性 Cook ...
解决方案和项目的区别_AI 项目落地应用指南--5.项目售前与解决方案
4.产品经理的工作挑战 <-- | --> 6.产品/项目启动本系列文章原稿发布于Github,感谢Star,欢迎Fork与PR.GitBook 对Markdown的渲染效果更好,有更好 ...
http http2和https的区别
作为一个经常和web应用程序打交道的程序员,了解这些协议是必须的,本文就向大家介绍一下这些协议的区别和基本概念,文中可能不局限于前端知识,还包括一些运维,协议方面的知识,希望能给读者带来一些收获,如有 ...
syslog服务器与elk区别_Splunk和ELK深度对比
随着Splunk越来越被大家熟知和认可,现在市面上也不断涌各种同类产品,作为大数据搜索界的翘楚Splunk和ElasticSearch,绝对值得我们去学习,探索和使用,因此为了造福Splunk的铁粉和 ...
RPC 笔记（01）— RPC概念、调用流程、RPC 与 Restful API 区别
1. 基本概念 PRC 远程过程调用 Remote Procedure Call,其就是一个节点请求另外一个节点提供的服务.当两个物理分离的子系统需要建立逻辑上的关联时,RPC 是牵线搭桥的常见技术手 ...
C++ 笔记（28）— C++ 中 NULL和 nullptr 的区别
最近看公司代码的时候发现在判断指针是否为空的时候,有的时候用的是 NULL, 有的时候用的是 nullptr 感觉很奇怪,好奇心驱使我查了下两者的区别,发现还是有很多细节需要学习的. 1. NULL ...
gcc 和 g++ 的联系和区别，使用 gcc 编译 c++
GCC 编译器已经为我们提供了调用它的接口,对于 C 语言或者 C++ 程序,可以通过执行 gcc 或者 g++ 指令来调用 GCC 编译器. 实际使用中我们更习惯使用 gcc 指令编译 C 语言程序 ...

Gitbook 与Ditamap的区别

Gitbook 与Ditamap的区别相关推荐

最新文章

热门文章