كيف يمكنني إنشاء رابط تعسفي في وثائق الفناء؟

Question

أحاول إنشاء بعض الروابط في وثائق الفناء. يمكنني الحصول على رابط HTTP:

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

يجعل as.

<p>I like <a href="http://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]

لكن يبدو أن الفناء يتجاهل ذلك. هل يعرف أحد بناء جملة أكثر موثوقية؟

Answer 1

يعرض الحفر إلى رمز الفناء المشكلة: فيgems/yard-0.2.3.5/lib/yard هناك الخط (73):

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

الذي لا يسمح بروابط البريد. يمكنك استبدال هذا الخط مع

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

وسيعمل كما تريد ... ليس مثاليا تماما، ولكن هذا كل ما لدي الآن.

Answer 2

0.2.3.6 سيكون لهذا الدعم