Pandoc-crossref v0.3.19 版本发布：增强列表隐藏与模板变量功能

Pandoc-crossref v0.3.19 版本发布：增强列表隐藏与模板变量功能

pandoc-crossref Pandoc filter for cross-references 项目地址: https://gitcode.com/gh_mirrors/pa/pandoc-crossref

Pandoc-crossref 是一个强大的 Pandoc 过滤器，主要用于处理学术和技术文档中的交叉引用问题。它能够自动管理图表、公式、表格等元素的编号和引用，极大简化了复杂文档的编写流程。最新发布的 v0.3.19 版本带来了一系列实用功能改进和优化。

核心功能增强

列表项隐藏机制

新版本引入了从"列表清单"（list-of-X）中隐藏特定项目的能力。这项功能特别适合需要精细控制文档中显示内容的场景。例如，在撰写论文时，可能需要在正文中引用某些图表，但又不希望这些图表出现在目录列表中。通过简单的元数据标记，用户现在可以轻松实现这种需求。

列表元数据选项

新增的listOfMetadata选项为文档模板中的"列表清单"提供了更灵活的配置方式。这项改进使得用户能够通过模板变量更精确地控制列表的生成和显示方式，为文档自动化处理提供了更多可能性。

模板变量扩展

在列表项模板中，新版本增加了更多可用变量。这些变量让用户能够更细致地定制每个列表项的显示格式，包括但不限于编号、标题和引用信息。这项改进特别适合需要遵循特定格式要求的学术出版场景。

技术优化与修复

引用排序一致性

v0.3.19 版本进一步完善了引用排序逻辑，确保内联引用也按照出现顺序正确排序。这一改进解决了在某些复杂文档中引用顺序可能不一致的问题，提高了文档生成的可靠性。

代码清理与重构

开发团队对项目代码进行了全面清理，移除了长期冗余的escapeLaTeX功能，并进行了多项代码重构工作。这些内部改进虽然不会直接影响用户功能，但提高了代码的可维护性和未来扩展性。

开发环境升级

项目现已切换到GHC2021编译环境，并默认启用了多个Haskell扩展。这一技术升级为开发者提供了更现代的编程工具链，有助于未来功能的开发和维护。

总结

Pandoc-crossref v0.3.19 版本在保持核心功能稳定的同时，通过新增的列表控制功能和模板变量扩展，为技术文档作者提供了更强大的工具。这些改进特别适合学术论文、技术报告等需要精细控制交叉引用和列表显示的文档类型。对于已经使用Pandoc生态系统的用户来说，升级到这个版本将获得更流畅的文档处理体验。

pandoc-crossref Pandoc filter for cross-references 项目地址: https://gitcode.com/gh_mirrors/pa/pandoc-crossref