yard, How to include image to documentation?

Question

I want to include image in yard-genereted documentation, but can't find anywhere how to do this... Does anyone know how to do this?

score 2 · Accepted Answer · answered May 08 '11 at 15:54

2

You can just add <img /> tag to your documentation:

 # Blah-blah 
 # 
 # <img src=img/1.png />
 # @param [String] blah
 # @return [String] blah
 def foo(bar) 

 end

answered May 08 '11 at 15:54

Vasiliy Ermolovich

24,459
5
79
77

4

This does work for me(rails 3.1.0, Yard 0.7.2). The text is html escaped: `<img src='img/1.png' />` – Dorian Oct 20 '11 at 09:38

score 1 · Answer 2 · answered Sep 04 '16 at 03:18

1

Use rdoc-image: links:

# Gets foo.
#
# rdoc-image:img/1.png
def foo(bar)
  "foo"
end

is rendered by YARD into

<p>Gets foo.</p>
<p><img src="img/1.png"></p>

The rdoc-images: also works in standalone *.rdoc files.

answered Sep 04 '16 at 03:18

Franklin Yu

8,920
6
43
57

score 0 · Answer 3 · answered Apr 27 '12 at 06:41

Depending on your markup format you may have to use another mechanism. For instance, if you use Markdown, the syntax is ![Alt text](/path/to/img.jpg). In RDoc, an img tag should work, but you can check if they have added a special markup syntax for this. Note that RDoc probably (not sure) doesn't like XHTML, you should use with no ending /.

yard, How to include image to documentation?

3 Answers3