问题标签 [maml]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
sandcastle - 是否可以使用 MAML 在代码元素内将文本标记为斜体
在 sandcastle 中编辑 MAML 文件,并且需要在代码元素中将值显示为斜体、粗体或可识别的颜色。
例如以下不起作用:
是否可以突出显示稍后将在描述性段落中提到的一些代码?
azure - Azure 管理库中的 Azure Active Directory 身份验证错误
我正在使用 Azure 管理库开发一个 windows phone 应用程序来管理我的 Azure 网站。我使用 Azure Active Directory 进行身份验证,如此处所述,一切对我来说都很好。但是当其他用户使用他的帐户登录时,我收到“AuthenticationFailed:收到的 JWT 令牌发生安全令牌异常”错误。
有什么方法可以让任何拥有 Azure 订阅的人都可以访问我的 Windows Phone 应用程序?如何处理此身份验证问题以使用 MAML?
asp.net - 我应该在控制器方法上使用哪些 XML 注释标记 Microsoft ASP.NET Web API 帮助页面?
我正在尝试使用Microsoft ASP.NET Web API 2.2 Help Page 5.2.3为 RESTful Web 服务构建 API 文档。看起来<summary>
和<param>
元素的内容包含在文档中,但该<remarks>
部分完全被忽略了,在我期望的描述中<returns>
,我看到了<summary>
. 我找不到任何文章解释帮助页面支持哪些 XML 注释标签(或者注释控制器与注释常规代码有何不同)。我想知道是否有人可以分享任何指针,特别是可以使用哪些标签,如何引用其他页面等。
.net - 在沙堡文档中列出所有带有特定(自定义)标签的类
有没有办法在 Sandcastle 文档中创建带有特定(自定义)标签的所有类的列表?
我正在使用自定义标签来标记我的课程中的特定行为。我在 main_conceptual.xsl 中映射了这个标签,内容显示在每个类的文档表中。
现在我想在文档中创建一个特殊页面(作为概念性内容?),它显示了所有用我的自定义标签标记的类的列表。是否有可能使用沙堡帮助文件生成器(SHFB)来做到这一点?也许在 .xsl 转换中?还是使用 MAML?
powershell - Heisenberg 在这里:PowerShell 参数的别名仅在您不记录 cmdlet 时出现在 cmdlet 帮助中
在尝试使我的 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>
。
问题
真正的问题是什么?
- Get-Help 期望别名
aliases
在<command:parameter>
. - 给定 MAML 文件时,Get-Help 根本无法在 MAML 中查找别名。
如果 (1),并且有人可以识别指定别名的正确方法,那么对于我自己的 cmdlet,有一个简单的解决方法。如果 (2)... 是时候在 Connect 上提出问题了!
c# - 沙堡 developerHowToDocument 上的 codeEntityReference 方法
我正在尝试使用<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 - 代码实体参考链接文本不起作用
我正在按照 Sandcastle 的 MAML 指南链接到我的帮助文件中的文档页面(我正在引用的确切页面)。
我遇到的问题是该linkText
属性似乎没有被考虑在内,即使我以与指南相同的方式使用它(我什至复制/粘贴了示例代码并且它没有做它声称它应该)。
我的文档中有几个部分,如下所示:
我可以确认链接正常工作,每个链接都会将我带到所需的页面,它们只是以不希望的方式显示。
codeEntityReference
带有 linkText 的两行都应该显示文本。但是,所有codeEntityReference
链接都显示为“MyClass”,即使一个链接指向课程页面,其他链接指向成员页面。这有点令人困惑......
.net - Sandcastle 中术语定义中其他术语的链接
我正在使用 MAML 编写词汇表。例如:
这会起作用,但我想知道我是否可以像使用<relatedEntry termId="[some term id]" />
元素作为定义的一部分而不是使用常规<link>
元素那样引用术语。
c# - 如何按区域或其他文档分组方法对方法进行分组?
我有一个公开许多命令的大类。当我为类创建文档时,方法按字母顺序排序,但我希望它们按功能分组。有没有办法(使用 DocFx 的 Sand Castle Helpfile 构建器)来完成这个?
python - 使用torch.nn.DataParallel时如何避免非图像张量被分割?
我申请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算法。