问题标签 [cross-reference]

我正在为我的 Python 模块（使用 Sphinx 和 reST）编写文档，并且我发现当交叉引用其他 Python 对象（模块、类、函数等）时，完整的对象名称最终会非常长。通常它超过 80 个字符，我想不惜一切代价避免。

这是一个例子：

问题是，在为RealLongExampleClassName类创建文档时，我为 full path name 生成了它module1.module2.module3.module4.module5.ReallyLongExampleClassaName。

我想知道有没有办法解决这个问题？我尝试了以下方法，但没有成功：

1）在模块名称中间添加换行符。例子：

2) 以不同的（但仍然是 Python 可导入的）方式引用类名。例子：

我相信，由于文档ReallyLongClassName与完整路径名相关联，Sphinx 无法将缩短版本与完整命名版本相关联。

编辑 2012 年 4 月 5 日：

根据 j13r 的回答/建议（见下文），我尝试了以下方法：

这很成功。让它工作的唯一警告是，第二行之前不能有空格（在文档字符串中使用它时非常令人沮丧）。因此，要使我的原始示例工作，它看起来像：

好看，也丑。如果您要在之前放置空格ReallyLongExampleClassName以将其缩进到与它上面的行相同的级别，则输出将包含空格，因此 Sphinx 将尝试引用类似module1.module2.module3.module4.module5.ReallyLongExampleClassName.

我还应该注意，我尝试了其他两种变体，但没有奏效：

我正在寻找一个不涉及破坏文档字符串格式的解决方案，但我想它会这样做......我认为我实际上更喜欢超过 80 个字符的行。

感谢 j13r 的回答！

有谁知道是否可以从另一部分的文本中引用另一部分，例如从“摘要”部分引用“返回”部分，反之亦然（在给定方法的文档中），并具有由生成的超链接编译器？（我最初的问题是如何从“摘要”中引用返回值，对于带有“paramref”的参数或带有“cref”的其他成员/类等已经可能。然后我意识到这个问题只是一个我的问题中描述的更一般的情况的特殊情况）。

是否有相当于 opengrok 或任何带有 php 前端的代码索引器工具？

谢谢！

考虑到主 html 应用程序中定义的脚本文件的顺序很重要，有没有办法交叉引用来自不同命名空间的类的实例或实例变量。实际上我想知道是否有可能交叉引用两个不同的类实例，一个指向在不同命名空间中定义的引用，另一个在第二个类中定义的变量指向第一个。

假设我有一个main.js文件，我在其中定义了一个类，该类使用在另一个命名空间中定义的一些实例变量，比如说 in particle.js，同时我定义了一个指向Main类公共变量的变量。

...并且在*.htmljavascript 文件中的顺序是：

实际上，例如，如果您在 firebug 上尝试此代码，则该代码可以按预期工作，但是在我的真实应用程序上使用相同的逻辑，这非常复杂，我Main is undefined在控制台中遇到错误。我知道可以使用 AMD 和 Require.js 来模拟真实的类模块，但我现在不想继续使用 AMD。

我有三张桌子：

• 文章(idArticle,NameArt)
• 标签(idTag, NameTag)
• ArtiTag(idArticle,idTag)

我想要这样的结果：NameTag,Count(属于该标签的文章)

我尝试了以下方法：

但它总是只返回一行，即使我有很多标签和很多相关文章

我创建了一个应用程序，它将以二进制形式打印出时间。逻辑工作得很好，但是当我尝试将逻辑和 GUI 分开时，我遇到了一些问题。似乎有一个交叉引用问题，但我似乎无法找到它。

主要活动：

逻辑类：

logcat 的摘录：

我知道如果可以避免，逻辑不应该知道 GUI。我应该初始化逻辑类中的按钮吗？在这种情况下，如何初始化？

我有几个表：SW_Report、SW_List、Manual_Install、Cloud_Install 和 SW_Exclusion。SW_Report 有一个字段 Computer_Name（例如：CN1）和 App_Name（例如：iTunes），其中每个用户计算机上安装的每个应用程序都有一行（例如：CN1 - iTunes，CN1 - Adob​​e，CN2 - iTunes...）。（SW_List 有一个字段 App_Name（例如：iTunes）和 App_ID（例如：1001）。Manual_Install 是由另一个项目团队构建的表，其中包含 Tested_Apps 列表（命名约定略有不同）（例如：iTunes 10.1_EN_US）和 App_ID （例如：n001）（不可能在运行查询时仅测试应用程序是否包含名称）。Cloud_Install 也是如此（Cloud_App 和 App_ID - 它们都与上述任何表都不一致。

我已手动将 Manual_Install 和 Cloud_Install 中的 ID 映射到 SW_List 中相应的 App ID，并将它们命名为 Manual_SW_Xref 和 Cloud_SW_Xref。我需要做的是构建一个查询，查看安装在每个唯一 Computer_Name 上的每个 App_Name，检查它是否列在 Manual_SW_Xref 和 Cloud_SW_Xref 中，并仅返回两个列表之一中包含 SW 的 Computer_Name 列表。

有什么想法吗？我需要一个起点。谢谢你。

我正在设计一个表格，该表格将用于与结构交叉引用：

在网页上，人们将输入 cuid 或术语，程序将查找相​​应的 id 以在程序内部使用。数据库中共有 2,669,793 个条目（因此 id 将跨越 0 - 2669792）。

我预计这可能会相当缓慢。我应该使用什么技术来确保尽可能快的查找？查询将类似于SELECT id WHERE cuid = ?or SELECT id WHERE term = ?。

由于我没有在 WHERE 子句中查找 id 本身，因此我看不出我将如何从索引中受益（尽管 id 本来就会被索引）。我听说过诸如将单个表分解为多个表并进行某种合并操作之类的事情。有什么想法吗？谢谢。

我对编程很陌生。我正在使用 Visual Basic 2010。我有一个名为 CoreDataSet 的 Access 数据源，它有三个表：Rates、Vendors、Zones。I have binded the Vendors table to two Combo boxes, when a Vendors' Name is selected the first three digits of their zip code appears in a label next to the corresponding combo box. 我想使用这两个标签（或两个 3 位邮政编码）并交叉引用“区域”表。zone 表的顶部有一个三位数的 zip 列表（列名）和第二列的三位数 zip，如下所示（示例）：

因此，从邮政编码 022 到 021 的运输将是 ZONE 3，而从 022 到 022 的运输将是 Zone 1。目标是选择两个供应商（每个组合框中一个）并在标签 1 和 2 中显示它们的 3 位数拉链（完成) 以及标签 3 中适用于它们的 UPS 区域（未完成）。交叉引用甚至可能吗？请帮忙，谢谢。

我得到了一半的工作。我已经完成了一个查询（QueriesTableAdapter.query1），如下所示：

我的VB代码是：

这将选择从 020 shipping 到输入 label2 的任何 zip 的区域，并且工作正常。但是，我需要选择各种“发货人”，而不仅仅是 020...

不起作用。如何在 select 子句中使用参数或让它将 Label1 的值识别为要选择的列？

我有两个这样的表：

如何交叉引用第一个表中的 classID 以将类加入视图中的表 1？

任何帮助深表感谢！