您如何追踪您的代码片段?

您如何追踪您的代码片段?

如果你已经使用 LaTeX 一段时间了,我相信你已经掌握了一些你想重复使用的小技巧和代码片段。例如,以你喜欢的方式设置包的特定方法。listings或者hyperref修改格式某些方面的小技巧(我个人最喜欢的技巧之一是这个技巧)。现在,您不想不断地回到旧.tex文件来尝试查找如何做某事。

问题是:你如何追踪所有这些片段?

答案1

我不仅为自己维护这样的收藏,而且为整个出版制作团队维护这样的收藏。当我遇到一个常见问题的好的解决方案时,我会创建一个具有“明显”名称的小型自文档文件,对其进行处理,并将所有生成的文件放入名为的区域中howto。该区域中的“第一个”文件称为00index,我将一个简短的条目放入其中,说明测试文件的用途及其名称。

我发现自文档功能特别有用。它取决于包verbatim,一般的想法是这样的:

\documentclass{...}
\usepackage{verbatim}
... % definitions here
\begin{document}
... % illustrative example here
\vspace{2\baselineskip}
\verbatiminput{\jobname.tex}
\end{document}

输出显示示例,后面跟着文件的完整内容,以便可以与输出一起研究输入。打印的输出可以轻松归档到活页夹中以供离线参考。索引也可以输入到 wiki 中,并带有指向 pdf 输出的链接。

答案2

对于 MacOS XI 强烈推荐符号速度。从概念上讲,它是带有增量搜索的索引卡集合。我将 TeX(和其他)代码片段保存在那里。查找代码片段就像开始输入我记得的任何内容一样简单。Notational Velocity 是开源的。

符号速度的屏幕截图

答案3

这取决于它是什么。如果它是实际的 TeX 代码,那么我要么为它创建一个新的样式文件(我将其保存在 BZR 存储库中),要么将其添加到我的“默认”样式文件中(我几乎每次都会加载它)。每一个我编写的文档,也是版本控制的)。如果这是做某事的方法,那么我会写一个简短的说明并将其放在我的网页上。我有一个名为“我是如何做到的?”的区域。简介如下:

这里收集了大量提示、技巧和指南,我曾经使用它们来让我的计算机按照我希望的方式运行(而不是我按照它们希望我的方式运行)。通常这些只需要做一次,直到我做了一些愚蠢的事情,比如升级我的系统。然而,到那时,我通常已经忘记了我做任何事情的细节。所以我开始记笔记。我转而将这些笔记保存在博客中,因为我发现最有用的资源是其他人的博客,解释他们如何让他们的 xterms 中的文本变成淡紫色。所以我把这些放在这里,以防它们对别人有用。

LaTeX 特定部分是这里(尽管该站点周围还分布着一两个其他站点)。

我经常发现,写下来的行为本身就让记忆深入骨髓,所以我并不经常查看笔记集!但如果没有,我就会需要它。

答案4

我的粗略方法(用于 Java,但理论上适用于任何代码)是将代码放入公共论坛或网络上的另一个“代码位置”(希望是稳定或镜像的,或两者兼有)。然后在需要时使用搜索引擎查找它。

相关内容