middleman-mdocs 0.1.0.62562

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8a178d824ca8aa52558c1d79e3caa57d591f7ca6061de94e7aa7bf8beb2deac5
+  data.tar.gz: 3ae7963d4b26818877c8263dd682d7da4e425cad6eea79d0910c0218b870a8d8
+SHA512:
+  metadata.gz: 9e8662688f936f346461d76a3c02e531de5330ac1d99edcfe9cd44a61ce4fdbde488e1c918d00b00c51559f83532cf898af5ce8238761d66412fbc87e3bf8135
+  data.tar.gz: 151d8aa1ba4f99207382b1e976b1c28daecdf8618d578b6221952802f071b0fae09782a97ffed92d30bb986adef2c3d6488b56c2fc33f44b2b5a2eac451f7202

data/Gemfile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mdocs.gemspec
+gemspec
+
+gem 'rake', '~> 13.0'
+gem 'simplecov', '~> 0.21'
+gem 'rspec', '~> 3.10'
+gem 'rspec_junit_formatter', '~> 0.4'
+gem 'simplecov-console'
+
+gem 'rubocop', require: false

data/Gemfile.lock

@@ -0,0 +1,224 @@
+PATH
+  remote: .
+  specs:
+    middleman-mdocs (0.1.0.62562)
+      activesupport
+      awesome_print
+      kramdown
+      mdocs_kramdown
+      middleman (~> 4.3.11)
+      middleman-imageoptim
+      middleman-search
+      nokogiri
+      redcarpet
+      russian
+      slim
+      stringex
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.2.6)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ansi (1.5.0)
+    asciidoctor (2.0.16)
+    asciidoctor-plantuml (0.0.12)
+      asciidoctor (>= 1.5.6, < 3.0.0)
+    ast (2.4.2)
+    awesome_print (1.9.2)
+    backports (3.21.0)
+    coffee-script (2.4.1)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.12.2)
+    concurrent-ruby (1.1.9)
+    contracts (0.13.0)
+    diff-lcs (1.4.4)
+    docile (1.4.0)
+    dotenv (2.7.6)
+    erubis (2.7.0)
+    execjs (2.8.1)
+    exifr (1.3.9)
+    fast_blank (1.0.1)
+    fastimage (2.2.5)
+    ffi (1.15.4)
+    fspath (3.1.2)
+    gitlab_kramdown (0.10.0)
+      asciidoctor-plantuml (= 0.0.12)
+      kramdown (~> 2.3.0)
+      nokogiri (~> 1.10.10)
+      rouge (~> 3.2)
+    haml (5.2.2)
+      temple (>= 0.8.0)
+      tilt
+    hamster (3.0.0)
+      concurrent-ruby (~> 1.0)
+    hashie (3.6.0)
+    i18n (0.9.5)
+      concurrent-ruby (~> 1.0)
+    image_optim (0.25.0)
+      exifr (~> 1.2, >= 1.2.2)
+      fspath (~> 3.0)
+      image_size (~> 1.5)
+      in_threads (~> 1.3)
+      progress (~> 3.0, >= 3.0.1)
+    image_optim_pack (0.2.3)
+      fspath (>= 2.1, < 4)
+      image_optim (~> 0.19)
+    image_size (1.5.0)
+    in_threads (1.5.4)
+    kramdown (2.3.1)
+      rexml
+    libv8 (3.16.14.19-x86_64-linux)
+    listen (3.0.8)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+    mdocs_kramdown (0.1.1.47381)
+      gitlab_kramdown (~> 0)
+    memoist (0.16.2)
+    middleman (4.3.11)
+      coffee-script (~> 2.2)
+      haml (>= 4.0.5)
+      kramdown (>= 2.3.0)
+      middleman-cli (= 4.3.11)
+      middleman-core (= 4.3.11)
+    middleman-cli (4.3.11)
+      thor (>= 0.17.0, < 2.0)
+    middleman-core (4.3.11)
+      activesupport (>= 4.2, < 6.0)
+      addressable (~> 2.3)
+      backports (~> 3.6)
+      bundler
+      contracts (~> 0.13.0)
+      dotenv
+      erubis
+      execjs (~> 2.0)
+      fast_blank
+      fastimage (~> 2.0)
+      hamster (~> 3.0)
+      hashie (~> 3.4)
+      i18n (~> 0.9.0)
+      listen (~> 3.0.0)
+      memoist (~> 0.14)
+      padrino-helpers (~> 0.13.0)
+      parallel
+      rack (>= 1.4.5, < 3)
+      sassc (~> 2.0)
+      servolux
+      tilt (~> 2.0.9)
+      uglifier (~> 3.0)
+    middleman-imageoptim (0.3.0)
+      image_optim (~> 0.25.0)
+      image_optim_pack (~> 0.2.1)
+      middleman-cli
+      middleman-core (>= 3.1)
+    middleman-search (0.10.0)
+      middleman-core (>= 3.2)
+      nokogiri (~> 1.6)
+      therubyracer (~> 0.12.2)
+    mini_portile2 (2.4.0)
+    minitest (5.14.4)
+    nokogiri (1.10.10)
+      mini_portile2 (~> 2.4.0)
+    padrino-helpers (0.13.3.4)
+      i18n (~> 0.6, >= 0.6.7)
+      padrino-support (= 0.13.3.4)
+      tilt (>= 1.4.1, < 3)
+    padrino-support (0.13.3.4)
+      activesupport (>= 3.1)
+    parallel (1.21.0)
+    parser (3.0.2.0)
+      ast (~> 2.4.1)
+    progress (3.6.0)
+    public_suffix (4.0.6)
+    rack (2.2.3)
+    rainbow (3.0.0)
+    rake (13.0.6)
+    rb-fsevent (0.11.0)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    redcarpet (3.5.1)
+    ref (2.0.0)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
+    rouge (3.26.1)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    rspec_junit_formatter (0.4.1)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    rubocop (1.21.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.9.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.11.0)
+      parser (>= 3.0.1.1)
+    ruby-progressbar (1.11.0)
+    russian (0.6.0)
+      i18n (>= 0.5.0)
+    sassc (2.4.0)
+      ffi (~> 1.9)
+    servolux (0.13.0)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-console (0.9.1)
+      ansi
+      simplecov
+      terminal-table
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.3)
+    slim (4.1.0)
+      temple (>= 0.7.6, < 0.9)
+      tilt (>= 2.0.6, < 2.1)
+    stringex (2.8.5)
+    temple (0.8.2)
+    terminal-table (3.0.2)
+      unicode-display_width (>= 1.1.1, < 3)
+    therubyracer (0.12.3)
+      libv8 (~> 3.16.14.15)
+      ref
+    thor (1.1.0)
+    thread_safe (0.3.6)
+    tilt (2.0.10)
+    tzinfo (1.2.9)
+      thread_safe (~> 0.1)
+    uglifier (3.2.0)
+      execjs (>= 0.3.0, < 3)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  middleman-mdocs!
+  rake (~> 13.0)
+  rspec (~> 3.10)
+  rspec_junit_formatter (~> 0.4)
+  rubocop
+  simplecov (~> 0.21)
+  simplecov-console
+
+BUNDLED WITH
+   2.2.26

data/README.md

@@ -0,0 +1,3 @@
+# MiddlemanMdocs
+
+В процессе...

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'mdocs'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/middleman-mdocs/controller.rb

@@ -0,0 +1,95 @@
+module MiddlemanMdocs
+  class Controller
+    attr_reader :nav, :sitemap, :app
+
+    def initialize(sitemap)
+      @sitemap = sitemap
+      @app = sitemap.app
+      @guards = {}
+    end
+
+    def load(mdocs)
+      @nav = ::MiddlemanMdocs::Navigation.parse(mdocs['nav'])
+    end
+
+    def tags
+      sitemap.resources.select { |r| r.is_a?(::MiddlemanMdocs::Resource) }.map do |r|
+        guard_recursive('tags', r.path, []) do |_key|
+          r.tags
+        end
+      end.flatten.compact.map(&:to_sym).uniq
+    end
+
+    def has_tag?(tag)
+      tags.include?(tag.to_sym)
+    end
+
+    def select_by_meta(meta)
+      with_ensure_resource do
+        if meta.is_a? Hash
+          sitemap.resources.select do |resource|
+            resource.is_a?(::MiddlemanMdocs::Resource) && resource.meta_match?(meta) && resource.template?
+          end
+        else
+          sitemap.resources.select do |resource|
+            resource.is_a?(::MiddlemanMdocs::Resource) && resource.has_meta?(*meta) && resource.template?
+          end
+        end
+      end
+    end
+
+    def select_by_meta_force(meta)
+      with_ensure_resource do
+        if meta.is_a? Hash
+          sitemap.resources.select do |resource|
+            resource.is_a?(::MiddlemanMdocs::Resource) && resource.meta_match?(meta)
+          end
+        else
+          sitemap.resources.select do |resource|
+            resource.is_a?(::MiddlemanMdocs::Resource) && resource.has_meta?(*meta)
+          end
+        end
+      end
+    end
+
+    def select_by_tags(*tags)
+      with_ensure_resource do
+        sitemap.resources.select do |resource|
+          resource.is_a?(::MiddlemanMdocs::Resource) && resource.has_tags?(*tags) && resource.template?
+        end
+      end
+    end
+
+    def select(tags, *meta)
+      select_by_meta(*meta).select do |resource|
+        resource.is_a?(::MiddlemanMdocs::Resource) && resource.has_tags?(*tags) && resource.template?
+      end
+    end
+
+    def with_ensure_resource
+      guard_recursive('with_ensure_resource', 'none', nil) do
+        sitemap.instance_variable_get('@lock').synchronize do
+          sitemap.ensure_resource_list_updated!
+          yield
+        end
+      end
+    end
+
+    def tr(tag, scope: :tags)
+      I18n.t(tag.to_s.upcase.presence, scope: [:mdocs, scope],
+                                       default: I18n.t(tag.to_s.downcase.presence, scope: [:mdocs, scope], default: tag.to_s).presence)
+    end
+
+    def guard_recursive(name, key, default = nil)
+      guard = @guards[name] ||= {}
+      return guard[key] if guard.has_key?(key)
+
+      begin
+        guard[key] = default
+        guard[key] = yield(key)
+      ensure
+        guard.delete(key)
+      end
+    end
+  end
+end

data/lib/middleman-mdocs/extension.rb

@@ -0,0 +1,148 @@
+module MiddlemanMdocs
+  class Extension < Middleman::Extension
+    attr_reader :mdocs, :mdocsnav, :mdocsmeta
+
+    expose_to_application :mdocs, :mdocsnav
+    expose_to_template :mdocs, :mdocsnav
+    expose_to_config :mdocs, :enrich_metadata
+
+    def initialize(*args, **_kwargs, &block)
+      super
+
+      # Only require dependency on activation
+      require 'kramdown/parser'
+      require 'kramdown/converter'
+
+      require 'mdocs_kramdown'
+      require 'kramdown/parser/mdocs_kramdown'
+
+      require_relative 'resource'
+      require_relative 'toc'
+      require_relative 'tilt_template'
+      require_relative 'navigation'
+      require_relative 'controller'
+      require_relative 'sitemap'
+
+      @mdocs = Controller.new(app.sitemap)
+
+      configure_application
+
+      register_helpers(::MiddlemanMdocs::TOC)
+      register_helpers(::MiddlemanMdocs::Navigation)
+
+      @mdocsmeta = {}
+
+      ::ActiveSupport::Notifications.subscribe('sitemap.update.middleman') do
+        lookup = @mdocs.sitemap.instance_variable_get('@_lookup_by_destination_path')
+        @mdocs.sitemap.resources.each do |resource|
+          lookup[::Middleman::Util.normalize_path(resource.destination_path)] = resource
+        end
+      end
+    end
+
+    def configure_application
+      ::Middleman::Sitemap::Store.include(::MiddlemanMdocs::Sitemap)
+
+      app.config[:markdown_engine] = :kramdown
+      app.config[:markdown] = {
+        tables: true,
+        linkable_headers: true,
+        auto_ids: true,
+        auto_id_prefix: true,
+        auto_id_stripping: true,
+        transliterated_header_ids: true,
+        syntax_highlighter: :rouge,
+        syntax_highlighter_opts: {
+          default_lang: 'html'
+        },
+        parse_block_html: true,
+        input: 'MdocsKramdown'
+      }
+    end
+
+    def register_helpers(modul)
+      unless self.class.defined_helpers.include?(modul)
+        self.class.include modul
+        self.class.defined_helpers << modul
+      end
+    end
+
+    def after_configuration
+      markdown_exts = %w[markdown mdown md mkd mkdn]
+      ::Tilt.register ::MiddlemanMdocs::TiltTempalte, *markdown_exts
+    end
+
+    def enrich_metadata(rx, &block)
+      @enrichers ||= []
+      @enrichers.push([rx, block])
+    end
+
+    def ready
+      mdocs.load(app.data.mdocs)
+    end
+
+    helpers do
+    end
+
+    def manipulate_resource_list(resources)
+      resources.each do |resource|
+        # install MdDocs::Resource extension
+        resource.extend(::MiddlemanMdocs::Resource) unless resource.is_a?(::MiddlemanMdocs::Resource)
+        resource.mdocs_extention = self
+
+        next if resource.metadata[:ignore]
+
+        if resource.source_file.end_with?('.md')
+          resource.add_meta(markdown: true)
+          resource.add_options(layout: (resource.options[:layout] || app.config.layout))
+          resource.destination_path << '.html' unless resource.destination_path.end_with?('.html')
+        end
+
+        resource.add_tags(*resource.data.tags)
+        resource.add_keywords(*resource.data.keywords)
+
+        # enrich recursive metadata from metadata.yml in each folder
+        metadata = get_metadata(resource.source_file)
+        resource.add_meta(::Middleman::Util.recursively_enhance(metadata))
+
+        # run apropriate enrichers
+        @enrichers.each do |(rx, block)|
+          if (md = rx.match(resource.source_file))
+            block.call(resource, md)
+          end
+        end
+      end
+
+      resources
+    end
+
+    def get_metadata(path)
+      return {} unless path[app.source_dir.to_s]
+
+      path = ::Pathname.new(path)
+      current_dir = path.dirname.relative_path_from(app.source_dir).to_s
+
+      @mdocsmeta[current_dir] || begin
+        tokens = current_dir.split('/')
+
+        ([''] + tokens).reduce(::Pathname('')) do |parent, token|
+          return {} if ['.', ','].include?(token)
+
+          current = parent.join(token)
+          token_path = app.source_dir.join(current)
+          meta = load_metadata(token_path)
+          @mdocsmeta[current.to_s] ||= (@mdocsmeta[parent.to_s] || {}).merge(meta)
+          current
+        end
+
+        @mdocsmeta[current_dir] || {}
+      end
+    end
+
+    def load_metadata(path)
+      ::YAML.load_file(path.join('metadata.yml'))
+    rescue StandardError
+      {}
+    end
+  end
+end

data/lib/middleman-mdocs/navigation.rb

@@ -0,0 +1,134 @@
+module MiddlemanMdocs
+  module Navigation
+    class Item
+      attr_reader :label, :value, :group
+
+      def initialize(label, value = nil)
+        @label = label
+        @value = value
+        if @value.is_a?(Hash) && @value.group?
+          @group = @value.group
+        elsif @value.is_a?(Array)
+          @recursive = true
+        end
+      end
+
+      def separator?
+        value.nil?
+      end
+
+      def link?
+        value.is_a?(String)
+      end
+
+      def group?
+        !!@group
+      end
+
+      def recursive?
+        !!@recursive
+      end
+
+      def groupped(sitemap)
+        sitemap.select_by_meta(@group.to_sym).group_by do |resource|
+          resource.metadata[@group.to_sym]
+        end
+      end
+
+      def tr(group)
+        I18n.t(group, scope: [:mdocs, self.group], default: group)
+      end
+    end
+
+    def self.parse(list)
+      list.map do |p|
+        if p.is_a?(Hash)
+          k, v = p.first
+        elsif p.is_a?(String)
+          k = p
+          v = nil
+        else
+          ap "Error: #{p.inspect}"
+          next
+        end
+
+        v = parse(v) if v.is_a?(Array)
+        Item.new(k, v)
+      end
+    end
+
+    # Try to catch relative path and find resource for it
+    def link_to(*args, &block)
+      url_arg_index = block_given? ? 0 : 1
+      options_index = block_given? ? 1 : 2
+      url = args[url_arg_index]
+
+      if url
+        url = translate_to_destination(url)
+        args[url_arg_index] = url
+      end
+      super(*args, &block)
+    end
+
+    def link_to_tag(tag, *args, &block)
+      raise "There no tag #{tag.inspect} defined in mdocs" if tag && !mdocs.has_tag?(tag)
+
+      if block_given?
+        link_to("/tags/#{tag}", *args, &block)
+      else
+        link_to(I18n.t(tag, scope: %i[mdocs tags], default: tag.to_s), "/tags/#{tag}.html", *args, &block)
+      end
+    end
+
+    def fuzzy_find_resource(url)
+      source_file = if url.try(:source_file)
+                      url.try(:source_file)
+                    elsif url.start_with?('/')
+                      app.source_dir.join(url[1..-1]).to_s
+                    else
+                      ::Pathname.new(current_page.source_file).dirname.join(url).to_s
+                    end
+      app.sitemap.resources.find { |r| r.source_file == source_file }
+    end
+
+    def merge(url)
+      resource = fuzzy_find_resource(url)
+      raise "unable to find resource by #{url}" unless resource
+
+      current_page.add_tags(*resource.data.fetch(:tags, []))
+      current_page.data.reverse_merge!(resource.data)
+    end
+
+    def include(page_id_or_path, merge: true, render: true)
+      merge(page_id_or_path) if merge
+      resource = fuzzy_find_resource(page_id_or_path) || sitemap.find_resource_by_page_id(page_id_or_path)
+      if render
+        resource.render(layout: false)
+      else
+        ::File.read(resource.try(:source_file) || page_id_or_path)
+      end
+    end
+
+    # some custom magic to find result path to generated resource
+    # Ex: readme.md -> readme.html
+    # Absolute Ex: /docs/readme.md -> docs/readme.html
+    # Relative Ex: quick.md -> docs/quick.html from docs/page.md
+    def translate_to_destination(url)
+      if r = fuzzy_find_resource(url)
+        r.url
+      else
+        url
+      end
+    end
+
+    # is this is url for current page
+    def active_url?(url)
+      translated = translate_to_destination(url)
+      url == current_page.url || current_page.url == translated || begin
+        current_page.url == translated.force_encoding('ASCII-8BIT')
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/middleman-mdocs/resource.rb

@@ -0,0 +1,75 @@
+module MiddlemanMdocs
+  module Resource
+    attr_accessor :mdocs_extention
+
+    def markdown?
+      true
+    end
+
+    def add_options(opts)
+      options.deep_merge!(opts)
+    end
+
+    def add_meta(opts)
+      metadata.deep_merge!(opts)
+    end
+
+    def add_tags(*args)
+      tags = (options[:tags] ||= [])
+      tags.append(*args.map(&:to_sym))
+      tags = tags.map(&:to_s).map(&:upcase).uniq.map(&:to_sym)
+      options[:tags] = tags
+
+      add_keywords(*args)
+      add_keywords(*args.map { |tag| I18n.t(tag, scope: %i[mdocs tags], default: tag.to_s) })
+    end
+
+    def add_keywords(*args)
+      keywords = (options[:keywords] ||= [])
+      keywords.append(*args.map(&:to_s))
+      keywords.uniq!
+    end
+
+    def tags
+      unless @rendered
+        unless metadata[:ignore]
+          begin
+            render(layout: false)
+          rescue StandardError
+            nil
+          end
+        end
+        @rendered = true
+      end
+      (options[:tags] ||= [])
+    end
+
+    def title
+      return nil unless metadata[:markdown]
+
+      data[:title] ||= @mdocs_extention.table_of_contents(self).children.first&.raw_text
+    end
+
+    def keywords
+      (options[:keywords] ||= [])
+    end
+
+    def meta_match?(meta)
+      meta.all? do |k, v|
+        metadata.include?(k) && (metadata[k].is_a?(Array) ? metadata[k].include?(v) : metadata[k] == v)
+      end
+    end
+
+    def has_meta?(*keys)
+      keys.compact!
+      keys.uniq!
+      (metadata.keys.uniq.sort & keys).size == keys.size
+    end
+
+    def has_tags?(*keys)
+      keys.compact!
+      keys.uniq!
+      (tags & keys).size == keys.size
+    end
+  end
+end

data/lib/middleman-mdocs/sitemap.rb

@@ -0,0 +1,4 @@
+module MiddlemanMdocs
+  module Sitemap
+  end
+end

data/lib/middleman-mdocs/tilt_template.rb

@@ -0,0 +1,13 @@
+require 'middleman-core/renderers/kramdown'
+
+module MiddlemanMdocs
+  class TiltTempalte < ::Middleman::Renderers::KramdownTemplate
+    def render(*args)
+      erb = Middleman::Renderers::ERb::Template.new(file, line, options) { data }
+      @data = erb.render(*args)
+
+      prepare
+      super
+    end
+  end
+end

data/lib/middleman-mdocs/toc.rb

@@ -0,0 +1,78 @@
+require 'kramdown'
+
+module MiddlemanMdocs
+  module TOC
+    ## TOC item representation
+    #
+    class Item
+      attr_accessor :attrs, :children
+
+      delegate :merge, :merge!, to: :attrs
+
+      def initialize(attrs = {})
+        @attrs = attrs.with_indifferent_access
+        @children = []
+      end
+
+      def flatten
+        children.each_with_object([attrs.empty? ? [] : self]) do |child, list|
+          list.append(child.flatten)
+        end.flatten
+      end
+
+      def method_missing(sym, *)
+        if attrs.include? sym
+          @attrs[sym]
+        else
+          super
+        end
+      end
+
+      def self.create(item)
+        Item.new.tap do |composed|
+          [item, item.value || {}].each do |obj|
+            composed.merge!(obj.try(:attr) || {}).merge!(obj.try(:options) || {})
+          end
+
+          (item.value.try(:children) || []).each do |el|
+            composed.merge!(create(el).attrs)
+          end
+        end
+      end
+
+      def self.parse_kramdown_toc(toc)
+        root = create(toc)
+        root.children = toc.children.map { |item| parse_kramdown_toc(item) }
+        root
+      end
+    end
+
+    ## Generate TOC object tree for current page or source file
+    #
+    def table_of_contents(page_or_source, input: 'markdown')
+      begin
+        return nil if page_or_source.metadata[:ignore]
+
+        content = page_or_source.render(layout: false)
+        toc = Kramdown::Document.new(content, app.config[:markdown].merge(input: 'html')).to_toc
+
+        return Item.parse_kramdown_toc(toc)
+      rescue StandardError => e
+        # puts "WARNING: #{e}"
+        # puts e.backtrace
+      end
+
+      content = ::File.read(page_or_source.try(:source_file) || page_or_source)
+      # remove YAML frontmatter
+      content = content.gsub(/^(---\s*\n.*?\n?)^(---\s*$\n?)/m, '')
+
+      toc = if input == 'markdown'
+              Kramdown::Document.new(content, app.config[:markdown]).to_toc
+            else
+              Kramdown::Document.new(content, input: input).to_toc
+            end
+
+      Item.parse_kramdown_toc(toc)
+    end
+  end
+end

data/lib/middleman-mdocs/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module MiddlemanMdocs
+  VERSION = '0.1.0'
+end

data/lib/middleman-mdocs.rb

@@ -0,0 +1,8 @@
+require 'middleman-core'
+require 'pathname'
+require 'active_support/core_ext/hash'
+
+::Middleman::Extensions.register(:mdocs) do
+  require_relative 'middleman-mdocs/extension'
+  ::MiddlemanMdocs::Extension
+end

metadata

@@ -0,0 +1,227 @@
+--- !ruby/object:Gem::Specification
+name: middleman-mdocs
+version: !ruby/object:Gem::Version
+  version: 0.1.0.62562
+platform: ruby
+authors:
+- Samoylenko Yuri
+- Poliev Alexey
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-09-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mdocs_kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: middleman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.11
+- !ruby/object:Gem::Dependency
+  name: middleman-imageoptim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: middleman-search
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: russian
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: slim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: stringex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: MDocs extension for middleman
+email:
+- kinnalru@gmail.com
+- apoliev@rnds.pro
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- bin/console
+- bin/setup
+- lib/middleman-mdocs.rb
+- lib/middleman-mdocs/controller.rb
+- lib/middleman-mdocs/extension.rb
+- lib/middleman-mdocs/navigation.rb
+- lib/middleman-mdocs/resource.rb
+- lib/middleman-mdocs/sitemap.rb
+- lib/middleman-mdocs/tilt_template.rb
+- lib/middleman-mdocs/toc.rb
+- lib/middleman-mdocs/version.rb
+homepage: https://rnds.pro
+licenses: []
+metadata:
+  homepage_uri: https://rnds.pro
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Extension for Middleman
+test_files: []