在 tex 中维护变更历史的最佳实践

在 tex 中维护变更历史的最佳实践

每当我编写协作文档时,它都会经历大量的草稿更改。除了在 svn 中维护更改历史记录外,我如何在 tex 文档本身中维护更改历史记录?我还希望它反映在生成的 pdf 上。

答案1

如果您想要显示以下四项的修订历史记录表,您应该查看历史包裹。

  • 版本
  • 日期
  • 作者
  • 变更摘要

如果您想要 SVN 中的精确修订历史记录,那么这个软件包可能不适合您,因为此修订历史记录表是在 LaTeX 文档中创建的。我发现这很有用,因为我想要一个比每次小签到更简洁的修订历史记录表git

示例 vhistory 代码

\usepackage{vhistory}
\begin{document}
% Start of the revision history table
\begin{versionhistory}
  \vhEntry{1.0}{22.01.04}{JPW|KW}{created}
  \vhEntry{1.1}{23.01.04}{DP|JPW}{correction}
  \vhEntry{1.2}{03.02.04}{DP|JPW}{revised after review}
\end{versionhistory}

tablegrid如果您想“在表中显示代表修订历史记录的网格”,请使用该选项。

示例 vhistory 输出

在此处输入图片描述

答案2

我之前曾使用过svninfo前面提到过的 Herbert。

但我最近发现vc bundle。它的优点/不同之处在于,它不仅可以跟踪包含的.tex文件,还可以跟踪目录中的任何文件。您将获得全局修订,包括图像或.bib文件。除了 svn,它还支持 bzr 和 git。

另一方面,它是一个外部 shell 脚本,而不是 LaTeX 包。此外,您只会获得全局修订号,而不是根据当前文件等svninfo提供的更细粒度的结果。

补充:由于它不使用 svn 属性和 TeX 文件中的特殊行,因此它完全独立于方法svninfo,您甚至可以结合两种变体。

答案3

我使用包遥控系统并把

\usepackage{rcs}

在序言中。然后是如下几行:

\RCS $Id:$
\RCS $Source:$
\pagestyle{myheadings}
\markright{\RCSId}

将版本信息放入格式化的文档中。

我注意到还有一个包rcs信息具有类似用途,但没有使用过。

相关内容