LaTeX 文档与实验记录同步

$\text{LATEX}$ 文档与实验记录同步

背景介绍

有实验记录文件，想把实验记录写到 $\text{LATEX}$ 文档。但手动把实验记录敲到文档内工作量大且繁琐。如果重跑实验，更新了实验记录文件，就不得不再次手动输入，徒增工作量。有没有办法减少这种意义不大的重复劳动？

只要有数据就自动（或简单的命令）同步到$\text{LATEX}$文档。

要实验这个功能， 我们需要获取两种信息。
第一是实验数据。 第二是数据在文档的位置。
对于实验数据，每个实验都不同，要对症下药。
对于文档的位置，可以用在某些特殊语句在 $\text{LATEX}$ 文档中做标记。

能被 $\text{LATEX}$ 正确编译，并且编译后不显示的语句有两类：注释和宏。
注释不适合行内插入， 如

...，其中输入变量 $x$ 为 % 插入实验数据 x
,$y$ 为 % 插入实验数据 y
...

而宏同时适合行间和行内插入， 如

..., 其中输入变量 $x$ 为 \insertVarX, $y$ 为 \insertVarY ...

令
\insertSomeThing
...

所以我们选择宏的实现方案。 接下来考虑宏的设计。
如果每一个插入位置都要定义一个宏，那么导言区要写很多宏，扩展能力很差。
所以，我们只用一个宏。

% 导言区

% 接收两个参数。
% 第一个参数为数据标记，不显示；
% 第二个为具体的数据，由外部程序填充。
\newcommand{\syncrecord}[2]{#2} 

% 文档
..., 其中输入变量 $x$ 为 \syncrecord{insert_x}{0.1}, $y$ 为 \syncrecord{insert_y}{0.2} ...

令
\syncrecord{insert_anything}{}

前期准备

• $\text{L}$