docyard 0.6.0 → 0.8.0

data/lib/docyard/navigation/sidebar/renderer.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require "erb"
+require_relative "../../rendering/icon_helpers"
+
+module Docyard
+  module Sidebar
+    class Renderer
+      include Utils::UrlHelpers
+      include IconHelpers
+
+      PARTIALS_PATH = File.join(__dir__, "../../templates/partials")
+
+      attr_reader :site_title, :base_url, :header_ctas
+
+      def initialize(site_title: "Documentation", base_url: "/", header_ctas: [])
+        @site_title = site_title
+        @base_url = normalize_base_url(base_url)
+        @header_ctas = header_ctas
+      end
+
+      def render(tree)
+        return "" if tree.empty?
+
+        nav_content = render_tree_with_sections(tree)
+        render_partial(:sidebar, nav_content: nav_content, header_ctas: header_ctas)
+      end
+
+      private
+
+      def render_partial(name, locals = {})
+        template_path = File.join(PARTIALS_PATH, "_#{name}.html.erb")
+        template = File.read(template_path)
+
+        locals.each { |key, value| instance_variable_set("@#{key}", value) }
+
+        erb_binding = binding
+        ERB.new(template).result(erb_binding)
+      end
+
+      def render_tree_with_sections(items)
+        filtered_items = items.reject { |item| item[:title]&.downcase == site_title.downcase }
+        grouped = group_items_by_section(filtered_items)
+
+        grouped.map do |group|
+          if group[:section]
+            render_section(group[:item])
+          else
+            render_item_group(group[:items])
+          end
+        end.join
+      end
+
+      def group_items_by_section(items)
+        groups = []
+        current_non_section_items = []
+
+        items.each do |item|
+          if item[:section]
+            if current_non_section_items.any?
+              groups << { section: false, items: current_non_section_items }
+              current_non_section_items = []
+            end
+            groups << { section: true, item: item }
+          else
+            current_non_section_items << item
+          end
+        end
+
+        groups << { section: false, items: current_non_section_items } if current_non_section_items.any?
+        groups
+      end
+
+      def render_section(item)
+        section_content = render_tree(item[:children])
+        render_partial(:nav_section,
+                       section_name: item[:title],
+                       section_icon: item[:icon],
+                       section_content: section_content)
+      end
+
+      def render_item_group(items)
+        render_partial(:nav_section,
+                       section_name: nil,
+                       section_icon: nil,
+                       section_content: render_tree(items))
+      end
+
+      def render_tree(items)
+        return "" if items.empty?
+
+        list_items = items.map { |item| render_item(item) }.join
+        render_partial(:nav_list, list_items: list_items)
+      end
+
+      def render_item(item)
+        item_content = if item[:children].empty?
+                         render_leaf_item(item)
+                       elsif item[:section]
+                         render_nested_section(item)
+                       else
+                         render_group_item(item)
+                       end
+
+        render_partial(:nav_item, item_content: item_content)
+      end
+
+      def render_leaf_item(item)
+        render_partial(
+          :nav_leaf,
+          path: item[:path],
+          title: item[:title],
+          active: item[:active],
+          icon: item[:icon],
+          target: item[:target]
+        )
+      end
+
+      def render_nested_section(item)
+        children_html = render_tree(item[:children])
+        render_partial(
+          :nav_nested_section,
+          title: item[:title],
+          icon: item[:icon],
+          children_html: children_html
+        )
+      end
+
+      def render_group_item(item)
+        children_html = render_tree(item[:children])
+        render_partial(
+          :nav_group,
+          title: item[:title],
+          path: item[:path],
+          active: item[:active],
+          children_html: children_html,
+          icon: item[:icon],
+          collapsed: item[:collapsed],
+          has_index: item[:has_index]
+        )
+      end
+    end
+  end
+end

data/lib/docyard/navigation/sidebar/sorter.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Sidebar
+    module Sorter
+      module_function
+
+      def sort_by_order(items)
+        items.sort_by do |item|
+          order = item[:order]
+          title = item[:title]&.downcase || ""
+          if order.nil?
+            [1, title]
+          else
+            [0, order, title]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/docyard/navigation/sidebar/tree_builder.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require_relative "sorter"
+require_relative "local_config_loader"
+require_relative "config_parser"
+require_relative "metadata_reader"
+
+module Docyard
+  module Sidebar
+    class TreeBuilder
+      attr_reader :docs_path, :current_path, :title_extractor, :metadata_reader
+
+      def initialize(docs_path:, current_path:, title_extractor: TitleExtractor.new)
+        @docs_path = docs_path
+        @current_path = Utils::PathResolver.normalize(current_path)
+        @title_extractor = title_extractor
+        @metadata_reader = MetadataReader.new
+      end
+
+      def build(file_items)
+        transform_items(file_items, "", depth: 1)
+      end
+
+      private
+
+      def transform_items(items, relative_base, depth:)
+        transformed = items.map do |item|
+          if item[:type] == :directory
+            transform_directory(item, relative_base, depth: depth)
+          else
+            transform_file(item, relative_base)
+          end
+        end
+        Sorter.sort_by_order(transformed)
+      end
+
+      def transform_directory(item, relative_base, depth:)
+        dir_path = File.join(relative_base, item[:name])
+        dir_context = build_directory_context(dir_path)
+        children = build_directory_children(item, dir_path, depth)
+
+        if depth == 1
+          build_section(item, children, dir_context)
+        else
+          build_collapsible_group(item, children, dir_context)
+        end
+      end
+
+      def build_directory_children(item, dir_path, depth)
+        full_dir_path = File.join(docs_path, dir_path)
+        local_config = LocalConfigLoader.new(full_dir_path).load
+
+        if local_config
+          build_children_from_config(local_config, dir_path)
+        else
+          transform_items(item[:children], dir_path, depth: depth + 1)
+        end
+      end
+
+      def build_children_from_config(config_items, base_path)
+        full_base_path = File.join(docs_path, base_path)
+        parser = ConfigParser.new(config_items, docs_path: full_base_path, current_path: current_path)
+        parser.parse.map(&:to_h)
+      end
+
+      def build_directory_context(dir_path)
+        index_file_path = File.join(docs_path, dir_path, "index.md")
+        has_index = File.file?(index_file_path)
+        { index_file_path: index_file_path, has_index: has_index,
+          url_path: has_index ? Utils::PathResolver.to_url(dir_path) : nil }
+      end
+
+      def build_section(item, children, context)
+        filtered_children = filter_index_from_children(children, context[:url_path])
+        metadata = context[:has_index] ? metadata_reader.extract_index_metadata(context[:index_file_path]) : {}
+
+        if context[:has_index]
+          overview = build_overview_item(metadata, context[:url_path])
+          filtered_children = [overview] + filtered_children
+        end
+
+        build_section_hash(item, filtered_children, metadata)
+      end
+
+      def build_section_hash(item, children, metadata)
+        { title: Utils::TextFormatter.titleize(item[:name]), path: nil, icon: metadata[:icon],
+          active: false, type: :directory, section: true,
+          collapsed: false, has_index: false, order: metadata[:order], children: children }
+      end
+
+      def build_collapsible_group(item, children, context)
+        filtered_children = filter_index_from_children(children, context[:url_path])
+        metadata = context[:has_index] ? metadata_reader.extract_index_metadata(context[:index_file_path]) : {}
+        is_active = context[:has_index] && current_path == context[:url_path]
+
+        build_collapsible_hash(item, filtered_children, context, metadata, is_active)
+      end
+
+      def build_collapsible_hash(item, children, context, metadata, is_active)
+        { title: Utils::TextFormatter.titleize(item[:name]), path: context[:url_path],
+          icon: metadata[:icon], active: is_active, type: :directory, section: false,
+          collapsed: collapsible_collapsed?(children, is_active), has_index: context[:has_index],
+          order: metadata[:order], children: children }
+      end
+
+      def collapsible_collapsed?(children, is_active)
+        return false if is_active || active_child?(children)
+
+        true
+      end
+
+      def build_overview_item(metadata, url_path)
+        { title: metadata[:sidebar_text] || "Overview", path: url_path,
+          icon: metadata[:icon], active: current_path == url_path, type: :file, children: [] }
+      end
+
+      def filter_index_from_children(children, index_url_path)
+        return children unless index_url_path
+
+        children.reject { |child| child[:path] == index_url_path }
+      end
+
+      def active_child?(children)
+        children.any? { |child| child[:active] || active_child?(child[:children] || []) }
+      end
+
+      def transform_file(item, relative_base)
+        file_path = File.join(relative_base, "#{item[:name]}#{Constants::MARKDOWN_EXTENSION}")
+        full_file_path = File.join(docs_path, file_path)
+        url_path = Utils::PathResolver.to_url(file_path.delete_suffix(Constants::MARKDOWN_EXTENSION))
+        metadata = metadata_reader.extract_file_metadata(full_file_path)
+
+        { title: metadata[:title] || title_extractor.extract(full_file_path),
+          path: url_path, icon: metadata[:icon], active: current_path == url_path,
+          type: :file, order: metadata[:order], children: [] }
+      end
+    end
+  end
+end

data/lib/docyard/navigation/sidebar/tree_filter.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Sidebar
+    class TreeFilter
+      def initialize(tree, tab_path)
+        @tree = tree
+        @tab_path = tab_path
+      end
+
+      def filter
+        @tree.filter_map { |item| filter_item(item) }
+      end
+
+      private
+
+      def filter_item(item)
+        children = item[:children] || []
+
+        if children.any?
+          filter_parent_item(item, children)
+        else
+          filter_leaf_item(item)
+        end
+      end
+
+      def filter_parent_item(item, children)
+        filtered_children = self.class.new(children, @tab_path).filter
+        has_matching_content = filtered_children.any? { |c| !external_item?(c) }
+
+        return nil if !has_matching_content && !item_matches_path?(item[:path])
+
+        item.merge(children: filtered_children)
+      end
+
+      def filter_leaf_item(item)
+        return item if external_item?(item)
+        return nil unless item_matches_path?(item[:path])
+
+        item
+      end
+
+      def external_item?(item)
+        item[:type] == :external || item[:path]&.start_with?("http")
+      end
+
+      def item_matches_path?(item_path)
+        return false if item_path.nil?
+
+        normalized_path = item_path.chomp("/")
+        normalized_path == @tab_path || normalized_path.start_with?("#{@tab_path}/")
+      end
+    end
+  end
+end

data/lib/docyard/navigation/sidebar_builder.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+require_relative "sidebar/file_system_scanner"
+require_relative "sidebar/title_extractor"
+require_relative "sidebar/tree_builder"
+require_relative "sidebar/renderer"
+require_relative "sidebar/config_parser"
+require_relative "sidebar/local_config_loader"
+require_relative "sidebar/path_prefixer"
+require_relative "sidebar/tree_filter"
+
+module Docyard
+  class SidebarBuilder
+    attr_reader :docs_path, :current_path, :config, :header_ctas
+
+    def initialize(docs_path:, current_path: "/", config: nil, header_ctas: [])
+      @docs_path = docs_path
+      @current_path = current_path
+      @config = config
+      @header_ctas = header_ctas
+    end
+
+    def tree
+      @tree ||= build_scoped_tree
+    end
+
+    def to_html
+      renderer.render(tree)
+    end
+
+    private
+
+    def build_scoped_tree
+      active_tab = find_active_tab
+      return build_tree_for_path(docs_path) unless active_tab
+
+      build_tree_for_tab(active_tab)
+    end
+
+    def build_tree_for_tab(tab)
+      tab_path = tab["href"]&.chomp("/")
+      return build_tree_for_path(docs_path) if empty_tab_path?(tab_path)
+
+      scoped_docs_path = resolve_scoped_path(tab_path)
+      build_scoped_or_filtered_tree(scoped_docs_path, tab_path)
+    end
+
+    def empty_tab_path?(tab_path)
+      tab_path.nil? || tab_path.empty? || tab_path == "/"
+    end
+
+    def resolve_scoped_path(tab_path)
+      tab_folder = tab_path.sub(%r{^/}, "")
+      File.join(docs_path, tab_folder)
+    end
+
+    def build_scoped_or_filtered_tree(scoped_docs_path, tab_path)
+      if scoped_sidebar_available?(scoped_docs_path)
+        build_tree_for_path(scoped_docs_path, base_url_prefix: tab_path)
+      else
+        Sidebar::TreeFilter.new(build_tree_for_path(docs_path), tab_path).filter
+      end
+    end
+
+    def scoped_sidebar_available?(path)
+      File.directory?(path) && Sidebar::LocalConfigLoader.new(path).config_file_exists?
+    end
+
+    def build_tree_for_path(path, base_url_prefix: "")
+      config_items = Sidebar::LocalConfigLoader.new(path).load
+      tree = build_tree(config_items, path, base_url_prefix)
+      maybe_prepend_overview(tree, path, base_url_prefix)
+    end
+
+    def build_tree(config_items, path, base_url_prefix)
+      if config_items&.any?
+        build_tree_from_config(config_items, path, base_url_prefix)
+      else
+        build_tree_from_filesystem(path, base_url_prefix)
+      end
+    end
+
+    def maybe_prepend_overview(tree, path, base_url_prefix)
+      return tree if skip_overview?(tree, path, base_url_prefix)
+
+      [build_overview_item(base_url_prefix)] + tree
+    end
+
+    def skip_overview?(tree, path, base_url_prefix)
+      base_url_prefix.empty? ||
+        tree.first&.dig(:section) ||
+        !File.file?(File.join(path, "index.md")) ||
+        tree.any? { |item| item[:path] == base_url_prefix }
+    end
+
+    def build_overview_item(base_url_prefix)
+      {
+        title: "Overview", path: base_url_prefix, icon: nil,
+        active: current_path == base_url_prefix, type: :file,
+        collapsed: false, collapsible: false, target: "_self",
+        has_index: false, section: false, children: []
+      }
+    end
+
+    def build_tree_from_config(items, path, base_url_prefix)
+      tree = Sidebar::ConfigParser.new(
+        items, docs_path: path, current_path: current_path_relative_to(base_url_prefix)
+      ).parse.map(&:to_h)
+
+      Sidebar::PathPrefixer.new(tree, base_url_prefix).prefix
+    end
+
+    def build_tree_from_filesystem(path, base_url_prefix)
+      file_items = Sidebar::FileSystemScanner.new(path).scan
+      tree = Sidebar::TreeBuilder.new(
+        docs_path: path, current_path: current_path_relative_to(base_url_prefix)
+      ).build(file_items)
+
+      Sidebar::PathPrefixer.new(tree, base_url_prefix).prefix
+    end
+
+    def current_path_relative_to(prefix)
+      return current_path if prefix.empty?
+      return current_path unless current_path.start_with?(prefix)
+
+      relative = current_path.sub(prefix, "")
+      relative.empty? ? "/" : relative
+    end
+
+    def renderer
+      @renderer ||= Sidebar::Renderer.new(
+        site_title: config&.title || "Documentation",
+        base_url: config&.build&.base || "/",
+        header_ctas: header_ctas
+      )
+    end
+
+    def tabs_configured?
+      tabs = config&.tabs
+      tabs.is_a?(Array) && tabs.any?
+    end
+
+    def find_active_tab
+      return nil unless tabs_configured?
+
+      normalized_current = current_path.chomp("/")
+      config.tabs.find { |tab| tab_matches_current?(tab, normalized_current) }
+    end
+
+    def tab_matches_current?(tab, normalized_current)
+      return false if tab["external"]
+
+      tab_href = tab["href"]&.chomp("/")
+      return false if tab_href.nil?
+
+      normalized_current == tab_href || normalized_current.start_with?("#{tab_href}/")
+    end
+  end
+end

data/lib/docyard/rendering/icon_helpers.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Docyard
+  module IconHelpers
+    def icon(name, weight = "regular")
+      Icons.render(name.to_s.tr("_", "-"), weight) || ""
+    end
+
+    def icon_file_extension(extension)
+      Icons.render_file_extension(extension) || ""
+    end
+  end
+end

data/lib/docyard/{icons → rendering/icons}/phosphor.rb

@@ -36,7 +36,32 @@ module Docyard
         "siren" => '<path d="M120,16V8a8,8,0,0,1,16,0v8a8,8,0,0,1-16,0Zm80,32a8,8,0,0,0,5.66-2.34l8-8a8,8,0,0,0-11.32-11.32l-8,8A8,8,0,0,0,200,48ZM50.34,45.66A8,8,0,0,0,61.66,34.34l-8-8A8,8,0,0,0,42.34,37.66Zm87,26.45a8,8,0,1,0-2.64,15.78C153.67,91.08,168,108.32,168,128a8,8,0,0,0,16,0C184,100.6,163.93,76.57,137.32,72.11ZM232,176v24a16,16,0,0,1-16,16H40a16,16,0,0,1-16-16V176a16,16,0,0,1,16-16V128a88,88,0,0,1,88.67-88c48.15.36,87.33,40.29,87.33,89v31A16,16,0,0,1,232,176ZM56,160H200V129c0-40-32.05-72.71-71.45-73H128a72,72,0,0,0-72,72Zm160,40V176H40v24H216Z"/>',
         "file" => '<path d="M213.66,82.34l-56-56A8,8,0,0,0,152,24H56A16,16,0,0,0,40,40V216a16,16,0,0,0,16,16H200a16,16,0,0,0,16-16V88A8,8,0,0,0,213.66,82.34ZM160,51.31,188.69,80H160ZM200,216H56V40h88V88a8,8,0,0,0,8,8h48V216Z"/>',
         "terminal-window" => '<path d="M128,128a8,8,0,0,1-3,6.25l-40,32a8,8,0,1,1-10-12.5L107.19,128,75,102.25a8,8,0,1,1,10-12.5l40,32A8,8,0,0,1,128,128Zm48,24H136a8,8,0,0,0,0,16h40a8,8,0,0,0,0-16Zm56-96V200a16,16,0,0,1-16,16H40a16,16,0,0,1-16-16V56A16,16,0,0,1,40,40H216A16,16,0,0,1,232,56ZM216,200V56H40V200H216Z"/>',
-        "list-dashes" => '<path d="M88,64a8,8,0,0,1,8-8H216a8,8,0,0,1,0,16H96A8,8,0,0,1,88,64Zm128,56H96a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16Zm0,64H96a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16ZM56,56H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Zm0,64H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Zm0,64H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Z"/>'
+        "list-dashes" => '<path d="M88,64a8,8,0,0,1,8-8H216a8,8,0,0,1,0,16H96A8,8,0,0,1,88,64Zm128,56H96a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16Zm0,64H96a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16ZM56,56H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Zm0,64H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Zm0,64H40a8,8,0,0,0,0,16H56a8,8,0,0,0,0-16Z"/>',
+        "magnifying-glass" => '<path d="M229.66,218.34l-50.07-50.06a88.11,88.11,0,1,0-11.31,11.31l50.06,50.07a8,8,0,0,0,11.32-11.32ZM40,112a72,72,0,1,1,72,72A72.08,72.08,0,0,1,40,112Z"/>',
+        "command" => '<path d="M180,144H160V112h20a36,36,0,1,0-36-36V96H112V76a36,36,0,1,0-36,36H96v32H76a36,36,0,1,0,36,36V160h32v20a36,36,0,1,0,36-36ZM160,76a20,20,0,1,1,20,20H160ZM56,76a20,20,0,0,1,40,0V96H76A20,20,0,0,1,56,76ZM96,180a20,20,0,1,1-20-20H96Zm16-68h32v32H112Zm68,88a20,20,0,0,1-20-20V160h20a20,20,0,0,1,0,40Z"/>',
+        "hash" => '<path d="M224,88H175.4l8.47-46.57a8,8,0,0,0-15.74-2.86l-9,49.43H111.4l8.47-46.57a8,8,0,0,0-15.74-2.86L95.14,88H48a8,8,0,0,0,0,16H92.23L83.5,152H32a8,8,0,0,0,0,16H80.6l-8.47,46.57a8,8,0,0,0,6.44,9.3A7.79,7.79,0,0,0,80,224a8,8,0,0,0,7.86-6.57l9-49.43H144.6l-8.47,46.57a8,8,0,0,0,6.44,9.3,7.79,7.79,0,0,0,1.43.13,8,8,0,0,0,7.86-6.57l9-49.43H208a8,8,0,0,0,0-16H163.77l8.73-48H224a8,8,0,0,0,0-16Zm-68.5,64H107.77l8.73-48h47.73Z"/>',
+        "table" => '<path d="M224,48H32a8,8,0,0,0-8,8V192a16,16,0,0,0,16,16H216a16,16,0,0,0,16-16V56A8,8,0,0,0,224,48ZM40,112H80v32H40Zm56,0H216v32H96Zm120-48v32H40V64ZM40,160H80v32H40Zm176,32H96V160H216v32Z"/>',
+        "caret-down" => '<path d="M213.66,101.66l-80,80a8,8,0,0,1-11.32,0l-80-80A8,8,0,0,1,53.66,90.34L128,164.69l74.34-74.35a8,8,0,0,1,11.32,11.32Z"/>',
+        "sidebar" => '<path d="M216,40H40A16,16,0,0,0,24,56V200a16,16,0,0,0,16,16H216a16,16,0,0,0,16-16V56A16,16,0,0,0,216,40ZM40,56H80V200H40ZM216,200H96V56H216V200Z"/>',
+        "link-simple" => '<path d="M165.66,90.34a8,8,0,0,1,0,11.32l-64,64a8,8,0,0,1-11.32-11.32l64-64A8,8,0,0,1,165.66,90.34ZM215.6,40.4a56,56,0,0,0-79.2,0L106.34,70.45a8,8,0,0,0,11.32,11.32l30.06-30a40,40,0,0,1,56.57,56.56l-30.07,30.06a8,8,0,0,0,11.31,11.32L215.6,119.6a56,56,0,0,0,0-79.2ZM138.34,174.22l-30.06,30.06a40,40,0,1,1-56.56-56.56l30.05-30.06a8,8,0,0,0-11.32-11.32L40.4,136.4a56,56,0,0,0,79.2,79.2l30.06-30.07a8,8,0,0,0-11.32-11.31Z"/>',
+        "copyright" => '<path d="M128,24A104,104,0,1,0,232,128,104.11,104.11,0,0,0,128,24Zm0,192a88,88,0,1,1,88-88A88.1,88.1,0,0,1,128,216ZM96,128a32,32,0,0,0,57.6,19.2,8,8,0,0,1,12.8,9.61,48,48,0,1,1,0-57.62,8,8,0,0,1-12.8,9.61A32,32,0,0,0,96,128Z"/>',
+        "equals" => '<path d="M224,160a8,8,0,0,1-8,8H40a8,8,0,0,1,0-16H216A8,8,0,0,1,224,160ZM40,104H216a8,8,0,0,0,0-16H40a8,8,0,0,0,0,16Z"/>',
+        "x-logo" => '<path d="M214.75,211.71l-62.6-98.38,61.77-67.95a8,8,0,0,0-11.84-10.76L143.24,99.34,102.75,35.71A8,8,0,0,0,96,32H48a8,8,0,0,0-6.75,12.3l62.6,98.37-61.77,68a8,8,0,1,0,11.84,10.76l58.84-64.72,40.49,63.63A8,8,0,0,0,160,224h48a8,8,0,0,0,6.75-12.29ZM164.39,208,62.57,48h29L193.43,208Z"/>',
+        "discord-logo" => '<path d="M104,140a12,12,0,1,1-12-12A12,12,0,0,1,104,140Zm60-12a12,12,0,1,0,12,12A12,12,0,0,0,164,128Zm74.45,64.9-67,29.71a16.17,16.17,0,0,1-21.71-9.1l-8.11-22q-6.72.45-13.63.46t-13.63-.46l-8.11,22a16.18,16.18,0,0,1-21.71,9.1l-67-29.71a15.93,15.93,0,0,1-9.06-18.51L38,58A16.07,16.07,0,0,1,51,46.14l36.06-5.93a16.22,16.22,0,0,1,18.26,11.88l3.26,12.84Q118.11,64,128,64t19.4.93l3.26-12.84a16.21,16.21,0,0,1,18.26-11.88L205,46.14A16.07,16.07,0,0,1,218,58l29.53,116.38A15.93,15.93,0,0,1,238.45,192.9ZM232,178.28,202.47,62s0,0-.08,0L166.33,56a.17.17,0,0,0-.17,0l-2.83,11.14c5,.94,10,2.06,14.83,3.42A8,8,0,0,1,176,86.31a8.09,8.09,0,0,1-2.16-.3A172.25,172.25,0,0,0,128,80a172.25,172.25,0,0,0-45.84,6,8,8,0,1,1-4.32-15.4c4.82-1.36,9.78-2.48,14.82-3.42L89.83,56s0,0-.12,0h0L53.61,61.93a.17.17,0,0,0-.09,0L24,178.33,91,208a.23.23,0,0,0,.22,0L98,189.72a173.2,173.2,0,0,1-20.14-4.32A8,8,0,0,1,82.16,170,171.85,171.85,0,0,0,128,176a171.85,171.85,0,0,0,45.84-6,8,8,0,0,1,4.32,15.41A173.2,173.2,0,0,1,158,189.72L164.75,208a.22.22,0,0,0,.21,0Z"/>',
+        "linkedin-logo" => '<path d="M216,24H40A16,16,0,0,0,24,40V216a16,16,0,0,0,16,16H216a16,16,0,0,0,16-16V40A16,16,0,0,0,216,24Zm0,192H40V40H216V216ZM96,112v64a8,8,0,0,1-16,0V112a8,8,0,0,1,16,0Zm88,28v36a8,8,0,0,1-16,0V140a20,20,0,0,0-40,0v36a8,8,0,0,1-16,0V112a8,8,0,0,1,15.79-1.78A36,36,0,0,1,184,140ZM100,84A12,12,0,1,1,88,72,12,12,0,0,1,100,84Z"/>',
+        "youtube-logo" => '<path d="M164.44,121.34l-48-32A8,8,0,0,0,104,96v64a8,8,0,0,0,12.44,6.66l48-32a8,8,0,0,0,0-13.32ZM120,145.05V111l25.58,17ZM234.33,69.52a24,24,0,0,0-14.49-16.4C185.56,39.88,131,40,128,40s-57.56-.12-91.84,13.12a24,24,0,0,0-14.49,16.4C19.08,79.5,16,97.74,16,128s3.08,48.5,5.67,58.48a24,24,0,0,0,14.49,16.41C69,215.56,120.4,216,127.34,216h1.32c6.94,0,58.37-.44,91.18-13.11a24,24,0,0,0,14.49-16.41c2.59-10,5.67-28.22,5.67-58.48S236.92,79.5,234.33,69.52Zm-15.49,113a8,8,0,0,1-4.77,5.49c-31.65,12.22-85.48,12-86,12H128c-.54,0-54.33.2-86-12a8,8,0,0,1-4.77-5.49C34.8,173.39,32,156.57,32,128s2.8-45.39,5.16-54.47A8,8,0,0,1,41.93,68c30.52-11.79,81.66-12,85.85-12h.27c.54,0,54.38-.18,86,12a8,8,0,0,1,4.77,5.49C221.2,82.61,224,99.43,224,128S221.2,173.39,218.84,182.47Z"/>',
+        "twitter-logo" => '<path d="M214.75,211.71l-62.6-98.38,61.77-67.95a8,8,0,0,0-11.84-10.76L143.24,99.34,102.75,35.71A8,8,0,0,0,96,32H48a8,8,0,0,0-6.75,12.3l62.6,98.37-61.77,68a8,8,0,1,0,11.84,10.76l58.84-64.72,40.49,63.63A8,8,0,0,0,160,224h48a8,8,0,0,0,6.75-12.29ZM164.39,208,62.57,48h29L193.43,208Z"/>',
+        "instagram-logo" => '<path d="M128,80a48,48,0,1,0,48,48A48.05,48.05,0,0,0,128,80Zm0,80a32,32,0,1,1,32-32A32,32,0,0,1,128,160ZM176,24H80A56.06,56.06,0,0,0,24,80v96a56.06,56.06,0,0,0,56,56h96a56.06,56.06,0,0,0,56-56V80A56.06,56.06,0,0,0,176,24Zm40,152a40,40,0,0,1-40,40H80a40,40,0,0,1-40-40V80A40,40,0,0,1,80,40h96a40,40,0,0,1,40,40ZM192,76a12,12,0,1,1-12-12A12,12,0,0,1,192,76Z"/>',
+        "facebook-logo" => '<path d="M128,24A104,104,0,1,0,232,128,104.11,104.11,0,0,0,128,24Zm8,191.63V152h24a8,8,0,0,0,0-16H136V112a16,16,0,0,1,16-16h16a8,8,0,0,0,0-16H152a32,32,0,0,0-32,32v24H96a8,8,0,0,0,0,16h24v63.63a88,88,0,1,1,16,0Z"/>',
+        "tiktok-logo" => '<path d="M224,72a48.05,48.05,0,0,1-48-48,8,8,0,0,0-8-8H128a8,8,0,0,0-8,8V156a20,20,0,1,1-28.57-18.08A8,8,0,0,0,96,130.69V88a8,8,0,0,0-9.4-7.88C50.91,86.48,24,119.1,24,156a76,76,0,0,0,152,0V116.29A103.25,103.25,0,0,0,224,128a8,8,0,0,0,8-8V80A8,8,0,0,0,224,72Zm-8,39.64a87.19,87.19,0,0,1-43.33-16.15A8,8,0,0,0,160,102v54a60,60,0,0,1-120,0c0-25.9,16.64-49.13,40-57.6v27.67A36,36,0,1,0,136,156V32h24.5A64.14,64.14,0,0,0,216,87.5Z"/>',
+        "twitch-logo" => '<path d="M208,32H48A16,16,0,0,0,32,48V192a16,16,0,0,0,16,16H64v32a8,8,0,0,0,13.12,6.15L122.9,208h42.2a16,16,0,0,0,10.25-3.71l42.89-35.75A15.93,15.93,0,0,0,224,156.25V48A16,16,0,0,0,208,32Zm0,124.25L165.1,192H120a8,8,0,0,0-5.12,1.85L80,222.92V200a8,8,0,0,0-8-8H48V48H208ZM160,136V88a8,8,0,0,1,16,0v48a8,8,0,0,1-16,0Zm-48,0V88a8,8,0,0,1,16,0v48a8,8,0,0,1-16,0Z"/>',
+        "reddit-logo" => '<path d="M248,104a32,32,0,0,0-52.94-24.19c-16.75-8.9-36.76-14.28-57.66-15.53l5.19-31.17,17.72,2.72a24,24,0,1,0,2.87-15.74l-26-4a8,8,0,0,0-9.11,6.59L121.2,64.16c-21.84.94-42.82,6.38-60.26,15.65a32,32,0,0,0-42.59,47.74A59,59,0,0,0,16,144c0,21.93,12,42.35,33.91,57.49C70.88,216,98.61,224,128,224s57.12-8,78.09-22.51C228,186.35,240,165.93,240,144a59,59,0,0,0-2.35-16.45A32.16,32.16,0,0,0,248,104ZM184,24a8,8,0,1,1-8,8A8,8,0,0,1,184,24Zm40.13,93.78a8,8,0,0,0-3.29,10A43.58,43.58,0,0,1,224,144c0,16.53-9.59,32.27-27,44.33C178.67,201,154.17,208,128,208s-50.67-7-69-19.67C41.59,176.27,32,160.53,32,144a43.75,43.75,0,0,1,3.14-16.17,8,8,0,0,0-3.27-10A16,16,0,1,1,52.94,94.59a8,8,0,0,0,10.45,2.23l.36-.22C81.45,85.9,104.25,80,128,80h0c23.73,0,46.53,5.9,64.23,16.6l.42.25a8,8,0,0,0,10.39-2.26,16,16,0,1,1,21.07,23.19ZM88,144a16,16,0,1,1,16-16A16,16,0,0,1,88,144Zm96-16a16,16,0,1,1-16-16A16,16,0,0,1,184,128Zm-16.93,44.25a8,8,0,0,1-3.32,10.82,76.18,76.18,0,0,1-71.5,0,8,8,0,1,1,7.5-14.14,60.18,60.18,0,0,0,56.5,0A8,8,0,0,1,167.07,172.25Z"/>',
+        "mastodon-logo" => '<path d="M184,32H72A40,40,0,0,0,32,72V192a40,40,0,0,0,40,40h88a8,8,0,0,0,0-16H72a24,24,0,0,1-24-24v-8H184a40,40,0,0,0,40-40V72A40,40,0,0,0,184,32Zm24,112a24,24,0,0,1-24,24H48V72A24,24,0,0,1,72,48H184a24,24,0,0,1,24,24Zm-24-40v32a8,8,0,0,1-16,0V104a16,16,0,0,0-32,0v32a8,8,0,0,1-16,0V104a16,16,0,0,0-32,0v32a8,8,0,0,1-16,0V104a32,32,0,0,1,56-21.13A32,32,0,0,1,184,104Z"/>',
+        "threads-logo" => '<path d="M186.42,123.65a63.81,63.81,0,0,0-11.13-6.72c-4-29.89-24-39.31-33.1-42.07-19.78-6-42.51,1.19-52.85,16.7a8,8,0,0,0,13.32,8.88c6.37-9.56,22-14.16,34.89-10.27,9.95,3,16.82,10.3,20.15,21a81.05,81.05,0,0,0-15.29-1.43c-13.92,0-26.95,3.59-36.67,10.1C94.3,127.57,88,139,88,152c0,20.58,15.86,35.52,37.71,35.52a48,48,0,0,0,34.35-14.81c6.44-6.7,14-18.36,15.61-37.1.38.26.74.53,1.1.8C186.88,144.05,192,154.68,192,168c0,19.36-20.34,48-64,48-26.73,0-45.48-8.65-57.34-26.44C60.93,175,56,154.26,56,128s4.93-47,14.66-61.56C82.52,48.65,101.27,40,128,40c32.93,0,54,13.25,64.53,40.52a8,8,0,1,0,14.93-5.75C194.68,41.56,167.2,24,128,24,96,24,72.19,35.29,57.34,57.56,45.83,74.83,40,98.52,40,128s5.83,53.17,17.34,70.44C72.19,220.71,96,232,128,232c30.07,0,48.9-11.48,59.4-21.1C200.3,199.08,208,183,208,168,208,149.66,200.54,134.32,186.42,123.65Zm-37.89,38a31.94,31.94,0,0,1-22.82,9.9c-10.81,0-21.71-6-21.71-19.52,0-12.63,12-26.21,38.41-26.21A63.88,63.88,0,0,1,160,128.24C160,142.32,156,153.86,148.53,161.62Z"/>',
+        "pinterest-logo" => '<path d="M224,112c0,22.57-7.9,43.2-22.23,58.11C188.39,184,170.25,192,152,192c-17.88,0-29.82-5.86-37.43-12l-10.78,45.82A8,8,0,0,1,96,232a8.24,8.24,0,0,1-1.84-.21,8,8,0,0,1-6-9.62l32-136a8,8,0,0,1,15.58,3.66l-16.9,71.8C122,166,131.3,176,152,176c27.53,0,56-23.94,56-64A72,72,0,1,0,73.63,148a8,8,0,0,1-13.85,8A88,88,0,1,1,224,112Z"/>',
+        "medium-logo" => '<path d="M72,64a64,64,0,1,0,64,64A64.07,64.07,0,0,0,72,64Zm0,112a48,48,0,1,1,48-48A48.05,48.05,0,0,1,72,176ZM184,64c-5.68,0-16.4,2.76-24.32,21.25C154.73,96.8,152,112,152,128s2.73,31.2,7.68,42.75C167.6,189.24,178.32,192,184,192s16.4-2.76,24.32-21.25C213.27,159.2,216,144,216,128s-2.73-31.2-7.68-42.75C200.4,66.76,189.68,64,184,64Zm0,112c-5.64,0-16-18.22-16-48s10.36-48,16-48,16,18.22,16,48S189.64,176,184,176ZM248,72V184a8,8,0,0,1-16,0V72a8,8,0,0,1,16,0Z"/>',
+        "slack-logo" => '<path d="M221.13,128A32,32,0,0,0,184,76.31V56a32,32,0,0,0-56-21.13A32,32,0,0,0,76.31,72H56a32,32,0,0,0-21.13,56A32,32,0,0,0,72,179.69V200a32,32,0,0,0,56,21.13A32,32,0,0,0,179.69,184H200a32,32,0,0,0,21.13-56ZM72,152a16,16,0,1,1-16-16H72Zm48,48a16,16,0,0,1-32,0V152a16,16,0,0,1,16-16h16Zm0-80H56a16,16,0,0,1,0-32h48a16,16,0,0,1,16,16Zm0-48H104a16,16,0,1,1,16-16Zm16-16a16,16,0,0,1,32,0v48a16,16,0,0,1-16,16H136Zm16,160a16,16,0,0,1-16-16V184h16a16,16,0,0,1,0,32Zm48-48H152a16,16,0,0,1-16-16V136h64a16,16,0,0,1,0,32Zm0-48H184V104a16,16,0,1,1,16,16Z"/>',
+        "gitlab-logo" => '<path d="M230.15,117.1,210.25,41a11.94,11.94,0,0,0-22.79-1.11L169.78,88H86.22L68.54,39.87A11.94,11.94,0,0,0,45.75,41L25.85,117.1a57.19,57.19,0,0,0,22,61l73.27,51.76a11.91,11.91,0,0,0,13.74,0l73.27-51.76A57.19,57.19,0,0,0,230.15,117.1ZM58,57.5,73.13,98.76A8,8,0,0,0,80.64,104h94.72a8,8,0,0,0,7.51-5.24L198,57.5l13.07,50L128,166.21,44.9,107.5ZM40.68,124.11,114.13,176,93.41,190.65,57.09,165A41.06,41.06,0,0,1,40.68,124.11Zm87.32,91-20.73-14.65L128,185.8l20.73,14.64ZM198.91,165l-36.32,25.66L141.87,176l73.45-51.9A41.06,41.06,0,0,1,198.91,165Z"/>'
       },
       "bold" => {
         "heart" => '<path d="M178,36c-20.09,0-37.92,7.93-50,21.56C115.92,43.93,98.09,36,78,36a66.08,66.08,0,0,0-66,66c0,72.34,105.81,130.14,110.31,132.57a12,12,0,0,0,11.38,0C138.19,232.14,244,174.34,244,102A66.08,66.08,0,0,0,178,36Zm-5.49,142.36A328.69,328.69,0,0,1,128,210.16a328.69,328.69,0,0,1-44.51-31.8C61.82,159.77,36,131.42,36,102A42,42,0,0,1,78,60c17.8,0,32.7,9.4,38.89,24.54a12,12,0,0,0,22.22,0C145.3,69.4,160.2,60,178,60a42,42,0,0,1,42,42C220,131.42,194.18,159.77,172.51,178.36Z"/>'

data/lib/docyard/{markdown.rb → rendering/markdown.rb}

@@ -3,19 +3,20 @@
 require "kramdown"
 require "kramdown-parser-gfm"
 require "yaml"
-require_relative "components/registry"
-require_relative "components/base_processor"
-require_relative "components/callout_processor"
-require_relative "components/tabs_processor"
-require_relative "components/icon_processor"
-require_relative "components/code_block_processor"
-require_relative "components/code_snippet_import_preprocessor"
-require_relative "components/code_block_options_preprocessor"
-require_relative "components/code_block_diff_preprocessor"
-require_relative "components/code_block_focus_preprocessor"
-require_relative "components/table_wrapper_processor"
-require_relative "components/heading_anchor_processor"
-require_relative "components/table_of_contents_processor"
+require_relative "../components/registry"
+require_relative "../components/base_processor"
+require_relative "../components/processors/callout_processor"
+require_relative "../components/processors/tabs_processor"
+require_relative "../components/processors/icon_processor"
+require_relative "../components/processors/code_block_processor"
+require_relative "../components/processors/code_snippet_import_preprocessor"
+require_relative "../components/processors/code_block_options_preprocessor"
+require_relative "../components/processors/code_block_diff_preprocessor"
+require_relative "../components/processors/code_block_focus_preprocessor"
+require_relative "../components/processors/table_wrapper_processor"
+require_relative "../components/processors/heading_anchor_processor"
+require_relative "../components/processors/table_of_contents_processor"
+require_relative "../components/aliases"
 
 module Docyard
   class Markdown
@@ -61,6 +62,10 @@ module Docyard
       frontmatter.dig("sidebar", "collapsed")
     end
 
+    def sidebar_order
+      frontmatter.dig("sidebar", "order")
+    end
+
     def toc
       @context[:toc] || []
     end
@@ -90,6 +95,7 @@ module Docyard
         input: "GFM",
         hard_wrap: false,
         syntax_highlighter: "rouge",
+        syntax_highlighter_opts: { guess_lang: true },
         parse_block_html: true
       ).to_html