rdoc-babel 1.0.4 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 03337e579f18dd1f366adeaf01085bfed07d9e131e77be194a341e8e0848a69f
-  data.tar.gz: f2531e32eef12e51ed7c09fc9e2b282e1d372abe3997515c6bc768a2bce4c30e
+  metadata.gz: e1327fb42125f98ea0570da581237805d4f8b888f0e7539ff2f3852434305742
+  data.tar.gz: 03dc94dc98373a2fc6f8e10f33be216311a570708f80eeadff28a9725db381cb
 SHA512:
-  metadata.gz: e14e0d5334e85e24c3e0b1a825c873a97429adfedfe1633165a633f0287f11a14e83fb6da1ad72beb0648fa69442d1c0c946294493b11706ee1e9ac861ee8693
-  data.tar.gz: c03a9e87719ce4e8bd7ba61b73b1d875dafd021fa39070b3d268ca5173768753b45c442ad0ad936b9fde5839e6d4746f78b3331c3410584f437f94c8768f852e
+  metadata.gz: eaefb9b9fb643aa8af53622b97fc668846ec6dbd90d3f4b2e508a15f41ab9ba807ff5ac475bf9ea1ab798c2179d56d65b9e2dfa334be04fed454d3e6e61a3c83
+  data.tar.gz: 171c83b49f1a3c6ead84ce1abe9b5a6a00da7361a7949f626763783349acae9c81915d26d6e5e2affdb0002493a066c9b1b131625447a5878c09a508f7862423

data/HISTORY.rdoc

@@ -1,21 +1,48 @@
 
-=== 0.9.0 / 2010-10-02
+=== 1.1.1
 
-Initial version, developed along with {RDoc}[http://github.com/rdoc/rdoc] 3.0.
+* fixes for RDoc bugs
+* tune CSS, switch to HTML 5
 
-=== 0.9.1 / 2011-07-16
+=== 1.0.8
 
-First public release.
+* tune the style sheet
 
-=== 1.0.0 / 2014-07-20
+=== 1.0.7 / 2021-02-16
 
-Make it compatible with RDoc 4.1 and its bugs.
+* Fix warning with rdoc 6.3, update runtime dependency
+
+=== 1.0.5 / 2020-06-01
+
+* Fix warning with Ruby 2.7
+* Tune CSS for definition lists
+
+=== 1.0.4 / 2019-08-02
+
+Fix for latest ERB syntax.
+
+=== 1.0.3 / 2019-07-29
+
+Compatibility with RDoc 6.
+
+=== 1.0.2 / 2017-02-25
+
+Fix for compatibility with RDoc 5 dupping the options.
 
 === 1.0.1 / 2015-06-29
 
 * Fix rendering of Markdown files
 * Fix CSS file (code instead of tt)
 
-=== 1.0.2 / 2017-02-25
+=== 1.0.0 / 2014-07-20
+
+Make it compatible with RDoc 4.1 and its bugs.
+
+=== 0.9.1 / 2011-07-16
+
+First public release.
+
+=== 0.9.0 / 2010-10-02
+
+Initial version, developed along with {RDoc}[http://github.com/rdoc/rdoc] 3.0.
 
-* Fix for compatibility with RDoc 5 dupping the options.

data/README.rdoc

@@ -81,7 +81,7 @@ Babel supports specific options in addition to the standard RDoc options:
 
 (The MIT License)
 
-Copyright (c) 2010-2019 Thierry Lambert
+Copyright (c) 2010-2020 Thierry Lambert
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -1,33 +1,17 @@
-require 'hoe'
+require "rake/testtask"
 
-Hoe.spec 'rdoc-babel' do
-
-  developer 'Thierry Lambert', 'thyresias@gmail.com'
-  license 'MIT'
-
-  self.summary = "An RDoc formatter producing HTML documentation."
-  self.description = paragraphs_of('README.rdoc', 3, 6).join("\n\n")
-
-  self.readme_file = 'README.rdoc'
-  self.history_file = 'HISTORY.rdoc'
-  self.extra_rdoc_files = ['README.rdoc', 'HISTORY.rdoc']
-
-  self.remote_rdoc_dir = ''
-  self.testlib = :minitest
-  # self.test_prelude = %(gem "minitest")
-
-  self.extra_deps << ['rdoc', '~> 6.1']
-
-  self.extra_dev_deps << ['minitest', '~> 5.11']
-  self.extra_dev_deps << ['nokogiri', '~> 1.10']
-
-  spec_extras[:homepage] = 'http://github.com/thyresias/rdoc-babel'
-  spec_extras[:rdoc_options] = %w(--main README.rdoc)
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/test*.rb']
+end
 
+desc 'build & install gem'
+task 'gem' do
+  system 'gem build rdoc-babel.gemspec'
+  system 'gem install rdoc-babel --local'
 end
 
-task :file_list do
-  puts Dir['*'].reject { |f| File.directory? f }
-  puts Dir['lib/**/*'].reject { |f| File.directory? f }
-  puts Dir['test/**/*'].reject { |f| File.directory? f }
+desc 'publish the gem'
+task 'push' do
+  gemfile = Dir['*.gem'].sort.last
+  system "gem push #{gemfile}"
 end

data/lib/rdoc/generator/babel.rb

@@ -1,12 +1,8 @@
-# require 'rdoc'
-# require 'rdoc/rdoc'
-#require 'rdoc/generator'
 require 'pathname'
 require 'fileutils'
 require 'erb'
 
-# require 'rdoc/generator/markup'
-
+# :stopdoc:
 # remove junk <span> at the end
 class RDoc::Markup::ToHtml
 
@@ -27,6 +23,7 @@ class RDoc::Markup::ToHtml
   end
 
 end
+# :startdoc:
 
 ##
 # Babel RDoc HTML Generator.
@@ -36,6 +33,9 @@ class RDoc::Generator::Babel
 
   RDoc::RDoc.add_generator(self)
 
+  VERSION = '1.1.1'
+  DESCRIPTION = 'Alternate HTML documentation'
+
   include ERB::Util
 
   # Directory containing babel templates.
@@ -73,8 +73,8 @@ class RDoc::Generator::Babel
         :see_standard_ancestors => false,
       }
 
-      rdoc_options.extend Options  # extend the existing object
-      rdoc_options.class.include Options  # make sure #babel_options will be there on #dup'ed objects
+      rdoc_options.extend Options         # 1. extend the existing object
+      rdoc_options.class.include Options  # 2. make sure #babel_options will be there on #dup'ed objects
       rdoc_options.babel_options = options
 
       opt = rdoc_options.option_parser
@@ -169,7 +169,7 @@ class RDoc::Generator::Babel
 
     @all_files = @store.all_files # not sorted: keep command line order
     @files_with_comment = @all_files.reject { |f| f.comment.empty? }
-    @simple_files = @files_with_comment.select { |f| f.parser == RDoc::Parser::Simple }
+    @simple_files = @files_with_comment.select { |f| f.parser == RDoc::Parser::Simple || f.parser == RDoc::Parser::Markdown }
 
     @files_to_display =
       if @unique_classes_and_modules.empty?
@@ -212,7 +212,7 @@ class RDoc::Generator::Babel
       if source_path.directory?
         out_path.mkpath unless @options.dry_run
       else
-        FileUtils.cp source_path.to_s, out_path.dirname.to_s, options
+        FileUtils.cp source_path.to_s, out_path.dirname.to_s, **options
       end
     end
   end
@@ -324,37 +324,101 @@ class RDoc::Generator::Babel
 
   def decorated_call_seq(method, method_name_class)
 
+    # empty call_seq (RDoc bug)
+    if method.call_seq.strip.empty?
+      warn "call-seq empty: #{method.parent.full_name}#{method.name_prefix}#{method.name}"
+      return ''
+    end
+
     # I assume it is safe to use \001 \002 \003 \004 to escape & < > "
     text = method.call_seq.strip.gsub(/->/, "\001rarr;")
     ospan = "\002span class=\004#{method_name_class}\004\003"
     cspan = "\002/span\003"
 
-    if method.name =~ /^[a-z]/i
+    # the "or warn" below fire when the alias is not in the call-seq:
+    # ARGF#inspect: nope 1
+    # Array#size: nope 1
+    # BasicObject#singleton_method_removed: nope 1
+    # BasicObject#singleton_method_undefined: nope 1
+    # Complex#real?: nope 1
+    # Enumerator::ArithmeticSequence#===: nope 3.2
+    # Enumerator::ArithmeticSequence#eql?: nope 1
+    # Enumerator::Lazy#_enumerable_drop: nope 1
+    # Enumerator::Lazy#_enumerable_drop_while: nope 1
+    # Enumerator::Lazy#_enumerable_filter_map: nope 1
+    # Enumerator::Lazy#_enumerable_flat_map: nope 1
+    # Enumerator::Lazy#_enumerable_grep: nope 1
+    # Enumerator::Lazy#_enumerable_grep_v: nope 1
+    # Enumerator::Lazy#_enumerable_map: nope 1
+    # Enumerator::Lazy#_enumerable_reject: nope 1
+    # Enumerator::Lazy#_enumerable_select: nope 1
+    # Enumerator::Lazy#_enumerable_take: nope 1
+    # Enumerator::Lazy#_enumerable_take_while: nope 1
+    # Enumerator::Lazy#_enumerable_uniq: nope 1
+    # Enumerator::Lazy#_enumerable_zip: nope 1
+    # Enumerator::Lazy#_enumerable_with_index: nope 1
+    # FalseClass#inspect: nope 1
+    # Fiber#inspect: nope 1
+    # File::empty?: nope 1
+    # File::Stat#size?: nope 1
+    # FileTest#empty?: nope 1
+    # Float#===: nope 3.2
+    # Float#inspect: nope 1
+    # Hash#initialize_copy: nope 1
+    # Integer#===: nope 3.2
+    # Integer#inspect: nope 1
+    # Method#===: nope 3.2
+    # Module#extended: nope 1
+    # Module#inspect: nope 1
+    # Module#method_added: nope 1
+    # Module#method_removed: nope 1
+    # Module#method_undefined: nope 1
+    # Module#prepended: nope 1
+    # Numeric#%: nope 3.2
+    # Proc#===: nope 3.2
+    # Proc#inspect: nope 1
+    # Process::Sys::getegid: nope 1
+    # String#initialize_copy: nope 1
+    # Struct#deconstruct: nope 1
+    # Symbol#===: nope 3.2
+    # Symbol#next: nope 1
+    # Thread#inspect: nope 1
+    # TrueClass#inspect: nope 1
+
+    if method.name =~ /^\w/
       # look for things like 'IO.open' or 'open' at the beginning of lines
       name = Regexp.escape(method.name.sub(/=$/, ''))
-      re = Regexp.new('^(\s*)([:\w]+\.)?(' << name << ')', Regexp::MULTILINE)
-      text.gsub!(re, "\\1\\2#{ospan}\\3#{cspan}")
+      re = /^(\s*)([:\w]+\.)?(#{name})/
+      text.gsub!(re, "\\1\\2#{ospan}\\3#{cspan}") #or warn "#{method.parent.full_name}#{method.name_prefix}#{method.name}: nope 1"
     elsif method.name =~ /\[\]=?/
       # [] and []=
-      text.gsub!(/\[/m, "#{ospan}[#{cspan}")
-      text.gsub!(/\]/m, "#{ospan}]#{cspan}")
+      re = /[\[\]]/
+      sub_hash = { '[' => "#{ospan}[#{cspan}", ']' => "#{ospan}]#{cspan}" }
+      text.gsub!(re, sub_hash) #or warn "#{method.parent.full_name}#{method.name_prefix}#{method.name}: nope 2"
     else
       # operators:
+      # +(unary) -(unary)  ~  !
       # **
-      # -(unary) +(unary) ~
       # *  /  %
       # +  -
       # <<  >>
       # &
       # |  ^
       # >  >=  <  <=
-      # <=> == === =~
-      name = Regexp.escape(method.name)
-      re = Regexp.new(name, Regexp::MULTILINE)
-      text.gsub!(re, "#{ospan}\\&#{cspan}")
+      # <=>  ==  ===  =~
+      # !=  `  !~
+      case method.name
+      # -(unary) +(unary)
+      when '+@', '-@'
+        re = /^(\s*)(#{Regexp.escape(method.name[0])})/
+        text.gsub!(re, "\\1#{ospan}\\2#{cspan}") #or warn "#{method.parent.full_name}#{method.name_prefix}#{method.name}: nope 3.1"
+      else
+        re = /^(.*?)(#{Regexp.escape(method.name)})/
+        text.gsub!(re, "\\1#{ospan}\\2#{cspan}") #or warn "#{method.parent.full_name}#{method.name_prefix}#{method.name}: nope 3.2"
+      end
     end
 
-    h(text).gsub("\001", '&').gsub("\002",'<').gsub("\003",'>').gsub("\004",'"').gsub("\n", '<br/>')
+    h(text).tr("\001\002\003\004", '&<>"').gsub("\n", '<br/>')
   end
 
 protected

data/lib/rdoc/generator/ruby-lang/class-page.html.erb

@@ -1,11 +1,11 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!DOCTYPE html>
+<html lang="en">
 <head>
-  <meta http-equiv="content-type" content="text/html; charset=<%= @options.charset %>" />
+  <meta charset="<%= @options.charset %>">
   <title><%= @class.type.capitalize %> <%= @class.full_name %></title>
-  <link href="<%= @stylesheet_url %>" media="all" rel="stylesheet" type="text/css" />
-  <script src="<%= @rel_prefix %>/scripts/jquery.js" type="text/javascript" charset="utf-8"></script>
-  <script src="<%= @rel_prefix %>/scripts/mainFrame.js" type="text/javascript" charset="utf-8"></script>
+  <link href="<%= @stylesheet_url %>" rel="stylesheet">
+  <script src="<%= @rel_prefix %>/scripts/jquery.js" type="text/javascript"></script>
+  <script src="<%= @rel_prefix %>/scripts/mainFrame.js" type="text/javascript"></script>
 </head>
 <body>
 
@@ -28,7 +28,7 @@
       <span class="in-files">In:</span>
       <span class="first-files">
       <% @class.in_files.each do |f| %>
-        <a href="<%= @rel_prefix %>/<%= h f.path %>"><%= h f.full_name %></a><br/>
+        <a href="<%= @rel_prefix %>/<%= h f.path %>"><%= h f.full_name %></a><br>
       <% end %>
       </span>
     </span>
@@ -36,7 +36,7 @@
       <span class="in-files">In:</span>
       <span class="first-files">
       <% @class.in_files.each do |f| %>
-        <a href="#"><%= h f.full_name %></a><br/>
+        <a href="#"><%= h f.full_name %></a><br>
       <% end %>
       </span>
     </span>
@@ -44,21 +44,21 @@
     <span class="displayed">
       <span class="in-files">In:</span>
       <span class="first-files">
-        <a href="<%= @rel_prefix %>/<%= h @class.in_files.first.path %>"><%= h @class.in_files.first.full_name %></a><br/>
+        <a href="<%= @rel_prefix %>/<%= h @class.in_files.first.path %>"><%= h @class.in_files.first.full_name %></a><br>
         <a href="#" id="show-all-files">(<%= @class.in_files.length - 1 %> more...)</a>
       </span>
     </span>
     <span class="hidden">
       <span class="in-files">In:</span>
       <span class="first-files">
-        <a href="#"><%= h @class.in_files.first.full_name %></a><br/>
+        <a href="#"><%= h @class.in_files.first.full_name %></a><br>
         <a href="#" id="show-all-files">(<%= @class.in_files.length - 1 %> more...)</a>
       </span>
     </span>
-    <br/>
+    <br>
     <span id="all-files">
     <% @class.in_files[1..-1].each do |f| %>
-      <a href="<%= @rel_prefix %>/<%= h f.path %>"><%= h f.full_name %></a><br/>
+      <a href="<%= @rel_prefix %>/<%= h f.path %>"><%= h f.full_name %></a><br>
     <% end %>
     </span>
   <% end %>
@@ -93,9 +93,9 @@
       <% end %>
     </ul>
   <% end %>
-  <% unless @class.instance_method_list.empty? %>
+  <% unless @class.instance_methods.empty? %>
     <ul>
-      <% @class.instance_method_list.sort.each do |m| %>
+      <% @class.instance_methods.sort.each do |m| %>
       <% litag = m.documented? ? '<li>' : '<li class="nodoc">' %>
       <%= litag %><a href="#<%= m.aref %>"><span class="type"><%= @options.show_hash ? '#' : '' %></span><%= h m.name %></a></li>
       <% end %>

data/lib/rdoc/generator/ruby-lang/file-page.html.erb

@@ -1,18 +1,18 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!DOCTYPE html>
+<html lang="en">
 <head>
-  <meta http-equiv="content-type" content="text/html; charset=<%= @options.charset %>" />
+  <meta charset="<%= @options.charset %>">
   <title>File <%= @file.base_name %></title>
-  <link href="<%= @stylesheet_url %>" media="all" rel="stylesheet" type="text/css" />
-  <script src="<%= @rel_prefix %>/scripts/jquery.js" type="text/javascript" charset="utf-8"></script>
-  <script src="<%= @rel_prefix %>/scripts/mainFrame.js" type="text/javascript" charset="utf-8"></script>
+  <link href="<%= @stylesheet_url %>" rel="stylesheet">
+  <script src="<%= @rel_prefix %>/scripts/jquery.js" type="text/javascript"></script>
+  <script src="<%= @rel_prefix %>/scripts/mainFrame.js" type="text/javascript"></script>
 </head>
 <body>
 <div id="header">
   <p class="header-title"><span class="prefix">File</span><span class="name"> <%= @file.base_name %></span></p>
   <p id="file-info">
     <span class="displayed">
-      Path: <%= @file.absolute_name %><br/>
+      Path: <%= @file.absolute_name %><br>
       Modified: <%= @file.last_modified ? @file.last_modified.strftime('%Y-%m-%d %H:%M:%S') : 'unknown' %>
     </span>
   </p>

data/lib/rdoc/generator/ruby-lang/index.html.erb

@@ -1,11 +1,11 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!DOCTYPE html>
+<html lang="en">
 <head>
-  <meta http-equiv="content-type" content="text/html; charset=<%= @options.charset %>" />
+  <meta charset="<%= @options.charset %>">
   <title><%= h @options.title %></title>
 </head>
 <frameset cols="20%,*">
-  <frame name="indexFrame" src="indexes.html" />
-  <frame name="mainFrame" src="<%= @first_page.path %>" />
+  <frame name="indexFrame" src="indexes.html">
+  <frame name="mainFrame" src="<%= @first_page.path %>">
 </frameset>
 </html>

data/lib/rdoc/generator/ruby-lang/indexes.html.erb

@@ -1,13 +1,13 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!DOCTYPE html>
+<html lang="en">
 <head>
-  <meta http-equiv="content-type" content="text/html; charset=<%= @options.charset %>" />
+  <meta charset="<%= @options.charset %>">
   <title>Index of <%= @simple_files.empty? ? '' : 'Files, ' %> Classes &amp; Methods in <%= h @options.title %></title>
-  <link href="<%= @stylesheet_url %>" media="all" rel="stylesheet" type="text/css" />
-  <script src="scripts/jquery.js" type="text/javascript" charset="utf-8"></script>
-  <script src="scripts/jquery.quicksearch.js" type="text/javascript" charset="utf-8"></script>
-  <script src="scripts/indexFrame.js" type="text/javascript" charset="utf-8"></script>
-  <base target="mainFrame"/>
+  <link href="<%= @stylesheet_url %>" rel="stylesheet">
+  <script src="scripts/jquery.js" type="text/javascript"></script>
+  <script src="scripts/jquery.quicksearch.js" type="text/javascript"></script>
+  <script src="scripts/indexFrame.js" type="text/javascript"></script>
+  <base target="mainFrame">
 </head>
 <body class="index">
 <% $stderr.sync = true %>
@@ -23,7 +23,7 @@
 <% end %>
   <div id="class-index">
     <div class="title">
-      <span class="text">Classes </span><input type="text" value="" class="search-field" />
+      <span class="text">Classes </span><input type="text" value="" class="search-field">
     </div>
     <div class="entries">
     <% @all_classes_and_modules.each do |k| %>
@@ -36,7 +36,7 @@
 
   <div id="method-index">
     <div class="title">
-      <span class="text">Methods </span><input type="text" value="" class="search-field" />
+      <span class="text">Methods </span><input type="text" value="" class="search-field">
     </div>
     <div class="entries">
     <% @all_methods.each do |m| %>

data/lib/rdoc/generator/ruby-lang/rdoc.css

@@ -19,21 +19,40 @@ pre, p, h1, h2, h3, h4, h5, h6, ul, ol, dl {
 }
 
 td {
-  vertical-align: top;
+  vertical-align: baseline;
   padding-right: 1ex;
 }
 
 ul { margin-left: 1.5em; }
-ol { margin-left: 2em; }
 li { margin-top: 0.5ex; }
+
+ol { margin-left: 2em; }
 ol li { margin-top: 1em; }
 
-dt {
+/* label lists: classic DT/DD */
+
+.label-list dt {
   margin-top: 1ex;
   font-weight: bold;
 }
-dt code { font-size: 100%; }
-dd { margin-left: 2em; }
+.label-list dt code { font-size: 100%; }
+.label-list dd { margin-left: 2em; }
+
+/* note lists: DT and DD on same row, no space between rows */
+
+dl.note-list {
+  display: grid;
+  grid-template-columns: max-content auto;
+  margin-left: 1ex;
+}
+dl.note-list dt { grid-column-start: 1; }
+dl.note-list dd { grid-column-start: 2; margin-left: 2ex; }
+dl.note-list dd p { margin-top: 0; }
+dl.note-list dd pre {
+  margin-top: 2px;
+  padding-top: 0.5ex;
+  padding-bottom: 0.5ex;
+}
 
 table {
   border-collapse: collapse;
@@ -44,10 +63,6 @@ td p {
   margin-top: 0.5ex;
 }
 
-table.rdoc-list .rdoc-term {
-  font-weight: bold;
-}
-
 hr {
   margin-top: 1ex;
   border: 0;
@@ -62,7 +77,6 @@ a {
 }
 
 a:hover {
-  color: #00C;
   background-color: #ffa; /* pale yellow */
   padding-bottom: 2px;
 }
@@ -99,10 +113,9 @@ body.index {
 .index .title {
   padding: 3px 2px 5px 5px; /* TRBL */
   font-family: Georgia, Palatino, "Times New Roman", Times, serif;
-  font-size: 100%;
 }
 .search-field {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   position: absolute;
   right: 3px;
   padding: 0 1px 2px 2px; /* TRBL */
@@ -155,56 +168,42 @@ h1, h2, h3, h4, h5, h6 {
 }
 
 h1, h2, h3 {
-  border-bottom: 1px dotted #ddd;
-}
-
-h1 a, h2 a, h3 a {
-  color: red; /* not the best, but no other idea */
-}
-
-h1 a:hover, h2 a:hover, h3 a:hover {
-  color: red;
-}
-
-h1 {
   margin-top: 1em;
   margin-bottom: 1ex;
-  font-size: 200%;
+  border-bottom: 1px solid #ddd;
 }
 
-h2 {
-  margin-top: 1em;
-  margin-bottom: 1ex;
-  font-size: 150%;
+h4, h5, h6 {
+  margin-top: 0.75em;
+  border: none;
 }
 
-h3 {
-  margin-top: 1em;
-  margin-bottom: 1ex;
-  font-size: 120%;
-  font-weight: bold;
+h1 a, h2 a, h3 a {
+  color: #e62020; /* not the best, but no other idea */
 }
 
+h1 { font-size: 230%; }
+h2 { font-size: 180%; }
+h3 { font-size: 150%; }
+h4 { font-size: 120%; }
+h5 { font-size: 105%; }
+h6 { font-size: 100%; }
+
 #documentation > h1:first-child,
 #documentation > h2:first-child,
 #documentation > h3:first-child {
   margin-top: 0;
 }
 
-h4, h5, h6 {
-  margin-top: 0.75em;
-  border: none;
-}
-
 code {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   font-size: 100%;
 }
 
 pre {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   padding: 1ex;
-  background-color: #f5f5f5;  /* very pale grey */
+  background-color: #f8f8f8;  /* very pale grey */
 }
 
 #documentation {
@@ -270,7 +269,7 @@ pre {
 #header a:hover {
   color: yellow;
   background-color: inherit;
-  border-bottom: 1px dotted yellow;
+  border-bottom: 1px solid yellow;
 }
 
 .header-title {
@@ -283,7 +282,7 @@ pre {
 #header .parent { font-size: 130%; }
 
 #file-info {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   font-size: 90%;
   vertical-align: top;
 }
@@ -391,7 +390,7 @@ pre {
 }
 #method-list li {
   display: inline-block;
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   font-size: 100%;
   padding: 2px 0;
 }
@@ -429,10 +428,10 @@ table.classes-modules {
   padding: 0.75ex 0 0 1ex;
 }
 .const-name p, .attr-name p {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   font-size: 100%;
   font-weight: bold;
-  padding: 0 0.5ex 0 0.2ex;
+  padding: 0.3ex 0.5ex 0 0.2ex;  /* top padding to align baselines */
 }
 .const-desc p, .attr-desc p {
 }
@@ -443,7 +442,7 @@ table.classes-modules {
   visibility: visible;
 }
 .const-value {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   display: none;
 }
 
@@ -457,7 +456,7 @@ table.classes-modules {
 */
 
 .method-detail {
-  border: 1px dotted #ddd;
+  border: 1px solid #ddd;
   margin-top: 1em;
   padding-bottom: 1ex;
   /* cursor: pointer; */
@@ -475,10 +474,10 @@ table.classes-modules {
 
 .method-heading {
   position: relative;
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
   font-size: 105%;
   padding: 0.5ex 1ex;
-  border-bottom: 1px dotted #ddd;
+  border-bottom: 1px solid #ddd;
   background-color: #eee;
   cursor: pointer;
 }
@@ -559,7 +558,7 @@ pre.method-source-code {
 
 /* requires */
 #file-details li {
-  font-family: Monaco, Consolas, "Lucida Console", monospace;
+  font-family: Consolas, Monaco, "Lucida Console", monospace;
 }
 
 /* maybe JS stuff */

data/test/test_rdoc_generator_babel.rb

@@ -1,5 +1,4 @@
 require 'rdoc'
-require 'rdoc/generator/babel'
 require 'minitest/autorun'
 require 'tmpdir'
 require 'nokogiri'
@@ -168,14 +167,14 @@ class TestRDocGeneratorBabel < Minitest::Test
     check_call_seq '<<', <<-CALL, <<-HTML.strip
       ios << obj     -> ios
     CALL
-      ios <span class=\"c\">&lt;&lt;</span> obj     &rarr; ios
+      ios <span class="c">&lt;&lt;</span> obj     &rarr; ios
     HTML
 
     check_call_seq 'pos', <<-CALL, <<-HTML.strip.gsub("\n", '')
       ios.pos     -> integer
       ios.tell    -> integer
     CALL
-      ios.<span class=\"c\">pos</span>     &rarr; integer<br/>
+      ios.<span class="c">pos</span>     &rarr; integer<br/>
       ios.tell    &rarr; integer
     HTML
 
@@ -183,8 +182,8 @@ class TestRDocGeneratorBabel < Minitest::Test
       ios.readpartial(maxlen) -> string
       ios.readpartial(maxlen, outbuf) -> outbuf
     CALL
-      ios.<span class=\"c\">readpartial</span>(maxlen) &rarr; string<br/>
-      ios.<span class=\"c\">readpartial</span>(maxlen, outbuf) &rarr; outbuf
+      ios.<span class="c">readpartial</span>(maxlen) &rarr; string<br/>
+      ios.<span class="c">readpartial</span>(maxlen, outbuf) &rarr; outbuf
     HTML
 
     check_call_seq '[]', <<-CALL, <<-HTML.strip.gsub("\n", '')
@@ -195,9 +194,9 @@ class TestRDocGeneratorBabel < Minitest::Test
       array.slice(start, length)  - an_array or nil
       array.slice(range)          - an_array or nil
     CALL
-      array<span class=\"c\">[</span>index<span class=\"c\">]</span>                - obj      or nil<br/>
-      array<span class=\"c\">[</span>start, length<span class=\"c\">]</span>        - an_array or nil<br/>
-      array<span class=\"c\">[</span>range<span class=\"c\">]</span>                - an_array or nil<br/>
+      array<span class="c">[</span>index<span class="c">]</span>                - obj      or nil<br/>
+      array<span class="c">[</span>start, length<span class="c">]</span>        - an_array or nil<br/>
+      array<span class="c">[</span>range<span class="c">]</span>                - an_array or nil<br/>
       array.slice(index)          - obj      or nil<br/>
       array.slice(start, length)  - an_array or nil<br/>
       array.slice(range)          - an_array or nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rdoc-babel
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.1
 platform: ruby
 authors:
 - Thierry Lambert
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-08-02 00:00:00.000000000 Z
+date: 2022-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdoc
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.1'
+        version: '6.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.1'
+        version: '6.3'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.11'
+        version: '5.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.11'
+        version: '5.14'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -52,44 +52,23 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.10'
-- !ruby/object:Gem::Dependency
-  name: hoe
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.18'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.18'
-description: |-
+description: |
   Babel is an RDoc formatter producing HTML documentation.
-  The default template is +ruby-lang+.
-
-  - Look and feel inspired from ruby-lang.org[http://www.ruby-lang.org/].
+  The default template is +ruby-lang+:
+  - Look and feel inspired from https://www.ruby-lang.org/.
   - Dual-frame output, with indexes on the left.
   - Search boxes for classes and methods.
   - Links to undocumented classes/methods are grayed.
   - Highlights target methods, attributes and constants.
   - Adds links to ancestor methods/attributes.
-  - Borrows some ideas (and one icon) from Darkfish.
-  - Tested on Firefox 3.5 & 5, Chrome 9 & 12, Safari 4 & 5.
-email:
-- thyresias@gmail.com
+email: thyresias@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- HISTORY.rdoc
-- Manifest.txt
 - README.rdoc
+- HISTORY.rdoc
 files:
-- ".autotest"
 - HISTORY.rdoc
-- Manifest.txt
 - README.rdoc
 - Rakefile
 - lib/rdoc/discover.rb
@@ -104,7 +83,6 @@ files:
 - lib/rdoc/generator/ruby-lang/scripts/jquery.js
 - lib/rdoc/generator/ruby-lang/scripts/jquery.quicksearch.js
 - lib/rdoc/generator/ruby-lang/scripts/mainFrame.js
-- lib/rdoc_babel.rb
 - test/data/HISTORY.rdoc
 - test/data/README.rdoc
 - test/data/ancestors.rb
@@ -115,12 +93,14 @@ files:
 - test/data/no_content.rb
 - test/data/not_commented.rb
 - test/test_rdoc_generator_babel.rb
-homepage: http://github.com/thyresias/rdoc-babel
+homepage: https://github.com/thyresias/rdoc-babel
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options:
+- "--title"
+- RDoc Babel
 - "--main"
 - README.rdoc
 require_paths:
@@ -136,8 +116,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
-signing_key: 
+rubygems_version: 3.3.8
+signing_key:
 specification_version: 4
 summary: An RDoc formatter producing HTML documentation.
 test_files: []

data/.autotest

@@ -1,12 +0,0 @@
-require 'autotest/restart'
-
-Autotest.add_hook :initialize do |at|
-  at.testlib = 'minitest/unit'
-  class << at
-    alias zen_path_to_classname path_to_classname
-    def path_to_classname(s)
-      zen_path_to_classname(s).sub('Rdoc', 'RDoc')
-    end
-  end
-end
-

data/Manifest.txt

@@ -1,28 +0,0 @@
-.autotest
-HISTORY.rdoc
-Manifest.txt
-Rakefile
-README.rdoc
-lib/rdoc/discover.rb
-lib/rdoc/generator/babel.rb
-lib/rdoc/generator/ruby-lang/class-page.html.erb
-lib/rdoc/generator/ruby-lang/file-page.html.erb
-lib/rdoc/generator/ruby-lang/images/zoom.png
-lib/rdoc/generator/ruby-lang/index.html.erb
-lib/rdoc/generator/ruby-lang/indexes.html.erb
-lib/rdoc/generator/ruby-lang/rdoc.css
-lib/rdoc/generator/ruby-lang/scripts/indexFrame.js
-lib/rdoc/generator/ruby-lang/scripts/jquery.js
-lib/rdoc/generator/ruby-lang/scripts/jquery.quicksearch.js
-lib/rdoc/generator/ruby-lang/scripts/mainFrame.js
-lib/rdoc_babel.rb
-test/data/ancestors.rb
-test/data/commented.rb
-test/data/context_alias.rb
-test/data/HISTORY.rdoc
-test/data/main_file.rb
-test/data/not_commented.rb
-test/data/no_class_nor_module.rb
-test/data/no_content.rb
-test/data/README.rdoc
-test/test_rdoc_generator_babel.rb

data/lib/rdoc_babel.rb

@@ -1,3 +0,0 @@
-module RDocBabel
-  VERSION = '1.0.4'
-end