在文档中设置包选项的最佳实践

在文档中设置包选项的最佳实践

我目前正在开发一个软件包,用户可以在文档中间或本地组中设置软件包选项。目前,用户可以通过用户命令\set<package>keys或执行此\reset<package>keys操作,这些命令首先将软件包选项重置为默认值,然后再设置新选项。我打算仅在文档级别使用这些命令;不应直接在序言中使用它们。

我的问题是:命名这些命令的最佳做法是什么?我的困惑来自另一个 stack exchange 帖子 包选项与安装命令 其中最佳答案建议软件包作者提供一个名为 的用户命令\<package>setup。此外,许多其他软件包也遵循相同的约定:siunitxuses \sisetupunicode-mathuses \unimathsetupmicrotypeuses等。但是,我发现与我当前的软件包相反,\microtypesetup该名称意味着 (1)可以/应该直接在序言中使用,以及 (2)设置软件包选项\package<setup>\<package>setup\<package>setup全球而不是本地

我将标签添加expl3到我的问题中,因为我目前正在编写一个包expl3。此外,包选项是通过l3keys和定义的\ProcessKeyOptions

相关内容