如何组织一篇包含多个方面的文章?

如何组织一篇包含多个方面的文章?

我正在为我们的游戏引擎中的一个组件(粒子系统)编写参考手册。这个系统中有很多模块。每个模块都有一个模块类型。我可以按类型为每个模块类型编写规范。

但是,不同模块类型的多个模块可能会协作完成一项任务。因此,我想“逐个任务”地为每个模块编写规范。

我认为两个方面不适合放在一个以“章节-部分-子部分”为根的树状结构中。我不想在两个单独的章节中重复模块的规范文本。

为了使我的问题更清楚,我在这里写了一些预期的 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 的常规用法,因此我在上面提出了一个更一般的问题,以允许一种不同但优雅的解决方案。

相关内容