docrb-html 0.2.5 → 0.3.0

data/templates/breadcrumb.erb

@@ -3,8 +3,8 @@
         <a href="/">
             <%= svg("home") %>
             <span class="padded">
-                <%= project_name %>
-            </span>
+            <%= project_name %>
+        </span>
         </a>
     </div>
     <% items.each.with_index do |i, idx| %>
@@ -12,16 +12,16 @@
         <div class="link">
             <% if i[:parents].empty? && idx == 0 %>
                 <a href="components.html">
-                    <span class="padded">
-                        <%= i[:name] %>
-                    </span>
-                </a>
-            <% else %>
-            <a href="<%= (i[:parents] + [idx == 0 ? nil : i[:name]]).flatten.compact.join("/") %>.html">
                 <span class="padded">
                     <%= i[:name] %>
                 </span>
-            </a>
+                </a>
+            <% else %>
+                <a href="<%= (i[:parents] + [idx == 0 ? nil : i[:name]]).flatten.compact.join("/") %>.html">
+            <span class="padded">
+                <%= i[:name] %>
+            </span>
+                </a>
             <% end %>
         </div>
     <% end %>

data/templates/class_header.erb

@@ -5,20 +5,19 @@
         <% def_link = Proc.new do |item, extra = nil| %>
         <span class="def-link">
             <%= extra %>
-            <a href="<%= item[:href] %>"
-                class="dashed"><%= item[:name] %>
+            <a href="<%= item[:git_url] %>" class="dashed"><%= item[:filename] %>
             </a>
         </span>
         <% end %>
         <% if definitions.length > 0 %>
             <div class="defs">
                 Defined in
-                <% if def_collection.length == 1 %>
-                    <% def_link.call def_collection.first %>
+                <% if definitions.length == 1 %>
+                    <% def_link.call definitions.first %>
                 <% else %>
-                    <% last_item = def_collection.pop %>
-                    <% def_collection.each do |item| %>
-                        <% def_link item %>
+                    <% last_item = definitions.pop %>
+                    <% definitions.each do |item| %>
+                        <% def_link.call item %>,
                     <% end %>
                     <% def_link.call last_item, " and " %>
                 <% end %>

data/templates/component_list.erb

@@ -1,18 +1,24 @@
 <% div("component-list-base", id:, class_name: class_name) do %>
     <% list.each do |item| %>
         <%
-            base_path = (parents + ["#{item[:name]}.html"]).join("/")
-            new_parents = parents + [item[:name]]
+            obj = item[:object]
+            base_path = (parents + ["#{obj.name}.html"]).join("/")
+            new_parents = parents + [obj.name]
         %>
         <div class="level" style="padding-left: <%= item[:level] * 20 %>px">
-            <%= type_definition(type: item[:type], href: "#{base_path}", name: item[:name]) %>
+            <%= type_definition(type: obj.kind, href: "#{base_path}", name: obj.name) %>
             <div class="level" style="padding-left: <%= (item[:level] + 1) * 20 %>px">
-                <% item[:attributes]&.each do |att| %>
-                    <%= method_display(type: att[:type], name: att[:name], visibility: att[:visibility], decoration: att[:decoration], href: "#{base_path}#attr-#{att[:name]}") %>
-                <% end %>
-                <% item[:defs]&.each do |met| %>
-                    <%= method_display(href: "#{base_path}##{met[:short_type]}-#{met[:name]}", **met) %>
+                <%= obj.constants.map { constant_display(item: _1) }.join("") %>
+                <% obj.kind == :class && obj.instance_attributes.each do |i| %>
+                    <%= attribute_display(item: i, kind: :instance) %>
                 <% end %>
+                <% obj.class_attributes
+                      .map { attribute_display(item: _1, kind: :class) }
+                      .join("") %>
+                <%= (obj.all_class_methods + obj.all_instance_methods)
+                        .map { method_display(item: _1, parent: obj) }
+                        .join("")
+                %>
             </div>
             <%= component_list(list: item[:modules], parents: new_parents, class_name: "no-margin") %>
             <%= component_list(list: item[:classes], parents: new_parents, class_name: "no-margin") %>

data/templates/constant_display.erb

@@ -0,0 +1,13 @@
+<% div("constant-display-base", id:) do %>
+    <%= typedef(name: "Constant") %>
+    <% base = capture do %>
+        <div class="container">
+            <div class="constant-name"><%= item.name %></div>
+        </div>
+    <% end %>
+    <% if omit_link %>
+        <%= base %>
+    <% else %>
+        <a class="dashed" href="<%= link_for(item) %>"><%= base %></a>
+    <% end %>
+<% end %>

data/templates/doc_box.erb

@@ -4,13 +4,7 @@
             <h3 class="heading"><%= name %></h3>
             <div class="link-column">
                 <% list.each do |item| %>
-                    <div>
-                        <% if item.is_a? String %>
-                            <%= reference(ref: { contents: item }) %>
-                        <% else %>
-                            <%= reference(ref: { ref_type: item.type, ref_path: item.path, contents: item.name }) %>
-                        <% end %>
-                    </div>
+                    <div><%= reference(object: item) %></div>
                 <% end %>
             </div>
         </div>
@@ -19,11 +13,11 @@
 
 <% div("doc-box-base", id:) do %>
     <div class="left">
-        <%= has_class_docs && documentation_block(doc: item[:doc]) %>
+        <%= has_class_docs ? documentation_block(doc: item.doc) : nil %>
         <% if has_class_details %>
             <div class="section-container" id="class-details">
                 <div class="horizontal-container">
-                    <% child_structure.call("Inherits", [item.inherits].compact) %>
+                    <% child_structure.call("Inherits", [item.kind == :class && item.inherits || nil].compact) %>
                     <% child_structure.call("Extends", item.extends) %>
                     <% child_structure.call("Includes", item.includes) %>
                     <% child_structure.call("Child Modules", item.modules) %>
@@ -31,41 +25,56 @@
                 </div>
             </div>
         <% end %>
-        <% if has_attrs %>
-            <div class="section-container" id="attributes">
-                <h3 class="heading">Attributes</h3>
-                <% attrs.each do |att| %>
-                    <div class="attribute-container"
-                        data-origin="<%= att.dig(:origin) %>"
-                        data-type="<%= att[:type].downcase %>"
-                        id="<%= att[:type] %>-<%= att[:name] %>"
-                        >
-                        <% if att[:decoration] %>
-                            <%= svg(att[:decoration], class_name: "decoration", title: att[:decoration] == 'inherited' ? 'Inherited' : 'Override') %>
-                        <% end %>
-                        <span class="name"><%= att[:name] %></span>
-                        <span class="label"><%= att[:visibility] %></span>
-                        <% if att[:doc] %>
-                            <%= markdown(source: att[:doc]) %>
-                        <% else %>
-                            <div class="faded">
-                                (No documentation available)
-                            </div>
+
+        <% if has_constants %>
+            <div class="section-container" id="constants">
+                <h3 class="heading">Constants</h3>
+                <% constants.each do |const| %>
+                    <% origin = source_of(const, item) %>
+                    <div class="constant-container"
+                         data-origin="<%= origin %>"
+                         data-type="Constant"
+                         id="const-<%= const.name %>"
+                    >
+                        <% if origin == "inherited" %>
+                            <%= svg("inheritance", class_name: "decoration", title: 'Inherited') %>
                         <% end %>
+                        <a class="dashed" href="<%= link_for(const) %>"><span class="name"><%= const.name %></span></a>
+                        <div class="doc-block">
+                            <%= documentation_block(doc: const.doc) %>
+                        </div>
                     </div>
                 <% end %>
             </div>
         <% end %>
+
+        <% if has_class_attributes %>
+            <div class="section-container" id="class-attributes">
+                <h3 class="heading">Class Attributes</h3>
+                <% class_attributes.each do |att| %>
+                    <%= attribute(item: att, kind: :class, omit_type: true) %>
+                <% end %>
+            </div>
+        <% end %>
+
+        <% if has_instance_attributes %>
+            <div class="section-container" id="instance-attributes">
+                <h3 class="heading">Instance Attributes</h3>
+                <% instance_attributes.each do |att| %>
+                    <%= attribute(item: att, kind: :instance, omit_type: true) %>
+                <% end %>
+            </div>
+        <% end %>
         <% if has_class_methods %>
             <div class="section-container" id="class-methods">
                 <h3 class="heading">Class Methods</h3>
-                <%= method_list(list: sdefs) %>
+                <%= method_list(list: class_methods, omit_type: true, parent: item) %>
             </div>
         <% end %>
         <% if has_instance_methods %>
             <div class="section-container" id="instance-methods">
                 <h3 class="heading">Instance Methods</h3>
-                <%= method_list(list: defs) %>
+                <%= method_list(list: instance_methods, omit_type: true, parent: item) %>
             </div>
         <% end %>
     </div>

data/templates/documentation_block.erb

@@ -2,17 +2,8 @@
     <% if doc.nil? || doc.empty? %>
         <div class="faded">(No documentation available)</div>
     <% else %>
-        <% items = (doc[:contents].is_a?(Array) ? doc[:contents] : [doc[:contents]]).compact %>
-
-        <% items.map.each do |i| %>
-            <% if i[:type] == 'text_block' %>
-                <%= text_block list: i[:contents] %>
-            <% elsif i[:type] == 'code_example' %>
-                <%= markdown(source: i[:contents]) %>
-            <% elsif i[:type] == 'field_block' %>
-            <% else %>
-                <span class="text">!Unexpected item <%= i[:type] %></span>
-            <% end %>
+        <% doc[:value].each do |block| %>
+            <%= documentation_comment(doc: block) %>
         <% end %>
     <% end %>
 <% end %>

data/templates/documentation_comment.erb

@@ -0,0 +1,23 @@
+<% div("documentation-comment-base", id:) do %>
+    <% if doc[:type] == :block %>
+        <%= text_block contents: doc[:value] %>
+    <% elsif doc[:type] == :code_example %>
+        <%= markdown(source: doc[:contents]) %>
+    <% elsif doc[:type] == :fields %>
+        <%= field_block(fields: doc[:value]) %>
+    <% elsif doc[:type] == :neutral_identifier || doc[:type] == :unresolved_identifier %>
+        <code><%= doc[:value] %></code>
+    <% elsif doc[:type] == :reference %>
+        <%= reference(object: i) %>
+    <% elsif doc[:type] == :symbol %>
+        <%= symbol(name: doc[:value]) %>
+    <% elsif doc[:type] == :method_ref %>
+        <a class="method-ref dashed" href="<%= link_for(doc[:object]) %>"><%= doc[:value] %></a>
+        <!-- <%= doc.to_json %> -->
+    <% else %>
+        <div class="unknown-object">
+            Unknown object <%= doc[:type] %>
+            <!-- <%= doc.to_json %> -->
+        </div>
+    <% end %>
+<% end %>

data/templates/field_block.erb

@@ -0,0 +1,15 @@
+<% div("field-block-base", id:) do %>
+    <h3>Arguments</h3>
+    <table>
+        <tbody>
+        <% fields.each do |name, value| %>
+            <tr>
+                <td class="name"><%= name %></td>
+                <td class="value">
+                    <%= documentation_comment(doc: value) %>
+                </td>
+            </tr>
+        <% end %>
+        </tbody>
+    </table>
+<% end %>

data/templates/method_argument.erb

@@ -9,9 +9,8 @@
         <span class="continuation <%= computed[:continuation] %>"></span>
     <% end %>
 
-    <% if computed.dig(:value, :kind) == :method_call_argument %>
-    <% elsif computed.dig(:value, :kind) == :const
-        last = computed.dig(:value, :value).pop
+    <% if computed.dig(:value, :kind) == :const
+         last = computed.dig(:value, :value).pop
     %>
         <% computed.dig(:value, :value).each do |val| %>
             <% if val[:kind] == :continuation %>
@@ -22,8 +21,9 @@
                 </span>
             <% end %>
         <% end %>
-        <span class="simple-argument plain"><%= last[:value] %></span>
+        <span class="simple-argument plain"><%= last %></span>
     <% elsif computed.dig(:value, :kind) %>
         <span class="simple-argument <%= computed[:value][:kind] %>"><%= computed[:value][:value] %></span>
+    <% else %>
     <% end %>
 <% end %>

data/templates/method_display.erb

@@ -1,28 +1,21 @@
 <% div("method-display-base", id:) do %>
-    <%= decoration && !decoration.empty? && svg(decoration, class_name: "decoration", title: decoration == "inherited" ? "Inherited" : "Override") || "" %>
-    <%= type && typedef(name: type) %>
-    <% base = capture do %>
+    <% if (dec = source_of(item, parent)) %>
+        <%= svg(dec.to_s.downcase, class_name: "decoration", title: dec.to_s.capitalize) %>
+    <% end %>
+    <% unless omit_type %>
+        <%= typedef(name: "#{item.type.capitalize} Method") %>
+    <% end %>
+    <a class="dashed" href="<%= link_for(item) %>">
         <div class="container">
-            <div class="method-name"><%= name %></div>
-            <% if args %>
-                <div class="argument-container<%= args.empty? ? "" : " not-empty" %>">
-                    <% args.map do |i| %>
-                        <%= method_argument(**i) %>
+            <div class="method-name"><%= item.name %></div>
+            <% if item.parameters %>
+                <div class="argument-container<%= item.parameters.empty? ? "" : " not-empty" %>">
+                    <% item.parameters.map do |i| %>
+                        <%= method_argument(arg: i) %>
                     <% end %>
                 </div>
             <% end %>
         </div>
-    <% end %>
-    <% if href && !href.empty? %>
-        <a class="dashed" href="<%= href %>">
-            <%= base %>
-        </a>
-    <% else %>
-        <%= base %>
-    <% end %>
-    <% if visibility&.downcase != 'public' %>
-        <div class="label"><%= visibility %></div>
-    <% elsif ![nil, 'public'].include? doc&.dig(:doc_visibility_annotation) %>
-        <div class="label"><%= doc.dig(:doc_visibility_annotation) %></div>
-    <% end %>
+    </a>
+    <div class="label"><%= item.doc&.dig(:meta, :visibility_annotation) || item.visibility %></div>
 <% end %>

data/templates/method_list.erb

@@ -1,23 +1,67 @@
 <% div("method-list-base", id:) do %>
-    <% list && list.length > 0 && list.each do |i| %>
+    <% !list&.empty? && list.each do |i| %>
         <div class="method-definition"
-             id="<%= i[:type] %>-<%= i[:name] %>"
-             data-visibility="<%= i.dig(:doc, :doc_visibility_annotation) || '' %>"
-             data-origin="<%= i.dig(:origin) %>">
+             id="<%= i.type %>-method-<%= i.name %>"
+             data-visibility="<%= i.doc&.dig(:meta, :visibility_annotation) || '' %>"
+             data-origin="<%= source_of(i, parent) %>">
             <div class="method-block">
-                <%= method_display(**i.merge(type: nil).slice(*Renderer::Component::MethodDisplay.instance_variable_get(:@props))) %>
+                <%= method_display(item: i, omit_type:, parent:) %>
             </div>
+            <% if (o = i.override_target) %>
+                <div class="override-info-box">
+                    Overrides
+                    <%
+                        override_path = o.full_path(relative_to: parent)
+                        if override_path.length > 1
+                          method = override_path.pop
+                    %>
+                        <a href="<%= link_for(method) %>" class="dashed">
+                            <%= override_path.map(&:name).join("::") %><%= method.instance? ? "#" : "::" %><%= method.name %>
+                        </a>
+                    <% else %>
+                        <a href="<%= link_for(override_path.first) %>" class="dashed">
+                            <%= override_path.first.name %>
+                        </a>
+                    <% end %>
+                </div>
+            <% end %>
+            <% if (list = i.overriders) && !list.empty? %>
+                <div class="overridden-by-block">
+                    <details>
+                        <summary>
+                            Overridden by
+                            <span><%= list.first.full_path(relative_to: parent).map(&:name).join("::") %></span><% if list.length > 1 %>, and
+                                <%= list.length - 1 %> other<%= list.length - 1 == 1 ? "" : "s" %>
+                            <% end %>
+                        </summary>
+                        <ul>
+                            <%
+                                list.each do |override|
+                                  source = i.instance? ? override.instance_methods : override.class_methods
+                                  target = source.named!(i.name)
+                                  target_path = target.full_path(relative_to: parent).tap(&:pop).map(&:name).join("::")
+                            %>
+                                <li><a href="<%= link_for(target) %>" class="dashed">
+                                    <span><%= target_path %><%= i.instance? ? "#" : "::" %><%= i.name %></span>
+                                </a></li>
+                            <% end %>
+                        </ul>
+                    </details>
+                </div>
+            <% end %>
             <div class="doc-block">
-                <%= documentation_block(doc: i[:doc]) %>
+                <%= documentation_block(doc: i.doc) %>
             </div>
             <details class="source-block">
                 <summary>
                     <span class="expanded">Hide Source</span>
                     <span class="collapsed">Show Source</span>
                 </summary>
-                <%= markdown(source: i[:defined_by][:markdown_source]) %>
+                <%= markdown(source: Renderer::Markdown.render_source(i.location.source)) %>
                 <div class="from">
-                    Defined in <a href="<%= git_url(i[:defined_by]) %>" class="dotted"><%= clean_file_path(i[:defined_by]) %>, <%= line_range(i[:defined_by]) %></a>
+                    Defined in
+                    <a href="<%= git_url(i.location) %>" class="dotted"><%= clean_file_path(i.location) %>
+                        , <%= line_range(i.location) %></a>
                 </div>
             </details>
         </div>

data/templates/reference.erb

@@ -1,14 +1,17 @@
 <% div("reference-base", id:) do %>
     <% if unresolved %>
-        <span class="unresolved" title="Docrb could not resolve this reference. It may be from an external library or dynamically-generated method.">
-            <%= svg('questionmark') %>
-            <span><%= ref[:contents] %></span>
+        <span><%= value || path.last %></span>
+    <% elsif ref_type == :pure %>
+        <a href="<%= link_for(object) %>">
+        <span class="resolved <%= ref_type %>">
+            <span><%= value %></span>
         </span>
+        </a>
     <% else %>
-    <a href="<%= path.join('/') %>">
-        <span class="resolved <%= ref[:ref_type] %>">
-            <span><%= ref[:contents] %></span>
+        <a href="<%= path.join('/') %>.html">
+        <span class="resolved <%= ref_type %>">
+            <span><%= value || path.last %></span>
         </span>
-    </a>
+        </a>
     <% end %>
 <% end %>

data/templates/text_block.erb

@@ -1,16 +1,15 @@
-<% div("text-block-base", id:) do %>
-    <% list.each do |i| %>
-        <% if i[:type] == 'span' %>
-            <div class="html inline"><%= i[:contents] %></div>
-        <% elsif i[:type] == 'ref' %>
-            <%= reference(ref: i) %>
-        <% elsif i[:type] == 'html' %>
-            <div class="html"><%= i[:contents] %></div>
-        <% elsif i[:type] == 'sym_ref' %>
-            <%= symbol(name: i[:contents]) %>
-        <% else %>
-            Unknown textblock item <%= i[:kind] %><br/>
-            <%= i.to_json %>
-        <% end %>
+<% div("text-block-base#{inline ? " inline" : ""}", id:) do %>
+    <% if contents.is_a? String %>
+        <div class="html"><%= Renderer::Markdown.inline(contents) %></div>
+    <% else %>
+        <div class="html">
+            <% contents.each do |block| %>
+                <% if block[:type] == :span %>
+                    <span><%= Renderer::Markdown.inline(block[:value]).gsub("\n", ' ').gsub(/\s{2,}/, ' ') %></span>
+                <% else %>
+                    <%= documentation_comment(doc: block) %>
+                <% end %>
+            <% end %>
+        </div>
     <% end %>
 <% end %>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: docrb-html
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Victor Gama
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-21 00:00:00.000000000 Z
+date: 2023-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -24,6 +24,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.14'
+- !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: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
 - !ruby/object:Gem::Dependency
   name: sassc
   requirement: !ruby/object:Gem::Requirement
@@ -56,10 +84,12 @@ files:
 - assets/class_header.scss
 - assets/class_mod_name.scss
 - assets/component_list.scss
+- assets/constant_display.scss
 - assets/container.scss
 - assets/doc_box.scss
 - assets/documentation_block.scss
 - assets/favicon.ico
+- assets/field_block.scss
 - assets/fonts.scss
 - assets/footer.scss
 - assets/images/balance.svg
@@ -85,6 +115,7 @@ files:
 - assets/reference.scss
 - assets/shared.scss
 - assets/style.scss
+- assets/svg.scss
 - assets/symbol.scss
 - assets/tab_bar.scss
 - assets/text_block.scss
@@ -92,16 +123,23 @@ files:
 - assets/typedef.scss
 - bin/console
 - bin/setup
+- bin/smoke
+- docrb-html.gemspec
 - exe/docrb-html
-- lib/renderer.rb
+- lib/docrb-html.rb
 - lib/renderer/component.rb
+- lib/renderer/component/attribute.rb
+- lib/renderer/component/attribute_display.rb
 - lib/renderer/component/breadcrumb.rb
 - lib/renderer/component/checkbox.rb
 - lib/renderer/component/class_header.rb
 - lib/renderer/component/class_mod_name.rb
 - lib/renderer/component/component_list.rb
+- lib/renderer/component/constant_display.rb
 - lib/renderer/component/doc_box.rb
 - lib/renderer/component/documentation_block.rb
+- lib/renderer/component/documentation_comment.rb
+- lib/renderer/component/field_block.rb
 - lib/renderer/component/footer.rb
 - lib/renderer/component/markdown.rb
 - lib/renderer/component/method_argument.rb
@@ -115,27 +153,41 @@ files:
 - lib/renderer/component/type_definition.rb
 - lib/renderer/component/typedef.rb
 - lib/renderer/core_extensions.rb
-- lib/renderer/defs.rb
-- lib/renderer/defs/specialized_object.rb
-- lib/renderer/defs/specialized_projection.rb
+- lib/renderer/entities.rb
+- lib/renderer/entities/attribute.rb
+- lib/renderer/entities/attribute_definition.rb
+- lib/renderer/entities/base.rb
+- lib/renderer/entities/class.rb
+- lib/renderer/entities/container.rb
+- lib/renderer/entities/method.rb
+- lib/renderer/entities/method_argument.rb
+- lib/renderer/entities/method_definition.rb
+- lib/renderer/entities/module.rb
+- lib/renderer/entities/reference.rb
+- lib/renderer/entities/source_definition.rb
 - lib/renderer/helpers.rb
+- lib/renderer/markdown.rb
 - lib/renderer/metadata.rb
 - lib/renderer/page.rb
 - lib/renderer/template.rb
 - lib/renderer/version.rb
-- renderer.gemspec
 - script/makecomponent
 - script/reload.js
 - script/serve
 - script/watch
+- templates/attribute.erb
+- templates/attribute_display.erb
 - templates/base.erb
 - templates/breadcrumb.erb
 - templates/checkbox.erb
 - templates/class_header.erb
 - templates/class_mod_name.erb
 - templates/component_list.erb
+- templates/constant_display.erb
 - templates/doc_box.erb
 - templates/documentation_block.erb
+- templates/documentation_comment.erb
+- templates/field_block.erb
 - templates/footer.erb
 - templates/markdown.erb
 - templates/method_argument.erb
@@ -171,7 +223,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Docrb's HTML Generator