readme_yard 0.5.0 → 0.6.0

data/docs/index.html

@@ -57,10 +57,11 @@
         <div class="clear"></div>
       </div>
 
-      <div id="content"><div id='filecontents'><h1 id="readme-yard-">Readme Yard 🌿</h1>
-<p><a href="https://badge.fury.io/rb/readme_yard"><img src="https://badge.fury.io/rb/readme_yard.svg" alt="Gem Version" /></a></p>
+      <div id="content"><div id='filecontents'><h1 id="readme-yard">Readme Yard 🌿</h1>
 
-<p><strong>Code Version: 0.4.0</strong></p>
+<p><a href="https://badge.fury.io/rb/readme_yard"><img src="https://badge.fury.io/rb/readme_yard.svg" alt="Gem Version"></a></p>
+
+<p><strong>Code Version: 0.5.0</strong></p>
 
 <p>Build a better README with <a href="https://yardoc.org">YARD</a>
 by generating it straight from the source.</p>
@@ -74,52 +75,56 @@ across your codebase and project README.</p>
 
 <p>Look at the <a href="https://github.com/mattruzicka/readme_yard/blob/main/README_YARD.md">README_YARD.md</a>
 template for this project to see how it works.
-If you’re reading the README, that means this text is here
+If you&#39;re reading the README, that means this text is here
 because the custom <code>{@readme ReadmeYard}</code> markdown tag is in
 README_YARD.md and <code>readme build</code> was run at the command line.</p>
 
-<hr />
+<hr>
 
 <p>⚠️ <strong>Generated file warning</strong> – Edit README_YARD.md, not README.md. Changes to README.md will be lost when running <code>readme build</code>.</p>
 
-<p><strong>Future Work</strong>
-- Implement safeguards to prevent accidental edits to README.md
-- Support bidirectional editing through git integration</p>
+<p><strong>Future Work</strong></p>
+
+<ul>
+<li>Implement safeguards to prevent accidental edits to README.md</li>
+<li>Support bidirectional editing through git integration</li>
+</ul>
 
 <p><a href="#contributing">PRs are welcome</a> for these improvements.</p>
 
-<hr />
+<hr>
 
 <h2 id="table-of-contents">Table of Contents</h2>
+
 <ul>
-  <li><a href="#installation">Installation</a></li>
-  <li><a href="#getting-started">Getting Started</a></li>
-  <li><a href="#command-line-usage">Command Line Usage</a></li>
-  <li><a href="#tag-usage">Tag Usage</a></li>
-  <li><a href="#readme-tag">Readme Tag</a></li>
-  <li><a href="#standalone-tag-usage">Standalone Tag Usage</a></li>
-  <li><a href="#example-tag">Example Tag</a></li>
-  <li><a href="#contributing">Contributing</a></li>
-  <li><a href="https://mattruzicka.github.io/readme_yard/">Documentation</a></li>
+<li><a href="#installation">Installation</a></li>
+<li><a href="#getting-started">Getting Started</a></li>
+<li><a href="#command-line-usage">Command Line Usage</a></li>
+<li><a href="#tag-usage">Tag Usage</a></li>
+<li><a href="#readme-tag">Readme Tag</a></li>
+<li><a href="#standalone-tag-usage">Standalone Tag Usage</a></li>
+<li><a href="#example-tag">Example Tag</a></li>
+<li><a href="#contributing">Contributing</a></li>
+<li><a href="https://mattruzicka.github.io/readme_yard/">Documentation</a></li>
 </ul>
 
-<hr />
+<hr>
 
 <h2 id="installation">Installation</h2>
 
-<p>Add <a href="https://rubygems.org/gems/readme_yard">gem “readme_yard”</a> to your Gemfile and run <code>bundle install</code> or install it yourself with: <code>gem install readme_yard</code></p>
+<p>Add <a href="https://rubygems.org/gems/readme_yard">gem &quot;readme_yard&quot;</a> to your Gemfile and run <code>bundle install</code> or install it yourself with: <code>gem install readme_yard</code></p>
 
 <p><strong>Note:</strong> As of version 0.3.0, Readme Yard requires Ruby 3.0 or higher.</p>
 
 <h2 id="getting-started">Getting Started</h2>
 
-<p>Run <code>readme build</code> at the command line. This creates a README_YARD.md file if there isn’t one by copying your existing README.md file.</p>
+<p>Run <code>readme build</code> at the command line. This creates a README_YARD.md file if there isn&#39;t one by copying your existing README.md file.</p>
 
 <p>README_YARD.md is the template from which <code>readme build</code> generates the README. Readme Yard adds the ability to embed and reference your source code in your README via README_YARD.md.</p>
 
 <p>See <a href="#tag-usage">Tag Usage</a>.</p>
 
-<hr />
+<hr>
 
 <h2 id="command-line-usage">Command Line Usage</h2>
 
@@ -131,7 +136,7 @@ README_YARD.md and <code>readme build</code> was run at the command line.</p>
 
 <p><code>readme version</code> - Prints the current version of ReadmeYard.</p>
 
-<hr />
+<hr>
 
 <h2 id="tag-usage">Tag Usage</h2>
 
@@ -141,94 +146,90 @@ README_YARD.md and <code>readme build</code> was run at the command line.</p>
 
 <h3 id="tag-reference-table">Tag Reference Table</h3>
 
-<table>
-  <thead>
-    <tr>
-      <th>Tag Type</th>
-      <th>YARD Syntax (in source code)</th>
-      <th>Markdown Syntax (in README_YARD.md)</th>
-      <th>Standalone Tag*</th>
-      <th>Purpose</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>Readme</td>
-      <td><code>@readme</code></td>
-      <td><code>{@readme ObjectPath}</code></td>
-      <td>N/A</td>
-      <td>General purpose tag to embed content from source code</td>
-    </tr>
-    <tr>
-      <td>Readme (comment)</td>
-      <td><code>@readme comment</code></td>
-      <td><code>{@readme ObjectPath}</code></td>
-      <td><code>{@comment ObjectPath}</code></td>
-      <td>Embeds only the comment from source code</td>
-    </tr>
-    <tr>
-      <td>Readme (code)</td>
-      <td><code>@readme code</code></td>
-      <td><code>{@readme ObjectPath}</code></td>
-      <td><code>{@code ObjectPath}</code></td>
-      <td>Embeds only code implementation</td>
-    </tr>
-    <tr>
-      <td>Readme (source)</td>
-      <td><code>@readme source</code></td>
-      <td><code>{@readme ObjectPath}</code></td>
-      <td><code>{@source ObjectPath}</code></td>
-      <td>Embeds both comments and code</td>
-    </tr>
-    <tr>
-      <td>Readme (value)</td>
-      <td><code>@readme value</code></td>
-      <td><code>{@readme ObjectPath}</code></td>
-      <td><code>{@value ObjectPath}</code></td>
-      <td>Embeds a Ruby value as a Ruby code block</td>
-    </tr>
-    <tr>
-      <td>Readme (string)</td>
-      <td><code>@readme string</code></td>
-      <td><code>{@readme ObjectPath}</code></td>
-      <td><code>{@string ObjectPath}</code></td>
-      <td>Embeds a Ruby string as normal text</td>
-    </tr>
-    <tr>
-      <td>Example</td>
-      <td><code>@example</code></td>
-      <td><code>{@example ObjectPath}</code></td>
-      <td>N/A</td>
-      <td>Embeds example code from YARD @example tags</td>
-    </tr>
-  </tbody>
-</table>
+<table><thead>
+<tr>
+<th>Tag Type</th>
+<th>YARD Syntax (in source code)</th>
+<th>Markdown Syntax (in README_YARD.md)</th>
+<th>Standalone Tag*</th>
+<th>Purpose</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>Readme</td>
+<td><code>@readme</code></td>
+<td><code>{@readme ObjectPath}</code></td>
+<td>N/A</td>
+<td>General purpose tag to embed content from source code</td>
+</tr>
+<tr>
+<td>Readme (comment)</td>
+<td><code>@readme comment</code></td>
+<td><code>{@readme ObjectPath}</code></td>
+<td><code>{@comment ObjectPath}</code></td>
+<td>Embeds only the comment from source code</td>
+</tr>
+<tr>
+<td>Readme (code)</td>
+<td><code>@readme code</code></td>
+<td><code>{@readme ObjectPath}</code></td>
+<td><code>{@code ObjectPath}</code></td>
+<td>Embeds only code implementation</td>
+</tr>
+<tr>
+<td>Readme (source)</td>
+<td><code>@readme source</code></td>
+<td><code>{@readme ObjectPath}</code></td>
+<td><code>{@source ObjectPath}</code></td>
+<td>Embeds both comments and code</td>
+</tr>
+<tr>
+<td>Readme (value)</td>
+<td><code>@readme value</code></td>
+<td><code>{@readme ObjectPath}</code></td>
+<td><code>{@value ObjectPath}</code></td>
+<td>Embeds a Ruby value as a Ruby code block</td>
+</tr>
+<tr>
+<td>Readme (string)</td>
+<td><code>@readme string</code></td>
+<td><code>{@readme ObjectPath}</code></td>
+<td><code>{@string ObjectPath}</code></td>
+<td>Embeds a Ruby string as normal text</td>
+</tr>
+<tr>
+<td>Example</td>
+<td><code>@example</code></td>
+<td><code>{@example ObjectPath}</code></td>
+<td>N/A</td>
+<td>Embeds example code from YARD @example tags</td>
+</tr>
+</tbody></table>
 
 <blockquote>
-  <p>*Standalone tags allow embedding content without requiring corresponding YARD tags in source code. See <a href="#standalone-tag-usage">Standalone Tag Usage</a> for details.</p>
+<p>*Standalone tags allow embedding content without requiring corresponding YARD tags in source code. See <a href="#standalone-tag-usage">Standalone Tag Usage</a> for details.</p>
 </blockquote>
 
 <h3 id="examples">Examples</h3>
 
-<p>The next line is a code snippet if you’re looking at the <a href="https://github.com/mattruzicka/readme_yard/blob/main/README.md">README</a> and <code>{@readme ReadmeYard::ExampleTag.hello_world}</code> if you’re looking at <a href="https://github.com/mattruzicka/readme_yard/blob/main/README_YARD.md">README_YARD.md</a>.</p>
+<p>The next line is a code snippet if you&#39;re looking at the <a href="https://github.com/mattruzicka/readme_yard/blob/main/README.md">README</a> and <code>{@readme ReadmeYard::ExampleTag.hello_world}</code> if you&#39;re looking at <a href="https://github.com/mattruzicka/readme_yard/blob/main/README_YARD.md">README_YARD.md</a>.</p>
 
-<p><code>ruby
-#
-# @example
-#   ReadmeYard::ExampleTag.hello_world #=&gt; "Hello 🌎 🌍 🌏"
-#
-def hello_world
-  "Hello 🌎 🌍 🌏"
-end
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'>#
+</span><span class='comment'># @example
+</span><span class='comment'>#   ReadmeYard::ExampleTag.hello_world #=&gt; &quot;Hello 🌎 🌍 🌏&quot;
+</span><span class='comment'>#
+</span><span class='kw'>def</span> <span class='id identifier rubyid_hello_world'>hello_world</span>
+  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hello 🌎 🌍 🌏</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>end</span>
+</code></pre>
 
 <p>The markdown tag tells Readme Yard to parse the <code>@readme</code> tag located above the <code>hello_world</code> class method located in <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard/example_tag.rb">lib/readme_yard/example_tag.rb</a>.</p>
 
-<p>To use another “meta” example, <code>{@readme ReadmeYard}</code> is used at the top of this project’s README_YARD.md file to generate the first few sentences of this README. <code>ReadmeYard</code> references the class located in <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard.rb">lib/readme_yard.rb</a>.</p>
+<p>To use another &quot;meta&quot; example, <code>{@readme ReadmeYard}</code> is used at the top of this project&#39;s README_YARD.md file to generate the first few sentences of this README. <code>ReadmeYard</code> references the class located in <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard.rb">lib/readme_yard.rb</a>.</p>
 
-<p>Last one, <code>{@readme ReadmeYard#command_line_usage}</code> is used to generate the “Command Line Usage” section above from the comments of the <code>command_line_usage</code> instance method located in <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard.rb">lib/readme_yard.rb</a>. This method is extra meta: it returns the result of formatting its own comments as markdown. In this way, the usage instructions in the comments, the README, and as printed at the command line will always be in sync.</p>
+<p>Last one, <code>{@readme ReadmeYard#command_line_usage}</code> is used to generate the &quot;Command Line Usage&quot; section above from the comments of the <code>command_line_usage</code> instance method located in <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard.rb">lib/readme_yard.rb</a>. This method is extra meta: it returns the result of formatting its own comments as markdown. In this way, the usage instructions in the comments, the README, and as printed at the command line will always be in sync.</p>
 
-<hr />
+<hr>
 
 <h2 id="readme-tag">Readme Tag</h2>
 
@@ -244,70 +245,62 @@ embed behavior can be changed through the use of tag names.</p>
 
 <p><strong>Usage:</strong></p>
 
-<p><code>ruby
-# @readme comment
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># @readme comment
+</span></code></pre>
 
 <p>This example <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard/comment_tag.rb">@readme comment</a> tag embeds the below code snippet via the <code>{@readme ReadmeYard::CommentTag.format_tag}</code> markdown tag.</p>
 
-<p><code>ruby
-#
-# This comment is in the README because `@readme comment`
-# is below (in the source code).
-#
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'>#
+</span><span class='comment'># This comment is in the README because `@readme comment`
+</span><span class='comment'># is below (in the source code).
+</span><span class='comment'>#
+</span></code></pre>
 
 <h3 id="embed-ruby-code">Embed Ruby code</h3>
 
 <p><strong>Usage:</strong></p>
 
-<p><code>ruby
-# @readme code
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># @readme code
+</span></code></pre>
 
 <p>This example <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard/code_tag.rb">@readme code</a> tag embeds the below code snippet via the <code>{@readme ReadmeYard::CodeTag.format_tag}</code> markdown tag.</p>
 
-<p><code>ruby
-def format_tag(yard_object, _tag)
-  ExampleTag.format_ruby(yard_object.source)
-end
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_format_tag'>format_tag</span><span class='lparen'>(</span><span class='id identifier rubyid_yard_object'>yard_object</span><span class='comma'>,</span> <span class='id identifier rubyid__tag'>_tag</span><span class='rparen'>)</span>
+  <span class='const'>ExampleTag</span><span class='period'>.</span><span class='id identifier rubyid_format_ruby'>format_ruby</span><span class='lparen'>(</span><span class='id identifier rubyid_yard_object'>yard_object</span><span class='period'>.</span><span class='id identifier rubyid_source'>source</span><span class='rparen'>)</span>
+<span class='kw'>end</span>
+</code></pre>
 
 <h3 id="embed-ruby-comments-and-code">Embed Ruby comments and code</h3>
 
 <p><strong>Usage:</strong></p>
 
-<p><code>ruby
-# @readme source
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># @readme source
+</span></code></pre>
 
 <p>This example <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard/source_tag.rb">@readme source</a> tag embeds the below code snippet via the <code>{@readme ReadmeYard::SourceTag.format_tag}</code> markdown tag.</p>
 
-<p><code>ruby
-#
-# The comment and code for ReadmeYard::SourceTag#format_tag
-# is in the README because `@readme source` is below (in the source code).
-#
-def format_tag(yard_object, _tag)
-  text = CommentTag.format_docstring_as_comment(yard_object)
-  text &lt;&lt; "\n#{yard_object.source}"
-  ExampleTag.format_ruby(text)
-end
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'>#
+</span><span class='comment'># The comment and code for ReadmeYard::SourceTag#format_tag
+</span><span class='comment'># is in the README because `@readme source` is below (in the source code).
+</span><span class='comment'>#
+</span><span class='kw'>def</span> <span class='id identifier rubyid_format_tag'>format_tag</span><span class='lparen'>(</span><span class='id identifier rubyid_yard_object'>yard_object</span><span class='comma'>,</span> <span class='id identifier rubyid__tag'>_tag</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_text'>text</span> <span class='op'>=</span> <span class='const'>CommentTag</span><span class='period'>.</span><span class='id identifier rubyid_format_docstring_as_comment'>format_docstring_as_comment</span><span class='lparen'>(</span><span class='id identifier rubyid_yard_object'>yard_object</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_text'>text</span> <span class='op'>&lt;&lt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_yard_object'>yard_object</span><span class='period'>.</span><span class='id identifier rubyid_source'>source</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+  <span class='const'>ExampleTag</span><span class='period'>.</span><span class='id identifier rubyid_format_ruby'>format_ruby</span><span class='lparen'>(</span><span class='id identifier rubyid_text'>text</span><span class='rparen'>)</span>
+<span class='kw'>end</span>
+</code></pre>
 
 <h3 id="embed-a-ruby-value-as-a-ruby-code-block">Embed a Ruby value as a Ruby code block</h3>
 
 <p><strong>Usage:</strong></p>
 
-<p><code>ruby
-# @readme value
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># @readme value
+</span></code></pre>
 
 <p>This example <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard/value_tag.rb">@readme value</a> tag embeds the below code snippet via the <code>{@value ReadmeYard::ValueTag::EXAMPLE}</code> markdown tag.</p>
 
-<p><code>ruby
-{ key: "value" }.freeze
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='lbrace'>{</span> <span class='label'>key:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>value</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span>
+</code></pre>
 
 <h3 id="embed-a-ruby-string-as-normal-text">Embed a Ruby string as normal text</h3>
 
@@ -315,47 +308,48 @@ end
 
 <p>Because a <a href="https://github.com/mattruzicka/readme_yard/blob/main/lib/readme_yard/string_tag.rb">@readme string</a> tag:</p>
 
-<p><code>ruby
-# @readme string
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># @readme string
+</span></code></pre>
 
 <p>Is located above this constant:</p>
 
-<p><code>ruby
-XZAMPLE = &lt;&lt;~STRING
-  I heard you like self-documenting Ruby, so I wrote
-  self-documenting Ruby for your self-documenting Ruby.
-STRING
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='const'>XZAMPLE</span> <span class='op'>=</span> <span class='heredoc_beg'>&lt;&lt;~STRING</span>
+<span class='tstring_content'>  I heard you like self-documenting Ruby, so I wrote
+</span><span class='tstring_content'>  self-documenting Ruby for your self-documenting Ruby.
+</span><span class='heredoc_end'>STRING
+</span></code></pre>
 
 <p>We see can see its string value as simple text below:</p>
 
 <p>I heard you like self-documenting Ruby, so I wrote
 self-documenting Ruby for your self-documenting Ruby.</p>
 
-<hr />
+<hr>
 
 <h2 id="standalone-tag-usage">Standalone Tag Usage</h2>
 
-<p>While using the <code>@readme</code> tag in your source code is recommended because it makes the README’s dependency on source code explicit, sometimes it’s useful to embed source code snippets directly without it. This is especially valuable when a source object can only contain one <code>@readme</code> tag, but you want to highlight multiple aspects of the object.</p>
+<p>While using the <code>@readme</code> tag in your source code is recommended because it makes the README&#39;s dependency on source code explicit, sometimes it&#39;s useful to embed source code snippets directly without it. This is especially valuable when a source object can only contain one <code>@readme</code> tag, but you want to highlight multiple aspects of the object.</p>
 
 <p>You can use any of these tags directly in README_YARD.md without requiring a corresponding <code>@readme</code> tag in the source code:</p>
 
 <ul>
-  <li><code>{@comment ObjectPath}</code> - Embeds comments only</li>
-  <li><code>{@code ObjectPath}</code> - Embeds code only</li>
-  <li><code>{@source ObjectPath}</code> - Embeds both comments and code</li>
-  <li><code>{@value ObjectPath}</code> - Embeds a Ruby value as a Ruby code block</li>
-  <li><code>{@string ObjectPath}</code> - Embeds a Ruby string as plain text</li>
+<li><code>{@comment ObjectPath}</code> - Embeds comments only</li>
+<li><code>{@code ObjectPath}</code> - Embeds code only</li>
+<li><code>{@source ObjectPath}</code> - Embeds both comments and code</li>
+<li><code>{@value ObjectPath}</code> - Embeds a Ruby value as a Ruby code block</li>
+<li><code>{@string ObjectPath}</code> - Embeds a Ruby string as plain text</li>
 </ul>
 
-<p>For example, in the StringTag section above, we used both:
-- <code>{@code ReadmeYard::StringTag::XZAMPLE}</code> to show the constant definition
-- <code>{@string ReadmeYard::StringTag::XZAMPLE}</code> to display the string value as text</p>
+<p>For example, in the StringTag section above, we used both:</p>
+
+<ul>
+<li><code>{@code ReadmeYard::StringTag::XZAMPLE}</code> to show the constant definition</li>
+<li><code>{@string ReadmeYard::StringTag::XZAMPLE}</code> to display the string value as text</li>
+</ul>
 
-<p>The standalone tag usage provides more flexibility when documenting your code and doesn’t require modifications to the source files.</p>
+<p>The standalone tag usage provides more flexibility when documenting your code and doesn&#39;t require modifications to the source files.</p>
 
-<hr />
+<hr>
 
 <h2 id="example-tag">Example Tag</h2>
 
@@ -363,39 +357,37 @@ self-documenting Ruby for your self-documenting Ruby.</p>
 
 <p><strong>YARD</strong> syntax: <code>@example</code></p>
 
-<p>The Example Tag leverages YARD’s standard <code>@example</code> tag syntax, allowing you to
+<p>The Example Tag leverages YARD&#39;s standard <code>@example</code> tag syntax, allowing you to
 include example code in your README directly from source files. This saves time and
 ensures your README stays in sync with your YARD documentation</p>
 
 <p><strong>Usage:</strong></p>
 
-<p><code>ruby
-#
-# @example
-#   ReadmeYard::ExampleTag.hello_world #=&gt; "Hello 🌎 🌍 🌏"
-#
-def hello_world
-  "Hello 🌎 🌍 🌏"
-end
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='comment'>#
+</span><span class='comment'># @example
+</span><span class='comment'>#   ReadmeYard::ExampleTag.hello_world #=&gt; &quot;Hello 🌎 🌍 🌏&quot;
+</span><span class='comment'>#
+</span><span class='kw'>def</span> <span class='id identifier rubyid_hello_world'>hello_world</span>
+  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hello 🌎 🌍 🌏</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>end</span>
+</code></pre>
 
-<p>The below example code is generated from <code>{@example ReadmeYard::ExampleTag.hello_world}</code> because, as you can see above, the “hello_world” class method has an <code>@example</code> tag.</p>
+<p>The below example code is generated from <code>{@example ReadmeYard::ExampleTag.hello_world}</code> because, as you can see above, the &quot;hello_world&quot; class method has an <code>@example</code> tag.</p>
 
-<p><code>ruby
-ReadmeYard::ExampleTag.hello_world #=&gt; "Hello 🌎 🌍 🌏"
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='const'><span class='object_link'><a href="ReadmeYard.html" title="ReadmeYard (class)">ReadmeYard</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="ReadmeYard/ExampleTag.html" title="ReadmeYard::ExampleTag (class)">ExampleTag</a></span></span><span class='period'>.</span><span class='id identifier rubyid_hello_world'><span class='object_link'><a href="ReadmeYard/ExampleTag.html#hello_world-class_method" title="ReadmeYard::ExampleTag.hello_world (method)">hello_world</a></span></span> <span class='comment'>#=&gt; &quot;Hello 🌎 🌍 🌏&quot;
+</span></code></pre>
 
-<hr />
+<hr>
 
 <h2 id="contributing">Contributing</h2>
 
-<p>Bug reports and pull requests are welcome on GitHub at https://github.com/mattruzicka/readme_yard.</p>
+<p>Bug reports and pull requests are welcome on GitHub at <a href="https://github.com/mattruzicka/readme_yard">https://github.com/mattruzicka/readme_yard</a>.</p>
 
 <p>Thanks for reading me, the README that documents how to document the README with code that documents itself 🤯</p>
 </div></div>
 
       <div id="footer">
-  Generated on Mon May  5 09:48:52 2025 by
+  Generated on Fri May  9 00:45:02 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.2).
 </div>

data/docs/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Mon May  5 09:48:52 2025 by
+  Generated on Fri May  9 00:45:02 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.2).
 </div>

data/lib/readme_yard/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 class ReadmeYard
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
   DOCS_URL = "https://mattruzicka.github.io/readme_yard/"
 end

data/lib/readme_yard/yard_opts_manager.rb

@@ -26,13 +26,14 @@ class ReadmeYard
           warn_about_supported_markdown
           readme_plugin_opts
         else
-          readme_plugin_opts << "--markup markdown\n"
+          readme_plugin_opts << "--markup markdown\n--markup-provider redcarpet\n"
         end
       end
 
       def default_readme_plugin_opts(yardopts_text)
         readme_opts = +""
-        readme_opts << "\n" unless yardopts_text.lines.last.include?("\n")
+        last_line = yardopts_text.lines.last
+        readme_opts << "\n" if last_line && !last_line.include?("\n")
         readme_opts << "--plugin readme\n"
       end
 

data/readme_yard.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
 
   # Uncomment to register a new dependency of your gem
   spec.add_dependency "diffy", "~> 3.4"
+  spec.add_dependency "redcarpet", "~> 3.6"
   spec.add_dependency "tty-markdown", "~> 0.7"
   spec.add_dependency "yard", "~> 0.9"
   spec.add_dependency "yard-readme", "~> 0.5"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: readme_yard
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Matt Ruzicka
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
 - !ruby/object:Gem::Dependency
   name: tty-markdown
   requirement: !ruby/object:Gem::Requirement