更新日志

版本 1.1 - Boost 1.33.0

首次包含在 boost 中的版本。

版本 1.3 - Boost 1.34.0 到 1.34.1

Quickbook 文件包含 [include]。
更好的 xml 输出（美观的布局）。查看生成的 XML。
回归测试工具：确保您的文档始终兼容（完全向后兼容），无论 QuickBook 如何更改。
代码清理和重构。
允许在 doc-info 中使用 phrase 标记。
通过 ``code``（双反引号）预格式化的代码块允许在表格和列表中包含代码，例如。
Quickbook 版本控制；允许完全向后兼容。您必须将 [quickbook 1.3] 添加到 doc-info 标头以启用新功能。否则，QuickBook 将假定文档是 pre-1.3 文档。
更好（直观）的段落终止。一些标记可能会终止段落。例如
```
[section x]
blah...
[endsect]
```
完全限定的部分和标题。子节名称连接到 ID 以避免冲突。示例：doc_name.sect_name.sub_sect_name.sub_sub_sect_name
更好的   和代码片段中的空格处理。
[xinclude] 修复了当 input_directory 与 output_directory 不同时，到目标 XML 文件的相对路径。
允许无标题表格。
允许在节标题中使用 phrase 标记。
允许从代码、代码块和内联代码转义回 QuickBook。
脚注，使用 [footnote 这是脚注] 语法。
后处理器错误修复，用于它无法识别的转义 XML 代码。
可替换，使用 [~replacement] 语法。

版本 1.4 - Boost 1.35.0 到 1.40.0

通用标头
代码更改以允许完全递归（即 Collectors 和 push/pop 函数）
各种代码清理/维护
模板！
[conceptref] 用于引用 BoostBook <concept> 实体。
允许转义空格。转义的空格将从输出中删除。语法：\ 。
现在允许嵌套注释。
Quickbook 块可以嵌套在注释内。
导入功能。
导入代码上的标注
简单标记现在可以跨越整个块。
简介、警告和表格单元格（参见表格）现在可以包含段落。
\n 和 [br] 现在已弃用。
条件生成。类似 C++ #ifdef。
使用 --include-path (-I) 选项在可扩展的搜索路径中搜索包含和导入的文件。

版本 1.5 - Boost 1.41.0 到 1.42.0

支持文档信息中的多个版权条目。
改进的 SVG 支持。
[globalref] 用于引用 BoostBook <global> 实体。
错误时失败。
修复了参数过多或尾随空格的模板崩溃问题。
改进了代码块中意外字符的处理。
改进了代码块中不匹配转义的处理。
支持 python 代码片段。
teletype 源代码模式。
在模板中使用静态作用域，应该更直观。
接受 section: 和节 id 之间的空格。
支持表格 id。

版本 1.5.1 - Boost 1.43.0

改进后处理器中的块元素列表。table、 entry 和 varlistentry 被视为块。replaceable 被视为内联元素。
检查模板中 [section] 和 [endsect] 标签是否平衡。
添加 unicode 转义字符，例如 \u03B1 代表 α。
支持带有 unicode 字节顺序标记的 UTF-8 文件。
不允许在简单标记中使用 [。修复了一些标点符号不匹配的错误。
添加命令行标志以在命令行定义宏，例如 quickbook "-D__italic_foo__=/foo/"。

版本 1.5.2 - Boost 1.44.0

使用 cygwin 1.7 API 以获得更好的路径处理。
改进的 boostbook 生成
- 正确地 XML 编码文档信息。
- 避免生成空段落。
- 不再将块模板包装在段落中。
- 如果您对 docbook 文档类型使用无效的 doc_info 成员，则会发出警告。
- 修复了一些导致 boostbook 无效的其他原因，尽管它仍然在某些地方生成无效的 boostbook。
改进的语法
- 支持库 doc_info 中的多个类别。
- 不再需要在 docinfo 中的作者之间使用逗号。
- 允许空的文档正文。
- 仅包含注释的行不再被解释为段落分隔符。
- 如果一行以注释开头，即使后面跟着空格或列表字符，也将其解释为段落。
- 不将多个连续的空行视为多个段落分隔符。
修复了重复图像属性检测。
修复了多次使用代码片段的问题。
Quickbook 1.6 的早期工作，可以使用 [quickbook 1.6] 版本开关，但在未来版本中可能会更改。
- 当自动为标题生成 id 时，使用 quickbook 源代码，而不是生成的 docbook。
- 修复了包含文件中的 id 生成。它没有正确使用主文档的文档 id。
- 在包含具有不同版本的文件后，正确恢复 quickbook 版本开关。

版本 1.5.3 - Boost 1.45.0

修复了用于定义宏的命令行标志。
修复了代码块解析器中的几个问题
- 没有缩进的注释现在将结束代码块。
- 代码块不再必须后跟空行。
改进了模板和导入代码块中文件位置的跟踪。
为标注列表生成更好的标记。
在 docbook 中，变量列表条目只能有一个 listitem，因此如果一个条目有多个值，则将它们合并为一个 listitem。
支持嵌套代码片段。
支持文档信息注释中的嵌套块。
恢复了 xml 转义文档信息，它破坏了一些文档文件（现在是 1.6 功能）。
Quickbook 1.6 的进一步工作，仍然不稳定。
- 允许标题具有 id，使用语法：[heading:id title]。
- XML 转义文档字段，使用转义符允许在 ASCII 中编码 unicode。

版本 1.5.4 - Boost 1.46.1

Boost 1.46.0

在文档信息中添加对 lang 属性的支持。
改进的锚点实现。特别是对于在节或标题之前使用锚点。
修复了一些更多将包含注释的行视为空行的问题。
允许在条件 phrase 中导入、包含和 xinclude。将在未来版本中允许更多块元素。
重新排列语法的结构。
使用 filesystem 3。删除 cygwin 1.5 支持。

Boost 1.46.1

解决 g++ 4.4 在 64 位 linux 上的优化错误。

版本 1.5.5 - Boost 1.47

调整标题的锚点位置。
将 quickbook 路径硬编码到 quickbook 测试工具中。这意味着它们可以从多个位置使用。
为 boostbook bridgehead 元素生成 id。由于 docbook 在没有 id 的情况下会生成随机 id，因此这会产生更一致的 html。
改进了 windows 上的 unicode 支持。Unicode 现在可以从命令行使用，并且支持 unicode 文件名。Unicode 输出有点弱。
检查 windows 路径，并发出警告。
修复了 windows 上的相对路径检测。
撤销了对 [br] 的弃用，打印了关于生成无效 boostbook 的单个警告。
修复了处理空类别属性的问题。
将来自解析器的数据存储在动态数据结构中。这简化了实现，并使其更容易解析更复杂的数据结构。
改进了未知 doc info 属性的错误消息。
更丰富的版权语法。现在理解：[copyright 2001-2006, 2010 One person, 2008 Another person]。
修复了简单标记的定界符检查。
允许嵌套更多块元素。
返回使用无效标记进行列表。它生成更好的 html。
更好的列表锚点位置。
在代码片段中传递注释。
为 __FILENAME__ 宏使用相对路径。
重写 xinclude 路径生成器，使其不使用已弃用的文件系统函数。
允许在语法突出显示的代码中的注释内进行 quickbook 转义。
Quickbook 1.6
- 将源模式更改范围限定为它们所在的文件。
- 列表的显式标记。例如 [ordered_list [item1][item2]] 或 [itemized_list [item1][item2]]。

版本 1.5.6 - Boost 1.48

Xml 编码转义的标点符号（例如 \< 正确编码为 <）。
重命名重复生成的 id。
在文档末尾关闭打开的节（仍然会警告它们）。
用于标题的新锚点标记，有望生成更好的 pdf。
从后处理输出中删除代码周围的一些空格。

版本 1.5.7 - Boost 1.49

几项内部更改。
一些改进的错误消息。
更好地处理在 phrase 上下文中扩展的块模板。
避免空的简单标记（即 // 不被视为斜体的空格）。
更好的标题锚点标记，这对于打印来说应该更好 - 由 John Maddock 建议。
进一步改进 id 生成器。
如果在文档末尾未打开节，则在生成的标记中关闭它们。
尝试更好地处理代码块开头和结尾的空格。
处理紧跟在锚点之后的列表。
使水平规则后跟多行注释更合理一些。
更好地支持 docinfo 中的空 id 和标题。
修复了 SVG 处理中的一些小回归。
更好地处理无效的命令行宏。
当自动构建 quickbook 时，构建发布版本。
1.6 的许多更改
- 限定包含文件中的模板范围。
- 支持导入模板和宏。
- 从源文件包含顶级 quickbook 块。
- 在包含的 quickbook 文件中使用 doc info 块。
- 更好地处理同名宏。
- block 元素。
- 更好地处理重要的标点符号（例如转义符、方括号）。
- 支持链接、锚点、图像、包含等中的转义符。
- 改进的表格标题语法。
- 嵌套在列表中的段落。
- 新的 docinfo 属性
  - compatibility-mode 使升级文档成为可能，而不会破坏 id。
  - xmlbase 用于转义的 xi:include。
- 允许在 doc info 块之前或没有 doc info 块的情况下使用一些 docinfo 属性 (quickbook, compatibility-mode, source-mode)。
- 仅向图像添加显式 alt 文本。
- 不要将“内联”代码块放在段落内。

版本 1.5.8 - Boost 1.50

使用 --output-deps 将依赖项写入文件 (#6691)。
修复了列表中节标签的处理。
修复了列表中缩进的代码块。
修复了语法突出显示器中 UTF-8 代码点的处理。过去将每个字节都视为一个字符。仍然无法处理组合代码点。
内部更改
- 大量的重组。
- 停止使用“v3”文件系统路径和命名空间，它现在是默认版本。
- 删除笨拙的侵入式引用计数实现，避免了 gcc 内部编译器错误 (#6794)，但也是更简洁的实现。
1.6 更改
- 更好地处理链接值中的括号。
- 改进了包含路径中转义字符的处理。
开始开发 1.7
- 单个实体的源模式。
- 代码块中的标注。
- docinfo 块中转义的 docbook。
- 开始实现从链接值调用模板。

版本 1.5.9 - Boost 1.54

当代码块使用制表符和空格的混合缩进时，将缩进转换为空格。
在 C++ 语法突出显示器中，修复了 # 的语法突出显示，使其用于行首的预处理器语句，以及其他地方的“特殊”字符 (#8510, #8511)。
将 C++11 关键字添加到语法突出显示器 (#8541)。
用于格式化 --output-deps 的隐藏选项。目前不真正供公众使用
。
1.6 更改
- 更好的模板参数解析，使其理解诸如转义标记之类的内容。
- 支持在 doc info 块中使用宏。
内部更改
- 转换为使用 boost::string_ref。
- 清理源映射实现（用于获取模板和代码片段等错误消息的正确位置）。

版本 1.6.0 - Boost 1.55

从 1.6 中删除列表中的嵌套块，移至 1.7。（仍然可以在列表中嵌套块元素）。
在嵌套块元素之后不要跳出列表。
检查写入依赖文件时是否出错。
改进的列表标记。
使使用标点符号标识符转义模板成为非法。使用字母数字标识符转义模板仍然可以。
修复了文件开头代码块的检测。
XML 编码 change_log.qbk 宏的内容。
1.7 更改
- 使在错误上下文中使用元素成为错误。
- 如果 phrase 元素的主体无法解析，则报错。
- 嵌套块中的列表标记。
- 允许在 phrase 模板中使用块元素。
- 使在 phrase 模板中放置段落分隔符（即空行）成为错误。
内部更改
- 清理 id 管理器实现。

版本 1.6.1

更好的链接 URI 编码。
额外的属性值验证。
1.7 更改
- 改进的源模式标记
  - 适用于列表和段落。
  - 如果在标记元素内更改了源模式，则该更改现在将在元素之后持续存在。
  - 标记的节现在将对整个节使用源模式。
- 从锚点、角色和包含元素调用模板。
- 更严格地处理在属性值中调用的模板。
- Glob 支持。

版本 1.6.2 - Boost 1.61

为 xinclude 生成更好的文件 URL。

版本 1.6.3 - Boost 1.64

改进了一些错误消息。
修复 --no-self-linked-headers 选项。
在帮助文本中隐藏“debug”命令行选项。
更改测试和构建设置以支持持续集成。
修复了使用无参数调用模板时发生的崩溃。仅影响 quickbook 版本低于 1.5 的文件。

版本 1.6.4 - Boost 1.65

所有语言版本的更改
- endsect 现在可以有 id，如果它与当前节不匹配，则会报错。
1.7 更改
- 现在可以在宏未定义时写出条件内容，使用 [?!macro_name content]。
支持使用 --strict 参数进行严格解析。这仍在开发中，因此可能会添加新的错误。
--no-output 命令行参数，用于处理 quickbook 文档，但不实际生成任何文件。

版本 1.7.0 - Boost 1.66

最后一个使用 C++03 编译的版本。
对一些警告和错误消息的细微改进。
停止规范化依赖项列表中的路径。
当 xmlbase 与现有的 xinclude base 位于同一目录时，修复 xmlbase。

版本 1.7.1 - Boost 1.67

现在使用 C++11，不再使用 C++03 编译器进行测试。
修复了使用新版本 Spirit 解析转义的 docbook。
使用 clang-format 重新格式化代码。

版本 1.7.2 - Boost 1.68

更多地使用 C++11 功能。
一些基本的直接 HTML 生成（即不使用 BoostBook）。在命令行中使用 --output-format html 生成分块 HTML，使用 --output-format onehtml 生成单个 HTML 页面。

使用 --boost-root path 选项传递 boost 发行版的根路径也很有用。或者在 boost 之外使用，--css-path 和 --graphics-path 选项。

虽然这尚未准备好用于生产环境，但如果您没有设置 boostbook，则快速预览 quickbook 文档的更改可能很有用，尤其是在您没有设置 boostbook 的情况下。