我正在为我们的游戏引擎中的一个组件(粒子系统)编写参考手册。这个系统中有很多模块。每个模块都有一个模块类型。我可以按类型为每个模块类型编写规范。
但是,不同模块类型的多个模块可能会协作完成一项任务。因此,我想“逐个任务”地为每个模块编写规范。
我认为两个方面不适合放在一个以“章节-部分-子部分”为根的树状结构中。我不想在两个单独的章节中重复模块的规范文本。
为了使我的问题更清楚,我在这里写了一些预期的 LaTeX:(我不知道这个例子是否涉及太多领域知识。如果是这样,我会尝试写另一个)
\chapter{Modules by type}
\section{Initializer}
\subsection{Position}
% ...
\tasks{Simulation, Rendering}
% Every task tag should be linked to corresponding task section.
\subsection{Color}
% ...
\tasks{Rendering}
\section{Operator}
\subsection{Integrator}
% ...
\tasks{Simulation, Rendering}
\chapter{Modules by task}
\task{Simulation}
% ...
\listrelatedmodules{Simulation}
% Modules with "Simulation" task tag should be listed here.
\task{Rendering}
% ...
\listrelatedmodules{Rendering}
上述代码只是我预期的完成工作的方式之一。而这个问题并不局限于让该代码工作。我希望听听您对多个方面组织的建议。
[更新]
谢谢你的建议。
我尝试在这里使这个问题更加具体。
假设我在一个章节中有一个(子)部分(在原始陈述中为“位置”、“颜色”、“积分器”)的集合。
每个部分可能属于几个类别(我在原始陈述中称之为“任务”)。
稍后在另一章中,我想列出每个类别的上述部分自动地。在原始疑问句中,我使用了一个虚构的命令来\listrelatedmodules{<category>}
调用这个。
一般来说,我的目标是让每个部分都注册到一个文档级列表中。然后我可以遍历这个列表变量来输出该列表中的引用。如何在 LaTeX 中做到这一点?
PS:我不确定这种方法是否是 LaTeX 的常规用法,因此我在上面提出了一个更一般的问题,以允许一种不同但优雅的解决方案。