sdoc 1.1.0 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19f36e49016466f31b053d9a66c757e33998e7023ddad39f2d86f46834fd4784
-  data.tar.gz: 36b2ca06033e0caecb8b5bbcf61210a5bd7139b1f66919b112c1af738fa3d0b0
+  metadata.gz: b8d4b29d6331f29ea069228638d3acdf6f0cda3894526984025b3ae62eea2523
+  data.tar.gz: 7d5d3d5048e21d0cfa869d28a3963289efa457b6d52ca38c852f486ba33a382a
 SHA512:
-  metadata.gz: 837f60a6d4880c4fa5e1000c5216377a1827aab83f0ec2ecffccd903533215a3b4a972beec2a2ec0c3a9332bde5d05477f3c066da950d8eda3776f41f950f5fc
-  data.tar.gz: 965695dcc2e8e9c2e8ea1a608be79549767a719f607721f3364a72b5b5398c48ccd6f9d19d992954565fcf40b9d31922083a98e30760ad628b1558e1315c5e57
+  metadata.gz: fe1810f968c179d72c4d22bdcb79097217566c52f4cc50ac2904e443a0dddc205065e06f9bcaea18be36e485a95a565bea96103e45503fffbbfaec8c4482db21
+  data.tar.gz: 24fa176a0ed31025b545f80652b936fa224be2bfa013b6ff5969eb3ee33d6221f2066ec48901cafc5cc8effbbe4281b17f120c5833574eac915693ff3bf0dd89

data/.travis.yml

@@ -1,8 +1,8 @@
 language: ruby
 cache: bundler
 before_install:
-  - gem update --system
-  - gem install bundler
+  - gem update --system || gem update --system 2.7.8
+  - gem install bundler || gem install bundler -v 1.17.3
 rvm:
   - 1.9.3
   - 2.0.0
@@ -11,6 +11,7 @@ rvm:
   - 2.3.7
   - 2.4.4
   - 2.5.1
+  - 2.6.0
   - ruby-head
   - jruby-head
 matrix:
@@ -22,6 +23,7 @@ matrix:
     - { rvm: 2.3.7, env: rdoc=master }
     - { rvm: 2.4.4, env: rdoc=master }
     - { rvm: 2.5.1, env: rdoc=master }
+    - { rvm: 2.6.0, env: rdoc=master }
     - { rvm: ruby-head, env: rdoc=master }
     - { rvm: jruby-head, env: rdoc=master }
 notifications:

data/CHANGELOG.md

@@ -1,3 +1,32 @@
+2.0.4
+=====
+
+* #149 Using HTML5 doctype accross all HTML files. [@MikeRogers0](https://github.com/MikeRogers0)
+* #148 Fix overflow CSS property of panel elements. [@cveneziani](https://github.com/cveneziani)
+
+2.0.3
+=====
+
+* #147 Use @options.title for the index [@p8](https://github.com/p8)
+
+2.0.2
+=====
+
+* Remove accidental rack inclusion in gemspec
+
+2.0.1
+=====
+
+* #142 Fix arrow icons for selected panel items [@p8](https://github.com/p8)
+* #141 Always use only one metatag for keywords [@p8](https://github.com/p8)
+* #140 Use h2 instead of h1 for banner header [@p8](https://github.com/p8)
+
+2.0.0
+=====
+
+* #137 Replace frames based implementation with a css [@p8](https://github.com/p8)
+* #132 Deprecate safe_level of ERB.new in Ruby 2.6
+
 1.1.0
 =====
 

data/README.md

@@ -90,6 +90,24 @@ Please feel free to still report issues here for both projects, especially if yo
 
 As maintainer of both projects, I'll see if I can identify the root of the cause :bow: :bow: :bow:
 
+## Contributing
+
+If you'd like to contribute you can generate the Rails documentation by running:
+
+```bash
+rake test:rails
+```
+
+This task will generate documentation for the Rails master branch.
+Since the task doesn't do any file filtering it contains a lot of extra pages.
+
+To view the just generated documentation start up a rack application by running:
+
+```bash
+rackup config.ru
+```
+
+Then open http://localhost:9292 in the browser to view the documentation.
 
 ### Who?
 

data/config.ru

@@ -0,0 +1,30 @@
+# Rack application for serving the documentation locally.
+# After generating the documentation run:
+#
+#   bundle exec rackup config.ru
+#
+require 'bundler/setup'
+
+root = "doc/rails"
+unless Dir.exists?(root)
+  puts <<~MESSAGE
+    Could not find any docs in #{root}.
+    Run the following command to generate sample documentation:
+      bundle exec rake test:rails
+  MESSAGE
+  exit
+end
+
+use Rack::Static,
+  :urls => ["/files", "/images", "/js", "/css", "/panel", "/i", "/classes"],
+  :root => root
+run lambda { |env|
+  [
+    200,
+    { 
+      'Content-Type'  => 'text/html',
+      'Cache-Control' => 'public, max-age=86400'
+    },
+    File.open("#{root}/index.html", File::RDONLY)
+  ]
+}

data/lib/rdoc/generator/template/rails/_head.rhtml

@@ -1,6 +1,39 @@
-<link rel="stylesheet" href="<%= "#{rel_prefix}/css/reset.css" %>" type="text/css" media="screen" />
-<link rel="stylesheet" href="<%= "#{rel_prefix}/css/main.css" %>" type="text/css" media="screen" />
-<link rel="stylesheet" href="<%= "#{rel_prefix}/css/github.css" %>" type="text/css" media="screen" />
-<script src="<%= "#{rel_prefix}/js/jquery-1.3.2.min.js" %>" type="text/javascript" charset="utf-8"></script>
-<script src="<%= "#{rel_prefix}/js/main.js" %>" type="text/javascript" charset="utf-8"></script>
-<script src="<%= "#{rel_prefix}/js/highlight.pack.js" %>" type="text/javascript" charset="utf-8"></script>
+<%
+  # Turbolinks does not consider relative urls similar, resulting in page
+  # reloads and losing the context of the panel. Emptying the rel_prefix makes
+  # asset paths absolute. This breaks opening the docs locally. Maybe all
+  # generated docs should be in the same folder?
+  rel_prefix = ''
+%>
+<link rel="stylesheet" href="<%= "#{rel_prefix}/css/reset.css" %>" type="text/css" media="screen" data-turbolinks-track="reload" />
+<link rel="stylesheet" href="<%= "#{rel_prefix}/css/panel.css" %>" type="text/css" media="screen" data-turbolinks-track="reload" />
+<link rel="stylesheet" href="<%= "#{rel_prefix}/css/main.css" %>" type="text/css" media="screen" data-turbolinks-track="reload" />
+<link rel="stylesheet" href="<%= "#{rel_prefix}/css/github.css" %>" type="text/css" media="screen" data-turbolinks-track="reload" />
+<script src="<%= "#{rel_prefix}/js/jquery-3.5.1.min.js" %>" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= "#{rel_prefix}/js/main.js" %>" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= "#{rel_prefix}/js/highlight.pack.js" %>" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= rel_prefix %>/js/turbolinks.js" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= rel_prefix %>/js/search_index.js" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= rel_prefix %>/js/searcher.js" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= rel_prefix %>/panel/tree.js" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script src="<%= rel_prefix %>/js/searchdoc.js" type="text/javascript" charset="utf-8" data-turbolinks-track="reload"></script>
+<script type="text/javascript" charset="utf-8">
+document.addEventListener("turbolinks:load", function() {
+  // Only initialize panel if not yet initialized
+  if(!$('#panel .tree ul li').length) {
+    $('#links').hide();
+    var panel = new Searchdoc.Panel($('#panel'), search_data, tree, '<%= rel_prefix %>/');
+    $('#search').focus();
+    var s = window.location.search.match(/\?q=([^&]+)/);
+    if (s) {
+      s = decodeURIComponent(s[1]).replace(/\+/g, ' ');
+      if (s.length > 0) {
+        $('#search').val(s);
+        panel.search(s, true);
+      }
+    }
+    panel.toggle(<%= tree_keys %>);
+  }
+})
+</script>
+

data/lib/rdoc/generator/template/rails/_panel.rhtml

@@ -0,0 +1,14 @@
+<div class="panel panel_tree" id="panel" data-turbolinks-permanent>
+  <div class="header">
+    <input type="text" placeholder="Search for a class, method, ..." autosave="searchdoc" results="10" id="search" autocomplete="off" />
+  </div>
+  <div class="tree">
+    <ul>
+    </ul>
+  </div>
+  <div class="result">
+    <ul>
+    </ul>
+  </div>
+  <a href="links.html" id="links">index</a>
+</div>

data/lib/rdoc/generator/template/rails/class.rhtml

@@ -3,7 +3,7 @@
 <head>
     <title><%= h klass.full_name %></title>
     <meta charset="<%= @options.charset %>" />
-    <%= include_template '_head.rhtml', {:rel_prefix => rel_prefix} %>
+    <%= include_template '_head.rhtml', {:rel_prefix => rel_prefix, :tree_keys => klass.full_name.split('::') } %>
 
     <meta property="og:title" value="<%= klass.full_name %>">
 
@@ -13,18 +13,18 @@
     <meta property="og:description" content="<%= human_desc %>">
   <% end %>
 
-    <meta name="keywords" content="<%= klass.full_name %> class">
-  <% unless klass.method_list.empty? %>
-    <meta name="keywords" content="<%= klass.method_list.map(&:name).join(", ") %>">
-  <% end %>
+    <meta name="keywords" content="<%= klass.full_name %> class, <%= klass.method_list.map(&:name).join(", ") %>">
 </head>
 
 <body>
+
+    <%= include_template '_panel.rhtml' %>
+
     <div class="banner">
         <% if ENV['HORO_PROJECT_NAME'] %>
             <span><%= ERB::Util.html_escape(ENV['HORO_PROJECT_NAME']) %> <%= ERB::Util.html_escape(ENV['HORO_PROJECT_VERSION']) %></span><br />
         <% end %>
-        <h1>
+        <h2>
             <span class="type"><%= klass.module? ? 'Module' : 'Class' %></span>
             <%= h klass.full_name %>
             <% if klass.type == 'class' %>
@@ -36,13 +36,14 @@
                     <% end %>
                 </span>
             <% end %>
-        </h1>
+        </h2>
         <ul class="files">
             <% klass.in_files.each do |file| %>
             <li><a href="<%= "#{rel_prefix}/#{h file.path}" %>"><%= h file.absolute_name %></a></li>
             <% end  %>
         </ul>
     </div>
+
     <div id="bodyContent">
         <%= include_template '_context.rhtml', {:context => klass, :rel_prefix => rel_prefix} %>
     </div>

data/lib/rdoc/generator/template/rails/file.rhtml

@@ -3,17 +3,20 @@
 <head>
     <title><%= h file.name %></title>
     <meta charset="<%= @options.charset %>" />
-    <%= include_template '_head.rhtml', {:rel_prefix => rel_prefix} %>
+    <%= include_template '_head.rhtml', {:rel_prefix => rel_prefix, :tree_keys => [] } %>
 </head>
 
 <body>
+
+    <%= include_template '_panel.rhtml' %>
+
     <div class="banner">
         <% if ENV['HORO_PROJECT_NAME'] %>
             <span><%= ERB::Util.html_escape(ENV['HORO_PROJECT_NAME']) %> <%= ERB::Util.html_escape(ENV['HORO_PROJECT_VERSION']) %></span><br />
         <% end %>
-        <h1>
+        <h2>
             <%= h file.name %>
-        </h1>
+        </h2>
         <ul class="files">
             <%
                 github = github_url(file.relative_name) if options.github

data/lib/rdoc/generator/template/rails/index.rhtml

@@ -1,11 +1,31 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-    <meta charset="<%= @options.charset %>">
     <title><%= @options.title %></title>
+    <meta http-equiv="Content-Type" content="text/html; charset=<%= @options.charset %>" />
+    <%= include_template '_head.rhtml', {:rel_prefix => rel_prefix, tree_keys: []} %>
 </head>
-<frameset cols="300,*" frameborder="1" border="1" bordercolor="#999999" framespacing="1">
-    <frame src="panel/index.html" title="Search" name="panel" />
-    <frame src="<%= index_path %>" name="docwin" />
-</frameset>
+
+<body>
+
+    <%= include_template '_panel.rhtml' %>
+
+    <div class="banner">
+        <% if ENV['HORO_PROJECT_NAME'] %>
+            <span><%= ERB::Util.html_escape(ENV['HORO_PROJECT_NAME']) %> <%= ERB::Util.html_escape(ENV['HORO_PROJECT_VERSION']) %></span><br />
+        <% end %>
+        <h2>
+            <%= h index.name %>
+        </h2>
+        <ul class="files">
+            <li><%= h index.relative_name %></li>
+            <li>Last modified: <%= index.last_modified %></li>
+        </ul>
+    </div>
+
+    <div id="bodyContent">
+        <%= include_template '_context.rhtml', {:context => index } %>
+    </div>
+  </body>
 </html>
+

data/lib/rdoc/generator/template/rails/resources/css/main.css

@@ -7,6 +7,10 @@ body {
   line-height: 1.25em;
 }
 
+.banner, #bodyContent {
+  margin-left: 300px;
+}
+
 a:link, a:active, a:visited, a:hover {
   color: #CC0000;
   text-decoration: none;
@@ -121,20 +125,20 @@ ol li
     padding: 1em;
     box-shadow: 1px 1px 3px rgba(0, 0, 0, 0.2);
 }
-.banner h1
+.banner h2
 {
     font-size: 1.2em;
     margin: 0;
 }
 
-.banner h1 .type
+.banner h2 .type
 {
     font-size: 0.833em;
     display:block;
 }
 
-.banner h1 .type,
-.banner h1 .parent
+.banner h2 .type,
+.banner h2 .parent
 {
     color: #CCC;
 }

data/lib/rdoc/generator/template/rails/resources/css/panel.css

@@ -1,15 +1,15 @@
 /* Panel (begin) */
     .panel
     {
-        position: absolute;
-        width: 100%;
+        position: fixed;
+        width: 300px;
         height: 100%;
-        top: 0;
-        left: 0;
         background: #FFF;
         z-index: 2;
         font-family: "Helvetica Neue", "Arial", sans-serif;
         overflow-x: hidden;
+        border-right: 1px #ccc solid;
+        line-height: 1;
     }
 
     .panel_tree .results,
@@ -25,11 +25,11 @@
             background-position: 5px;
             box-shadow: 1px 1px 3px rgba(0, 0, 0, 0.2);
             height: 40px;
-            width: 100%;
-            position: absolute;
+            width: 300px;
+            position: fixed;
             left: 0; top: 0;
             z-index: 300;
-            overflow: hidden;
+            overflow-x: hidden;
         }
 
         .panel .header input
@@ -52,12 +52,12 @@
     /* Results (begin) */
         .panel .result
         {
-            position: absolute;
-            top: 40px;
+            position: relative;
             bottom: 0;
+            top: 40px;
             left: 0;
             width: 100%;
-            overflow-y: scroll;
+            overflow-y: auto;
             overflow-x: hidden;
             z-index: 2;
         }
@@ -74,6 +74,7 @@
             overflow: hidden;
             padding: 4px 10px 0 10px;
             cursor: pointer;
+            margin: 0;
         }
 
         .panel .result ul li:nth-child(2n) {
@@ -85,6 +86,7 @@
             font-size: 13px;
             font-weight: normal;
             color: #333;
+            margin-top: 0;
             margin-bottom: 2px;
             white-space: nowrap;
         }
@@ -217,12 +219,12 @@
         .panel .tree
         {
             background: white;
-            position: absolute;
+            position: relative;
             top: 40px;
             bottom: 0;
             left: 0;
             width: 100%;
-            overflow-y: scroll;
+            overflow-y: auto;
             overflow-x: hidden;
             z-index: 30;
         }
@@ -239,6 +241,7 @@
             overflow: hidden;
             height: 30px;
             line-height: 100%;
+            margin: 0;
         }
 
 
@@ -274,6 +277,7 @@
             font-size: 13px;
             font-weight: normal;
             color: #000;
+            margin-top: 0;
             margin-bottom: 2px;
             white-space: nowrap;
         }
@@ -316,13 +320,13 @@
 
         .panel .tree ul li.current .icon
         {
-            background: url(../i/arrow-right.svg);
+            background: url(../i/arrow-down-current.svg);
             background-size: 10px;
         }
 
         .panel .tree ul li.current.closed .icon
         {
-            background: url(../i/arrow-down.svg);
+            background: url(../i/arrow-right-current.svg);
             background-size: 10px;
         }