docyard 0.7.0 → 0.8.0

data/lib/docyard/navigation/sidebar_builder.rb

@@ -5,19 +5,23 @@ 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
+    attr_reader :docs_path, :current_path, :config, :header_ctas
 
-    def initialize(docs_path:, current_path: "/", config: nil)
+    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_tree
+      @tree ||= build_scoped_tree
     end
 
     def to_html
@@ -26,65 +30,130 @@ module Docyard
 
     private
 
-    def build_tree
-      if config_sidebar_items?
-        build_tree_from_config
+    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
-        build_tree_from_filesystem
+        Sidebar::TreeFilter.new(build_tree_for_path(docs_path), tab_path).filter
       end
     end
 
-    def build_tree_from_config
-      config_parser.parse.map(&:to_h)
+    def scoped_sidebar_available?(path)
+      File.directory?(path) && Sidebar::LocalConfigLoader.new(path).config_file_exists?
     end
 
-    def build_tree_from_filesystem
-      file_items = scanner.scan
-      tree_builder.build(file_items)
+    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 config_sidebar_items?
-      config_sidebar_items&.any?
+    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 config_sidebar_items
-      return [] unless config
+    def maybe_prepend_overview(tree, path, base_url_prefix)
+      return tree if skip_overview?(tree, path, base_url_prefix)
 
-      config.sidebar&.items || []
+      [build_overview_item(base_url_prefix)] + tree
     end
 
-    def config_parser
-      @config_parser ||= Sidebar::ConfigParser.new(
-        config_sidebar_items,
-        docs_path: docs_path,
-        current_path: current_path
-      )
+    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 scanner
-      @scanner ||= Sidebar::FileSystemScanner.new(docs_path)
+    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 tree_builder
-      @tree_builder ||= Sidebar::TreeBuilder.new(
-        docs_path: docs_path,
-        current_path: current_path
-      )
+    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: extract_site_title,
-        base_url: extract_base_url
+        site_title: config&.title || "Documentation",
+        base_url: config&.build&.base || "/",
+        header_ctas: header_ctas
       )
     end
 
-    def extract_base_url
-      config&.build&.base_url || "/"
+    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 extract_site_title
-      config&.site&.title || "Documentation"
+    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/rendering/icons/phosphor.rb

@@ -39,7 +39,29 @@ module Docyard
         "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"/>'
+        "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/rendering/markdown.rb

@@ -62,6 +62,10 @@ module Docyard
       frontmatter.dig("sidebar", "collapsed")
     end
 
+    def sidebar_order
+      frontmatter.dig("sidebar", "order")
+    end
+
     def toc
       @context[:toc] || []
     end
@@ -91,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
 

data/lib/docyard/rendering/renderer.rb

@@ -2,51 +2,52 @@
 
 require "erb"
 require_relative "../config/constants"
+require_relative "icon_helpers"
 
 module Docyard
   class Renderer
     include Utils::UrlHelpers
+    include IconHelpers
 
     LAYOUTS_PATH = File.join(__dir__, "../templates", "layouts")
     ERRORS_PATH = File.join(__dir__, "../templates", "errors")
     PARTIALS_PATH = File.join(__dir__, "../templates", "partials")
+    DEFAULT_LAYOUT = "default"
 
-    attr_reader :layout_path, :base_url, :config
+    attr_reader :base_url, :config
 
-    def initialize(layout: "default", base_url: "/", config: nil)
-      @layout_path = File.join(LAYOUTS_PATH, "#{layout}.html.erb")
+    def initialize(base_url: "/", config: nil)
       @base_url = normalize_base_url(base_url)
       @config = config
     end
 
-    def render_file(file_path, sidebar_html: "", prev_next_html: "", branding: {})
-      markdown_content = File.read(file_path)
-      markdown = Markdown.new(markdown_content, config: config)
-
-      html_content = strip_md_from_links(markdown.html)
-      toc = markdown.toc
+    def render_file(file_path, sidebar_html: "", prev_next_html: "", breadcrumbs: nil, branding: {},
+                    template_options: {}, current_path: "/")
+      markdown = Markdown.new(File.read(file_path), config: config)
 
       render(
-        content: html_content,
+        content: strip_md_from_links(markdown.html),
         page_title: markdown.title || Constants::DEFAULT_SITE_TITLE,
-        navigation: {
-          sidebar_html: sidebar_html,
-          prev_next_html: prev_next_html,
-          toc: toc
-        },
-        branding: branding
+        navigation: build_navigation(sidebar_html, prev_next_html, markdown.toc, breadcrumbs),
+        branding: branding,
+        template_options: template_options,
+        current_path: current_path
       )
     end
 
-    def render(content:, page_title: Constants::DEFAULT_SITE_TITLE, navigation: {}, branding: {})
-      template = File.read(layout_path)
+    def build_navigation(sidebar_html, prev_next_html, toc, breadcrumbs)
+      { sidebar_html: sidebar_html, prev_next_html: prev_next_html, toc: toc, breadcrumbs: breadcrumbs }
+    end
 
-      sidebar_html = navigation[:sidebar_html] || ""
-      prev_next_html = navigation[:prev_next_html] || ""
-      toc = navigation[:toc] || []
+    def render(content:, page_title: Constants::DEFAULT_SITE_TITLE, navigation: {}, branding: {},
+               template_options: {}, current_path: "/")
+      layout = template_options[:template] || DEFAULT_LAYOUT
+      layout_path = File.join(LAYOUTS_PATH, "#{layout}.html.erb")
+      template = File.read(layout_path)
 
-      assign_content_variables(content, page_title, sidebar_html, prev_next_html, toc)
-      assign_branding_variables(branding)
+      assign_content_variables(content, page_title, navigation)
+      assign_branding_variables(branding, current_path)
+      assign_template_variables(template_options)
 
       ERB.new(template).result(binding)
     end
@@ -84,18 +85,20 @@ module Docyard
 
     private
 
-    def assign_content_variables(content, page_title, sidebar_html, prev_next_html, toc)
+    def assign_content_variables(content, page_title, navigation)
       @content = content
       @page_title = page_title
-      @sidebar_html = sidebar_html
-      @prev_next_html = prev_next_html
-      @toc = toc
+      @sidebar_html = navigation[:sidebar_html] || ""
+      @prev_next_html = navigation[:prev_next_html] || ""
+      @toc = navigation[:toc] || []
+      @breadcrumbs = navigation[:breadcrumbs]
     end
 
-    def assign_branding_variables(branding)
+    def assign_branding_variables(branding, current_path = "/")
       assign_site_branding(branding)
-      assign_display_options(branding)
       assign_search_options(branding)
+      assign_credits_and_social(branding)
+      assign_tabs(branding, current_path)
     end
 
     def assign_site_branding(branding)
@@ -104,11 +107,7 @@ module Docyard
       @logo = branding[:logo] || Constants::DEFAULT_LOGO_PATH
       @logo_dark = branding[:logo_dark]
       @favicon = branding[:favicon] || Constants::DEFAULT_FAVICON_PATH
-    end
-
-    def assign_display_options(branding)
-      @display_logo = branding[:display_logo].nil? || branding[:display_logo]
-      @display_title = branding[:display_title].nil? || branding[:display_title]
+      @has_custom_logo = branding[:has_custom_logo] || false
     end
 
     def assign_search_options(branding)
@@ -116,6 +115,47 @@ module Docyard
       @search_placeholder = branding[:search_placeholder] || "Search documentation..."
     end
 
+    def assign_credits_and_social(branding)
+      @credits = branding[:credits] != false
+      @copyright = branding[:copyright]
+      @social = branding[:social] || []
+      @header_ctas = branding[:header_ctas] || []
+    end
+
+    def assign_tabs(branding, current_path)
+      tabs = branding[:tabs] || []
+      @tabs = tabs.map { |tab| tab.merge(active: tab_active?(tab[:href], current_path)) }
+      @has_tabs = branding[:has_tabs] || false
+      @current_path = current_path
+    end
+
+    def tab_active?(tab_href, current_path)
+      return false if tab_href.nil? || current_path.nil?
+      return false if tab_href.start_with?("http://", "https://")
+
+      normalized_tab = tab_href.chomp("/")
+      normalized_current = current_path.chomp("/")
+
+      return true if normalized_tab == normalized_current
+
+      current_path.start_with?("#{normalized_tab}/")
+    end
+
+    def assign_template_variables(template_options)
+      @hero = template_options[:hero]
+      @features = template_options[:features]
+      @features_header = template_options[:features_header]
+      @show_sidebar = template_options.fetch(:show_sidebar, true)
+      @show_toc = template_options.fetch(:show_toc, true)
+      assign_footer_from_landing(template_options[:footer])
+    end
+
+    def assign_footer_from_landing(footer)
+      return unless footer
+
+      @footer_links = footer[:links]
+    end
+
     def strip_md_from_links(html)
       html.gsub(/href="([^"]+)\.md"/, 'href="\1"')
     end

data/lib/docyard/rendering/template_resolver.rb

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+module Docyard
+  class TemplateResolver
+    BACKGROUNDS = %w[grid glow mesh none].freeze
+    DEFAULT_BACKGROUND = "grid"
+
+    attr_reader :frontmatter, :site_config
+
+    def initialize(frontmatter, site_config = {})
+      @frontmatter = frontmatter || {}
+      @site_config = site_config || {}
+    end
+
+    def landing?
+      landing_config.any?
+    end
+
+    def template
+      landing? ? "splash" : "default"
+    end
+
+    def show_sidebar?
+      if landing?
+        landing_config.fetch("sidebar", false)
+      else
+        true
+      end
+    end
+
+    def show_toc?
+      return false if landing?
+
+      true
+    end
+
+    def hero_config
+      return nil unless landing?
+
+      hero = landing_config["hero"]
+      return nil unless hero.is_a?(Hash)
+
+      symbolize_hero(hero)
+    end
+
+    def features_config
+      return nil unless landing?
+
+      features = landing_config["features"]
+      return nil unless features.is_a?(Array)
+
+      features.map { |f| symbolize_feature(f) }
+    end
+
+    def features_header_config
+      return nil unless landing?
+
+      header = landing_config["features_header"]
+      return nil unless header.is_a?(Hash)
+
+      {
+        label: header["label"],
+        title: header["title"],
+        description: header["description"]
+      }.compact
+    end
+
+    def footer_config
+      return nil unless landing?
+
+      footer = landing_config["footer"]
+      return nil unless footer.is_a?(Hash)
+
+      {
+        links: normalize_footer_links(footer["links"])
+      }
+    end
+
+    def to_options
+      {
+        template: template,
+        landing: landing?,
+        show_sidebar: show_sidebar?,
+        show_toc: show_toc?,
+        hero: hero_config,
+        features: features_config,
+        features_header: features_header_config,
+        footer: footer_config
+      }
+    end
+
+    private
+
+    def normalize_footer_links(links)
+      return nil unless links.is_a?(Array)
+
+      links.map do |link|
+        next unless link.is_a?(Hash)
+
+        { text: link["text"], link: link["link"] }
+      end.compact
+    end
+
+    def landing_config
+      @landing_config ||= frontmatter["landing"] || site_config["landing"] || {}
+    end
+
+    def symbolize_hero(hero)
+      background = hero["background"]
+      validated_bg = BACKGROUNDS.include?(background) ? background : DEFAULT_BACKGROUND
+
+      {
+        background: validated_bg,
+        badge: hero["badge"],
+        name: hero["name"],
+        title: hero["title"],
+        tagline: hero["tagline"],
+        gradient: hero.fetch("gradient", true),
+        image: symbolize_image(hero["image"]),
+        actions: symbolize_actions(hero["actions"])
+      }.compact
+    end
+
+    def symbolize_image(image)
+      return nil unless image.is_a?(Hash)
+
+      if image["light"] || image["dark"]
+        {
+          light: image["light"],
+          dark: image["dark"],
+          alt: image["alt"]
+        }.compact
+      else
+        {
+          src: image["src"],
+          alt: image["alt"]
+        }.compact
+      end
+    end
+
+    def symbolize_actions(actions)
+      return nil unless actions.is_a?(Array)
+
+      actions.map do |action|
+        {
+          text: action["text"],
+          link: action["link"],
+          icon: action["icon"],
+          variant: action["variant"] || "primary",
+          target: action["target"],
+          rel: action["rel"]
+        }.compact
+      end
+    end
+
+    def symbolize_feature(feature)
+      return {} unless feature.is_a?(Hash)
+
+      {
+        title: feature["title"],
+        description: feature["description"],
+        icon: feature["icon"],
+        color: feature["color"],
+        link: feature["link"],
+        link_text: feature["link_text"],
+        size: feature["size"],
+        target: feature["target"],
+        rel: feature["rel"]
+      }.compact
+    end
+  end
+end