问题标签 [maml]

在 sandcastle 中编辑 MAML 文件，并且需要在代码元素中将值显示为斜体、粗体或可识别的颜色。

例如以下不起作用：

是否可以突出显示稍后将在描述性段落中提到的一些代码？

我正在使用 Azure 管理库开发一个 windows phone 应用程序来管理我的 Azure 网站。我使用 Azure Active Directory 进行身份验证，如此处所述，一切对我来说都很好。但是当其他用户使用他的帐户登录时，我收到“AuthenticationFailed：收到的 JWT 令牌发生安全令牌异常”错误。

有什么方法可以让任何拥有 Azure 订阅的人都可以访问我的 Windows Phone 应用程序？如何处理此身份验证问题以使用 MAML？

我正在尝试使用Microsoft ASP.NET Web API 2.2 Help Page 5.2.3为 RESTful Web 服务构建 API 文档。看起来<summary>和<param>元素的内容包含在文档中，但该<remarks>部分完全被忽略了，在我期望的描述中<returns>，我看到了<summary>. 我找不到任何文章解释帮助页面支持哪些 XML 注释标签（或者注释控制器与注释常规代码有何不同）。我想知道是否有人可以分享任何指针，特别是可以使用哪些标签，如何引用其他页面等。

有没有办法在 Sandcastle 文档中创建带有特定（自定义）标签的所有类的列表？

我正在使用自定义标签来标记我的课程中的特定行为。我在 main_conceptual.xsl 中映射了这个标签，内容显示在每个类的文档表中。

现在我想在文档中创建一个特殊页面（作为概念性内容？），它显示了所有用我的自定义标签标记的类的列表。是否有可能使用沙堡帮助文件生成器（SHFB）来做到这一点？也许在 .xsl 转换中？还是使用 MAML？

在尝试使我的 PowerShell cmdlet（用 C# 编写，未编写脚本）的文档尽可能完整的过程中，我发现了一个有趣的发现。如果我包含正确的 MAML 帮助文件（例如 MyModule.dll-Help.xml），则显示具有一个或多个别名的 cmdlet 参数的帮助可能如下所示：

另一方面，如果我删除该帮助文件并重新加载我的模块，则相同参数的帮助——现在只是从代码本身中反映出来——Get-Help可能如下所示：

注意Aliases属性在第二个实例中的存在和在第一个实例中的不存在。

当然，第一时间认为我的 MAML 一定是不正确的。考虑到通过广泛的网络搜索，我还没有找到任何远程的东西，比如 MAML XML 模式的明确来源（！），这种可能性更有可能。但是，如果我的 MAML 不正确，那么用于 PowerShell 自己的核心 cmdlet 的 MAML 也是如此，因为这是我从那里复制它的地方，考虑到它是可靠的来源 (C:\Windows\System32\WindowsPowerShell\v1.0\ en-US\Microsoft.PowerShell.Commands.Management.dll-help.xml）。

但问题的关键证据是，即使该文件中的某些 PowerShell 核心 cmdlet 具有别名，它们也不会在您调用 Get-Help 时报告别名！这是一个例子：

下面是 MAML 定义DomainName参数的开头——注意末尾定义Add-Computer的别名：

因此，Get-Help当它必须通过反射自己完成工作时，它知道如何报告别名，但在 的aliases属性中提供时它无法报告别名<command:parameter>。

问题

真正的问题是什么？

1. Get-Help 期望别名 aliases在<command:parameter>.
2. 给定 MAML 文件时，Get-Help 根本无法在 MAML 中查找别名。

如果 (1)，并且有人可以识别指定别名的正确方法，那么对于我自己的 cmdlet，有一个简单的解决方法。如果 (2)... 是时候在 Connect 上提出问题了！

我正在尝试使用<codeEntityReference>MAML 元素创建指向自定义扩展方法的链接，并且在构建文档后，我将获取整个<codeEntityReference>标记内容，而不是指向整个方法的链接。

该方法的一个示例是：

<codeEntityReference>看起来像<codeEntityReference>M:SampleProject.ExtensionMethods.SomeExtension{T}(TObject)</codeEntityReference>

上面的链接将产生类似M:SampleProject.ExtensionMethods.SomeExtension{T}(T)的输出。

实际上，我在文档构建期间收到以下错误：

警告：BuildAssembler：警告：ResolveReferenceLinksComponent：[52e40f26-3dfe-47e0-adf1-09233e98f42e] 未知参考链接目标'M:SampleProject.ExtensionMethods.SomeExtension{T}(T)'

我错过了什么吗？那里有什么问题？我试图提供方法参考：

...但它并没有解决问题。

我正在按照 Sandcastle 的 MAML 指南链接到我的帮助文件中的文档页面（我正在引用的确切页面）。
我遇到的问题是该linkText属性似乎没有被考虑在内，即使我以与指南相同的方式使用它（我什至复制/粘贴了示例代码并且它没有做它声称它应该）。
我的文档中有几个部分，如下所示：

我可以确认链接正常工作，每个链接都会将我带到所需的页面，它们只是以不希望的方式显示。

codeEntityReference带有 linkText 的两行都应该显示文本。但是，所有codeEntityReference链接都显示为“MyClass”，即使一个链接指向课程页面，其他链接指向成员页面。这有点令人困惑......

我正在使用 MAML 编写词汇表。例如：

这会起作用，但我想知道我是否可以像使用<relatedEntry termId="[some term id]" />元素作为定义的一部分而不是使用常规<link>元素那样引用术语。

我有一个公开许多命令的大类。当我为类创建文档时，方法按字母顺序排序，但我希望它们按功能分组。有没有办法（使用 DocFx 的 Sand Castle Helpfile 构建器）来完成这个？

我申请torch.nn.DataParallel网络。网络用于分段，所有模块均由torch.nn.functional代替构建torch.nn。所以接下来，我需要将图像和权重输入网络：net(images, net.parameters())。详细过程，例如。卷积运算：x = F.conv2d(x, w, b, stride=param[4], padding=param[5], dilation=param[6])，我需要输入权重w和偏差b提取net.parameters()
但是，当我使用torch.nn.DataParallel：

，返回net.parameters()将是 a GeneratorType，它不能复制到 gpu 设备 1（我使用 2 GPU：设备 0 和 1 进行训练），错误是：

我尝试使用weights.to('cuda:1')，但似乎是因为权重的类型<class 'torch.nn.parameter.Parameter'>不是torch.Tensor，在这样做之后，权重仍然存在cuda:0。

我也尝试制作net.parameters()一个列表并将其输入到网络中，伪代码：

但是当处理网络时torch.nn.DataParallel，图像的第一维在第一维上被分割，图像在每个 GPU 上的形状从 [4, 3, 224, 224] 到 [2, 3, 224, 224]（批量大小为 4 和使用 2 个 GPU）。然而，权重也在第一维上被分割，例如。一个 conv 权重形状为 [64, 3, 7, 7]，当向前时，它变为 [32, 3, 7, 7]。

所以似乎进退两难了，list和generator都不能输入网络？我做了一个few-shot分割任务，参考了MAML算法。