rdoc-markdown 0.11.1 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9e7c9de1a47770ad5a481a5908b247c1baf4bc5d65db6afa1bc130f61308768
-  data.tar.gz: 2263b102aaf74238b723e292348c98da4f99b75e6bfd62399f73f6d336667ea7
+  metadata.gz: c69484c517e3582906e6847cbb162a7847ad29446856197a5f65972071c21d24
+  data.tar.gz: f646046107985a70925df0794921c5451c514be069827762a296b9763a27bd81
 SHA512:
-  metadata.gz: 970c61173dbdc3fa191becf7f5f6ba6dd0116e2ff03a69617488ec30d356b663cb071deb4786c2fed900abc064b53f76d26994c2fcfb39c742ce614d55fbb781
-  data.tar.gz: 40bb22da2e8a70a115c30f5d530860c41780129ec472c9e591704fc54ca09ccf84b677bac0d16c8d82f1b5ab95ddef9c3e0d4eb34a7d59945bbc41dddc573c5c
+  metadata.gz: 79dce45ea46f3c5baa04488ea729e280196cb1b73cf48d1857c8227d67cf9d8ec2eb2d5d3dd69ced241d06c0b91ba91d817fcf4cbd0d7d6de22f05e709f3e0a0
+  data.tar.gz: 44cd9cf4996a79fee5c56b19fa3779aed7e19a165a0576f350399560259b89f82e615c0911f7a1ce00087b860f1494499c7c00230dc486da11724502bc9a58fb

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rdoc-markdown (0.11.1)
+    rdoc-markdown (0.12.1)
       csv
       erb
       rdoc

data/lib/rdoc/generator/markdown.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# shareable_constant_value: literal
 
 gem "rdoc"
 
@@ -14,12 +15,37 @@ class RDoc::Generator::Markdown
 
   require_relative "markdown/rbs_signature_index"
 
+  # Supported reverse_markdown unknown-tag modes.
+  MARKDOWN_UNKNOWN_TAGS = %i[pass_through drop bypass raise]
+
+  # Root source page basenames and their search-index types.
+  ROOT_PAGES = {
+    "readme" => "Readme",
+    "guide" => "Readme",
+    "changelog" => "Changelog",
+    "history" => "Changelog"
+  }
+
+  # Source page extensions eligible for root page classification.
+  ROOT_PAGE_EXTENSIONS = %w[.rdoc .md .markdown]
+
+  # Returns the configured search-index type for an eligible root text page path.
+  #
+  # @param source_path [String] Normalized source path relative to the root.
+  #
+  # @return [String, nil]
+  def self.root_page_type_for(source_path)
+    return unless File.dirname(source_path) == "."
+    return unless ROOT_PAGE_EXTENSIONS.include?(File.extname(source_path))
+
+    ROOT_PAGES[File.basename(source_path, ".*").downcase]
+  end
+
+  # shareable_constant_value: none
+
   # Directory containing ERB templates.
   TEMPLATE_DIR = File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "templates"))
 
-  # Supported reverse_markdown unknown-tag modes.
-  MARKDOWN_UNKNOWN_TAGS = %i[pass_through drop bypass raise].freeze
-
   # Adds rdoc-markdown generator configuration to RDoc's option object.
   module OptionsExtension
     # Initializes markdown generator options alongside RDoc's built-in options.
@@ -49,6 +75,7 @@ class RDoc::Generator::Markdown
       super
       @markdown_unknown_tags = map.fetch("markdown_unknown_tags") if map.key?("markdown_unknown_tags")
     end
+
   end
 
   # Registers markdown generator-specific RDoc options.
@@ -117,6 +144,7 @@ class RDoc::Generator::Markdown
     @markdown_unknown_tags = self.class.validate_markdown_unknown_tags(rdoc_options.markdown_unknown_tags)
 
     @base_dir = Pathname.pwd
+    @expanded_root = Pathname(@options.root.to_s).expand_path
   end
 
   # Writes class files, page files, and the search index.
@@ -210,7 +238,7 @@ class RDoc::Generator::Markdown
       @pages.each do |page|
         csv << [
           page.page_name,
-          "Page",
+          page_type(page),
           page_output_path(page)
         ]
       end
@@ -276,6 +304,26 @@ class RDoc::Generator::Markdown
     "#{dirname}/#{basename}"
   end
 
+  # Checks whether a text page is the configured main page.
+  #
+  # @param page [RDoc::TopLevel] Page object to index.
+  #
+  # @return [Boolean]
+  def main_page?(page)
+    normalize_input_path_for_output(page.full_name) == normalize_input_path_for_output(@options.main_page.to_s)
+  end
+
+  # Returns the search-index type for a text page.
+  #
+  # @param page [RDoc::TopLevel] Page object to index.
+  #
+  # @return [String]
+  def page_type(page)
+    return "Readme" if main_page?(page)
+
+    self.class.root_page_type_for(normalize_input_path_for_output(page.relative_name)) || "Page"
+  end
+
   # Returns the normalized display name for a class or module.
   #
   # @param code_object [RDoc::Context] Class or module object.
@@ -669,7 +717,7 @@ class RDoc::Generator::Markdown
   def normalize_input_path_for_output(path)
     normalized = path.tr("\\", "/").sub(%r{\A\./}, "")
 
-    root = File.expand_path(@options.root.to_s)
+    root = @expanded_root.to_s
     normalized = normalized.sub(%r{\A#{Regexp.escape(root)}/}, "")
     normalized = normalized.sub(%r{\A/}, "")
 

data/lib/rdoc/markdown/version.rb

@@ -5,6 +5,6 @@ module Rdoc
   # @private
   module Markdown
     # @private
-    VERSION = "0.11.1"
+    VERSION = "0.12.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rdoc-markdown
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.12.1
 platform: ruby
 authors:
 - Stanislav (Stas) Katkov