变更日志

1.1 版 - Boost 1.33.0

第一个包含在 Boost 中的版本。

1.3 版 - Boost 1.34.0 到 1.34.1

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

1.4 版 - Boost 1.35.0 到 1.40.0

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

1.5 版 - Boost 1.41.0 到 1.42.0

支持在文档信息中使用多个版权条目。
改进的 SVG 支持。
[globalref] 用于引用 BoostBook 实体。
出错时失败。
修复了参数过多或尾随空格的模板崩溃问题。
改进了对代码块中意外字符的处理。
改进了对代码块中不匹配转义的处理。
支持 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 属性的支持。
改进的锚点实现。尤其是在章节或标题之前使用锚点时。
修复了更多包含注释的行被视为空行的问题。
允许在条件短语中使用导入、包含和 xinclude。未来版本将允许更多块元素。
重新排列语法的结构。
使用文件系统 3。删除 cygwin 1.5 支持。

Boost 1.46.1

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

1.5.5 版 - Boost 1.47

调整标题的锚点位置。
将 Quickbook 路径硬编码到 Quickbook 测试工具中。这意味着它们可以从多个位置使用。
为 boostbook bridgehead 元素生成 ID。这导致更一致的 html，因为如果 docbook 没有 ID，则会生成随机 ID。
改进的 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

一些内部更改。
一些改进的错误消息。
更好地处理在短语上下文中展开的块模板。
避免空简单标记（即 // 不被视为斜体空空格）。
改进的标题锚点标记，应该更适合打印 - 由 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）。
- 仅向图像添加显式替代文本。
- 不要将“内联”代码块放在段落内。

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 版更改
- 使在错误的上下文中使用元素成为错误。
- 如果短语元素的主体无法解析，则出错。
- 嵌套块中的列表标记。
- 允许在短语模板中使用块元素。
- 使在短语模板中放置段落分隔符（即空行）成为错误。
内部更改
- 清理 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 选项。
在帮助文本中隐藏“调试”命令行选项。
对测试和构建设置的更改，以支持持续集成。
修复在没有参数的情况下调用模板时的崩溃。仅影响 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 编译的版本。
对一些警告和错误消息的少量改进。
停止在依赖项列表中规范化路径。
修复与现有 xinclude 基目录相同的 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 选项。

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