ascii_binder 0.1.15.1 → 0.1.15.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca5e0da9158b6d81f979df1bac238a94d555a3e8bbd24d058cadfed498451f64
-  data.tar.gz: 8c25ec95bbe2137dc18e5829b081293180e96c4c11bf47cdc8014c4c8cf3eb1f
+  metadata.gz: b4ac203ed7b94c0bb9d43493fda6eb22519bdada13bf2fa0ce55b3d8b5fb0766
+  data.tar.gz: aa1e116ec3dddc817f60f33d5877ec49877ae792f601b7ec4d886f926b46cd6f
 SHA512:
-  metadata.gz: a28c8777c3295bca96949e9e7b6d25231981daacca49b2ba13de1458dc6d8cba40baddf0094f02741dde1a6953621e726c6a0f108e31d4f5f9fb100117f6573a
-  data.tar.gz: 6e904dfab6183664f12625606a66d709dcc798ac79ce70f8924438ab42da31f0ee62b0ff865d9da6b23b0d96e419085d832b51e4cf672fdfc10fdb9f6411e201
+  metadata.gz: 88367857d4d8fa53510222743248e8290ca0327777ad1dadf06b85a6bfd945ddd63f8746a0900b27f431dde371e983c570116387c082d9f602408b0e4a192bf7
+  data.tar.gz: 9e9b30b36d938e8d3116fa71f09112c0c651a9c8a59bc27b9f86758b0fbe240de802b88dae490b83ff49ef0db4f045bce4df787f85dc1625be0e7d119ccfa18c

data/README.adoc

@@ -4,17 +4,17 @@ image:https://badge.fury.io/rb/ascii_binder.svg["Gem Version", link="https://bad
 
 AsciiBinder is an AsciiDoc-based system for authoring and publishing closely related documentation sets from a single source.
 
+This product is no longer actively maintained.
+
 == Learn More
 
-* See the http://www.asciibinder.org[homepage].
-* Have a gander at the http://www.asciibinder.org/latest/welcome/[AsciiBinder documentation].
-* Or just take the https://rubygems.org/gems/ascii_binder[ascii_binder Ruby Gem] for a spin.
+* Take the https://rubygems.org/gems/ascii_binder[ascii_binder Ruby Gem] for a spin.
 
 The AsciiBinder system was initially developed for https://github.com/openshift/openshift-docs[OpenShift documentation], but has been revised to work for documenting a wide variety of complex, multi-versioned software projects.
 
 == Contributing
 
-We are using the https://github.com/redhataccess/ascii_binder/issues[Issues] page to track bugs and feature ideas on the code, so have a look and feel free to ask questions there. You can also chat with us on IRC at FreeNode, http://webchat.freenode.net/?randomnick=1&channels=asciibinder&uio=d4[#asciibinder] channel, or on Twitter - https://twitter.com/AsciiBinder[@AsciiBinder].
+We are using the https://github.com/redhataccess/ascii_binder/issues[Issues] page to track bugs and feature ideas on the code, so have a look and feel free to ask questions there.
 
 == License
 

data/bin/asciibinder

@@ -133,6 +133,7 @@ EOF
       opt :distro, "Instead of building all distros, build branches only for the specified distro.", :default => ''
       opt :page, "Build only the specified page for all distros and only the current working branch.", :default => ''
       opt :log_level, "Set the logging output level for this operation.", :default => 'warn'
+      opt :toc_depth, "Maximum depth of topics allowed.  Use 0 for infinite depth.", :default => 3
       conflicts :distro, :page
     end
   when "create"
@@ -207,6 +208,7 @@ Options:
 EOF
       opt :site, "Instead of packaging every docs site, package the specified site only.", :default => ''
       opt :log_level, "Set the logging output level for this operation.", :default => 'warn'
+      opt :toc_depth, "Maximum depth of topics allowed.  Use 0 for infinite depth.", :default => 3
     end
   when "help"
     Trollop::educate
@@ -274,6 +276,13 @@ unless cmd_opts.nil? or cmd_opts[:log_level].nil?
 end
 set_log_level(user_log_level)
 
+# Set the depth level
+user_depth = 3
+unless cmd_opts.nil? or cmd_opts[:toc_depth].nil?
+  user_depth = cmd_opts[:toc_depth].to_i
+end
+set_depth(user_depth)
+
 
 # Cloning? Time to try it.
 if cmd == 'clone'

data/lib/ascii_binder/engine.rb

@@ -188,12 +188,13 @@ module AsciiBinder
       args[:breadcrumb_root], args[:breadcrumb_group], args[:breadcrumb_subgroup], args[:breadcrumb_topic] = extract_breadcrumbs(args)
 
       args[:breadcrumb_subgroup_block] = ''
-      args[:subtopic_shim]             = ''
       if args[:breadcrumb_subgroup]
         args[:breadcrumb_subgroup_block] = "<li class=\"hidden-xs active\">#{args[:breadcrumb_subgroup]}</li>"
-        args[:subtopic_shim]             = '../'
       end
 
+      args[:subtopic_shim] = '../' * (args[:topic_id].split('::').length - 2)
+      args[:subtopic_shim] = '' if args[:subtopic_shim].nil?
+
       template_path = File.expand_path("#{docs_root_dir}/_templates/page.html.erb")
       template_renderer.render(template_path, args)
     end
@@ -466,10 +467,6 @@ module AsciiBinder
       article_title = doc.doctitle || topic.name
 
       topic_html = doc.render
-      dir_depth  = ''
-      if branch_config.dir.split('/').length > 1
-        dir_depth = '../' * (branch_config.dir.split('/').length - 1)
-      end
 
       # This is logic bridges newer arbitrary-depth-tolerant code to
       # older depth-limited code. Truly removing depth limitations will
@@ -484,8 +481,9 @@ module AsciiBinder
       if breadcrumb.length == 3
         subgroup_title = breadcrumb[1][:name]
         subgroup_id    = breadcrumb[1][:id]
-        dir_depth      = '../' + dir_depth
       end
+      dir_depth = '../' * topic.breadcrumb[-1][:id].split('::').length
+      dir_depth = '' if dir_depth.nil?
 
       preview_path = topic.preview_path(distro.id,branch_config.dir)
       topic_publish_url = topic.topic_publish_url(distro.site.url,branch_config.dir)
@@ -508,10 +506,10 @@ module AsciiBinder
         :group_id          => group_id,
         :subgroup_id       => subgroup_id,
         :topic_id          => topic_id,
-        :css_path          => "../../#{dir_depth}#{branch_config.dir}/#{STYLESHEET_DIRNAME}/",
-        :javascripts_path  => "../../#{dir_depth}#{branch_config.dir}/#{JAVASCRIPT_DIRNAME}/",
-        :images_path       => "../../#{dir_depth}#{branch_config.dir}/#{IMAGE_DIRNAME}/",
-        :site_home_path    => "../../#{dir_depth}index.html",
+        :css_path          => "#{dir_depth}#{branch_config.dir}/#{STYLESHEET_DIRNAME}/",
+        :javascripts_path  => "#{dir_depth}#{branch_config.dir}/#{JAVASCRIPT_DIRNAME}/",
+        :images_path       => "#{dir_depth}#{branch_config.dir}/#{IMAGE_DIRNAME}/",
+        :site_home_path    => "#{dir_depth}index.html",
         :template_path     => template_dir,
         :repo_path         => topic.repo_path,
       }

data/lib/ascii_binder/helpers.rb

@@ -54,6 +54,10 @@ module AsciiBinder
       AsciiBinder::DOCS_ROOT_DIR
     end
 
+    def set_depth(user_depth)
+      AsciiBinder.const_set("DEPTH", user_depth)
+    end
+
     def set_log_level(user_log_level)
       AsciiBinder.const_set("LOG_LEVEL", log_levels[user_log_level])
     end

data/lib/ascii_binder/topic_entity.rb

@@ -239,12 +239,8 @@ module AsciiBinder
         end
       end
 
-      # Check the depth. For now, max depth is '2':
-      #
-      # [<group>,<subgroup>,<topic>]
-      #
-      # But this limit will be lifted in the next major version
-      if depth > 2
+      # Check the depth.
+      if (depth > AsciiBinder::DEPTH) and (AsciiBinder::DEPTH != 0)
         if verbose
           errors << "#{entity_id} exceeds the maximum nested depth."
         else

data/lib/ascii_binder/version.rb

@@ -1,3 +1,3 @@
 module AsciiBinder
-  VERSION = "0.1.15.1"
+  VERSION = "0.1.15.2"
 end

data/templates/_templates/_breadcrumb.html.erb

@@ -0,0 +1,14 @@
+<%- navigation.each do |topic_group| -%>
+  <%- if topic_id.start_with?(topic_group[:id]) %>
+    <li class="hidden-xs active">
+      <%- if topic_group.has_key?(:topics) -%>
+        <a href="<%= subtopic_shim %><%= topic_group[:path] %>"><%= topic_group[:name] %></a>
+      <%- else -%>
+        <%= topic_group[:name] %>
+      <%- end -%>
+    </li>
+  <%- end -%>
+  <%- if topic_group.has_key?(:topics) -%>
+    <%= render("_templates/_breadcrumb.html.erb", :navigation => topic_group[:topics], :topic_id => topic_id, :subtopic_shim => subtopic_shim) %>
+  <%- end -%>
+<%- end -%>

data/templates/_templates/_nav.html.erb

@@ -1,31 +1,14 @@
-<ul class="nav nav-sidebar">
-  <%- navigation.each.with_index do |topic_group, groupidx| -%>
-    <%- current_group = topic_group[:id] == group_id -%>
+<%- navigation.each do |topic_group| -%>
+  <%- if not topic_group.has_key?(:topics) -%>
+      <li><a class="<%= topic_id.start_with?(topic_group[:id]) ? ' active' : '' %>" href="<%= subtopic_shim %><%= topic_group[:path] %>"><%= topic_group[:name] %></a></li>
+  <%- else -%>
     <li class="nav-header">
-      <a class="" href="#" data-toggle="collapse" data-target="#topicGroup<%= groupidx %>">
-        <span id="tgSpan<%= groupidx %>" class="fa <%= current_group ? 'fa-angle-down' : 'fa-angle-right' %>"></span><%= topic_group[:name] %>
+      <a class="" href="#" data-toggle="collapse" data-target="#topicGroup-<%= topic_group[:id].hash %>">
+        <span id="sgSpan-<%= topic_group[:id].hash %>" class="fa <%= topic_id.start_with?(topic_group[:id]) ? 'fa-caret-down' : 'fa-caret-right' %>"></span>&nbsp;<%= topic_group[:name] %>
       </a>
-      <ul id="topicGroup<%= groupidx %>" class="collapse <%= current_group ? 'in' : '' %> list-unstyled">
-        <%- topic_group[:topics].each.with_index do |topic, topicidx| -%>
-          <%- if not topic.has_key?(:topics) -%>
-            <%- current_topic = current_group && (topic[:id] == topic_id) -%>
-            <li><a class="<%= current_topic ? ' active' : '' %>" href="<%= subtopic_shim %><%= topic[:path] %>"><%= topic[:name] %></a></li>
-          <%- else -%>
-            <%- current_subgroup = topic[:id] == subgroup_id -%>
-            <li class="nav-header">
-              <a class="" href="#" data-toggle="collapse" data-target="#topicSubGroup-<%= groupidx %>-<%= topicidx %>">
-                <span id="sgSpan-<%= groupidx %>-<%= topicidx %>" class="fa <%= current_subgroup ? 'fa-caret-down' : 'fa-caret-right' %>"></span>&nbsp;<%= topic[:name] %>
-              </a>
-              <ul id="topicSubGroup-<%= groupidx %>-<%= topicidx %>" class="nav-tertiary list-unstyled collapse<%= current_subgroup ? ' in' : '' %>">
-                <%- topic[:topics].each do |subtopic| -%>
-                  <%- current_subtopic = current_group && current_subgroup && (subtopic[:id] == topic_id) %>
-                  <li><a class="<%= current_subtopic ? ' active' : '' %>" href="<%= subtopic_shim %><%= subtopic[:path] %>"><%= subtopic[:name] %></a></li>
-                <%- end -%>
-              </ul>
-            </li>
-          <%- end -%>
-        <%- end -%>
-      </ul>
+    <ul id="topicGroup-<%= topic_group[:id].hash %>" class="collapse <%= topic_id.start_with?(topic_group[:id]) ? 'in' : '' %> list-unstyled">
+      <%= render("_templates/_nav.html.erb", :navigation => topic_group[:topics], :topic_id => topic_id, :subtopic_shim => subtopic_shim) %>
+    </ul>
     </li>
   <%- end -%>
-</ul>
+<%- end -%>

data/templates/_templates/_title.html.erb

@@ -0,0 +1,8 @@
+<%- navigation.each do |topic_group| -%>
+  <%- if topic_id.start_with?(topic_group[:id]) %>
+    | <%= topic_group[:name] %>
+  <%- end -%>
+  <%- if topic_group.has_key?(:topics) -%>
+    <%= render("_templates/_title.html.erb", :navigation => topic_group[:topics], :topic_id => topic_id) %>
+  <%- end -%>
+<%- end -%>

data/templates/_templates/page.html.erb

@@ -4,7 +4,9 @@
   <meta charset="utf-8">
   <meta content="IE=edge" http-equiv="X-UA-Compatible">
   <meta content="width=device-width, initial-scale=1.0" name="viewport">
-  <title><%= distro %> <%= version %> | <%= [group_title, subgroup_title, topic_title].compact.join(' | ') %></title>
+  <title><%= distro %> <%= version %>
+      <%= render("_templates/_title.html.erb", :navigation => navigation, :topic_id => topic_id) %>
+  </title>
 
   <!-- Bootstrap -->
   <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
@@ -39,20 +41,13 @@
       <li class="sitename">
         <a href="<%= site_home_path %>"><%= site_name %></a>
       </li>
-      <li class="hidden-xs active">
-        <%= breadcrumb_root %>
-      </li>
-      <li class="hidden-xs active">
-        <%= breadcrumb_group %>
-      </li>
-      <%= breadcrumb_subgroup_block %>
-      <li class="hidden-xs active">
-        <%= breadcrumb_topic %>
-      </li>
+      <%= render("_templates/_breadcrumb.html.erb", :navigation => navigation, :topic_id => topic_id, :subtopic_shim => subtopic_shim) %>
     </ol>
     <div class="row row-offcanvas row-offcanvas-left">
       <div class="col-xs-8 col-sm-3 col-md-3 sidebar sidebar-offcanvas">
-        <%= render("_templates/_nav.html.erb", :navigation => navigation, :group_id => group_id, :topic_id => topic_id, :subgroup_id => subgroup_id, :subtopic_shim => subtopic_shim) %>
+        <ul class="nav nav-sidebar">
+          <%= render("_templates/_nav.html.erb", :navigation => navigation, :topic_id => topic_id, :subtopic_shim => subtopic_shim) %>
+        </ul>
       </div>
       <div class="col-xs-12 col-sm-9 col-md-9 main">
         <div class="page-header">

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ascii_binder
 version: !ruby/object:Gem::Version
-  version: 0.1.15.1
+  version: 0.1.15.2
 platform: ruby
 authors:
 - N. Harrison Ripps
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-08 00:00:00.000000000 Z
+date: 2019-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -323,8 +323,10 @@ files:
 - templates/_javascripts/.gitkeep
 - templates/_javascripts/bootstrap-offcanvas.js
 - templates/_stylesheets/asciibinder.css
+- templates/_templates/_breadcrumb.html.erb
 - templates/_templates/_css.html.erb
 - templates/_templates/_nav.html.erb
+- templates/_templates/_title.html.erb
 - templates/_templates/page.html.erb
 - templates/_topic_map.yml
 - templates/index-main.html
@@ -348,8 +350,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.4
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: AsciiBinder is an AsciiDoc-based system for authoring and publishing closely