如何有效避免混乱的标签系统?

如何有效避免混乱的标签系统?

在科技写作中,我发现诸如\label{eq:eqnum}、、、、\label{eq:eqmeaning}等标签系统并不令人满意。\label{thm:thmnum}\label{thm:thmmeaning}\label{thm:thm_name}

  1. 对于数字版本标签系统,例如\label{eq:eqnum},当我插入/删除某个方程时,方程/定理的编号就会发生变化,跟踪编号会很麻烦。
  2. 对于“意义-名称”标签系统,可能存在太多具有相似含义的方程式,因此很难在可接受的长度内相互区分。

那么标签制度有什么原则或建议吗?

答案1

如果标记的对象表现出任何类型的主题分组,则可以通过:在标签字符串中使用多个来引入名称空间:\label{eq:category:meaning}。如果仔细选择这些类别,它们甚至可以优雅地扩展到大型(书籍大小)文档。

不过我建议反对简单地使用章节或部分名称作为category,而是共同话题标记对象共享。这样,即使文档结构发生巨大变化,标签仍能保持其正确含义。

答案2

在字符串中使用打印的数字\label总是错误的,它破坏了系统自动编号的整个\label原因\ref

如果您发现它有用,那么使用类似的方案eq:meaning是有用的,但如果您发现思考简短的“含义”很困难,那么使用起来就没那么有用了。

我个人会\usepackage{showkeys}在起草时使用,这样标签名称是可见的,\label直到我需要引用特定方程或定理或其他东西时才使用。此时,如果方程式还没有标签,只需添加一个:\label{eq:some-meaning}如果您愿意,任何东西都可以,或者只是\label{x}:可能发生的最糟糕的情况是您意外使用了一个已经使用过的标签,但乳胶会在您处理文档时立即警告您。

相关内容