ruby – 如何在YARD文档中创建任意链接？

发布时间：2020-12-17 02:57:54 所属栏目：百科来源：网络整理

导读：我正在尝试在YARD文档中创建一些链接.我可以获得HTTP链接： # I like {https://stackoverflow.com Stackoverflow} 呈现为 pI like a href="https://stackoverflow.com"Stackoverflow/a/p 但是电子邮件链接： # You can email the {mailto:bugs@myproject.com

我正在尝试在YARD文档中创建一些链接.我可以获得HTTP链接：

# I like {https://stackoverflow.com Stackoverflow}

呈现为

<p>I like <a href="https://stackoverflow.com">Stackoverflow</a></p>

但是电子邮件链接：

# You can email the {mailto:bugs@myproject.com bugs} list

给我一个警告：

[warn]: In file `':: Cannot resolve link to mailto:bugs@myprojectmailto:bugs@myproject.com from text:

并呈现为

<p>You can email the <tt>bugs</tt> list</p>

我已经尝试了常规的RDoc语法链接：

bugs[mailto:bugs@myproject.com]

但是YARD似乎忽略了这一点.有谁知道更可靠的语法？

解决方法

深入研究YARD的代码显示了问题：in
宝石/码 – 0.2.3.5 / lib /码有线(73)：

if name.include?("://")

这不允许mailto链接.您可以用此替换此行

if name.include?("://") or name.include?("mailto:")

它会按你的意愿工作……不完全理想,但这就是我现在所拥有的一切.

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!