docyard 0.1.0 → 0.3.0

data/lib/docyard/templates/partials/_tabs.html.erb

@@ -0,0 +1,40 @@
+<div class="docyard-tabs" data-tabs="<%= @group_id %>">
+  <div class="docyard-tabs__list-wrapper">
+    <div role="tablist" aria-label="Code examples" class="docyard-tabs__list">
+      <% @tabs.each_with_index do |tab, index| %>
+        <button
+          role="tab"
+          aria-selected="<%= index == 0 ? 'true' : 'false' %>"
+          aria-controls="tabpanel-<%= @group_id %>-<%= index %>"
+          id="tab-<%= @group_id %>-<%= index %>"
+          class="docyard-tabs__tab"
+          tabindex="<%= index == 0 ? '0' : '-1' %>"
+        >
+          <% if tab[:icon] %>
+            <span class="docyard-tabs__icon">
+              <% if tab[:icon_source] == "file-extension" %>
+                <%= Docyard::Icons.render_file_extension(tab[:icon]) %>
+              <% elsif tab[:icon_source] == "phosphor" %>
+                <%= Docyard::Icons.render(tab[:icon]) %>
+              <% end %>
+            </span>
+          <% end %>
+          <%= tab[:name] %>
+        </button>
+      <% end %>
+      <div class="docyard-tabs__indicator" aria-hidden="true"></div>
+    </div>
+  </div>
+  <% @tabs.each_with_index do |tab, index| %>
+    <div
+      role="tabpanel"
+      id="tabpanel-<%= @group_id %>-<%= index %>"
+      aria-labelledby="tab-<%= @group_id %>-<%= index %>"
+      aria-hidden="<%= index == 0 ? 'false' : 'true' %>"
+      class="docyard-tabs__panel"
+      tabindex="0"
+    >
+      <%= tab[:content] %>
+    </div>
+  <% end %>
+</div>

data/lib/docyard/templates/partials/_theme_toggle.html.erb

@@ -0,0 +1,13 @@
+<button class="theme-toggle" aria-label="Toggle theme" title="Toggle theme">
+  <span class="theme-toggle-track">
+    <!-- Sun icon -->
+    <svg class="theme-toggle-icon theme-toggle-sun-icon" xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 256 256" fill="currentColor">
+      <path d="M120,40V16a8,8,0,0,1,16,0V40a8,8,0,0,1-16,0Zm72,88a64,64,0,1,1-64-64A64.07,64.07,0,0,1,192,128Zm-16,0a48,48,0,1,0-48,48A48.05,48.05,0,0,0,176,128ZM58.34,69.66A8,8,0,0,0,69.66,58.34l-16-16A8,8,0,0,0,42.34,53.66Zm0,116.68-16,16a8,8,0,0,0,11.32,11.32l16-16a8,8,0,0,0-11.32-11.32ZM192,72a8,8,0,0,0,5.66-2.34l16-16a8,8,0,0,0-11.32-11.32l-16,16A8,8,0,0,0,192,72Zm5.66,114.34a8,8,0,0,0-11.32,11.32l16,16a8,8,0,0,0,11.32-11.32ZM48,128a8,8,0,0,0-8-8H16a8,8,0,0,0,0,16H40A8,8,0,0,0,48,128Zm80,80a8,8,0,0,0-8,8v24a8,8,0,0,0,16,0V216A8,8,0,0,0,128,208Zm112-88H216a8,8,0,0,0,0,16h24a8,8,0,0,0,0-16Z"></path>
+    </svg>
+    <!-- Moon stars icon -->
+    <svg class="theme-toggle-icon theme-toggle-moon-icon" xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 256 256" fill="currentColor">
+      <path d="M240,96a8,8,0,0,1-8,8H216v16a8,8,0,0,1-16,0V104H184a8,8,0,0,1,0-16h16V72a8,8,0,0,1,16,0V88h16A8,8,0,0,1,240,96ZM144,56h8v8a8,8,0,0,0,16,0V56h8a8,8,0,0,0,0-16h-8V32a8,8,0,0,0-16,0v8h-8a8,8,0,0,0,0,16Zm72.77,97a8,8,0,0,1,1.43,8A96,96,0,1,1,95.07,37.8a8,8,0,0,1,10.6,9.06A88.07,88.07,0,0,0,209.14,150.33,8,8,0,0,1,216.77,153Zm-19.39,14.88c-1.79.09-3.59.14-5.38.14A104.11,104.11,0,0,1,88,64c0-1.79,0-3.59.14-5.38A80,80,0,1,0,197.38,167.86Z"></path>
+    </svg>
+    <span class="theme-toggle-thumb"></span>
+  </span>
+</button>

data/lib/docyard/utils/path_resolver.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Utils
+    class PathResolver
+      def self.normalize(path)
+        return "/" if path.nil? || path.empty?
+
+        normalized = path.delete_suffix(".md")
+          .delete_suffix("/index")
+
+        normalized = "" if normalized == "index"
+
+        normalized = "/" if normalized.empty?
+        normalized = "/#{normalized}" unless normalized.start_with?("/")
+        normalized
+      end
+
+      def self.to_url(relative_path)
+        normalize(relative_path)
+      end
+
+      def self.ancestor?(parent_path, child_path)
+        return false if parent_path.nil?
+
+        child_path.start_with?(parent_path) && child_path != parent_path
+      end
+    end
+  end
+end

data/lib/docyard/utils/text_formatter.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Docyard
+  module Utils
+    class TextFormatter
+      def self.titleize(string)
+        return "Home" if string == "index"
+
+        string.gsub(/[-_]/, " ")
+          .split
+          .map(&:capitalize)
+          .join(" ")
+      end
+
+      def self.slugify(string)
+        string.downcase
+          .gsub(/\s+/, "-")
+          .gsub(/[^a-z0-9-]/, "")
+      end
+    end
+  end
+end

data/lib/docyard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Docyard
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/docyard.rb

@@ -1,14 +1,26 @@
 # frozen_string_literal: true
 
+# Core modules
 require_relative "docyard/version"
-require_relative "docyard/cli"
-require_relative "docyard/initializer"
-require_relative "docyard/markdown"
+require_relative "docyard/constants"
+require_relative "docyard/errors"
+require_relative "docyard/logging"
+
+# Utilities
+require_relative "docyard/utils/text_formatter"
+require_relative "docyard/utils/path_resolver"
+
+# Routing
+require_relative "docyard/routing/resolution_result"
 require_relative "docyard/router"
+
+# Application components
+require_relative "docyard/markdown"
 require_relative "docyard/renderer"
 require_relative "docyard/asset_handler"
+require_relative "docyard/initializer"
 require_relative "docyard/server"
+require_relative "docyard/cli"
 
 module Docyard
-  class Error < StandardError; end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docyard
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Sanif Himani
@@ -137,27 +137,95 @@ files:
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - LICENSE.txt
+- LICENSE.vscode-icons
 - README.md
 - Rakefile
 - lib/docyard.rb
 - lib/docyard/asset_handler.rb
 - lib/docyard/cli.rb
+- lib/docyard/components/base_processor.rb
+- lib/docyard/components/callout_processor.rb
+- lib/docyard/components/code_block_processor.rb
+- lib/docyard/components/code_detector.rb
+- lib/docyard/components/icon_detector.rb
+- lib/docyard/components/icon_processor.rb
+- lib/docyard/components/registry.rb
+- lib/docyard/components/tabs_parser.rb
+- lib/docyard/components/tabs_processor.rb
+- lib/docyard/config.rb
+- lib/docyard/config/validator.rb
+- lib/docyard/constants.rb
+- lib/docyard/errors.rb
 - lib/docyard/file_watcher.rb
+- lib/docyard/icons.rb
+- lib/docyard/icons/LICENSE.phosphor
+- lib/docyard/icons/file_types.rb
+- lib/docyard/icons/phosphor.rb
 - lib/docyard/initializer.rb
+- lib/docyard/language_mapping.rb
+- lib/docyard/logging.rb
 - lib/docyard/markdown.rb
 - lib/docyard/rack_application.rb
 - lib/docyard/renderer.rb
 - lib/docyard/router.rb
+- lib/docyard/routing/resolution_result.rb
 - lib/docyard/server.rb
+- lib/docyard/sidebar/file_system_scanner.rb
+- lib/docyard/sidebar/renderer.rb
+- lib/docyard/sidebar/title_extractor.rb
+- lib/docyard/sidebar/tree_builder.rb
+- lib/docyard/sidebar_builder.rb
+- lib/docyard/templates/assets/css/code.css
+- lib/docyard/templates/assets/css/components/callout.css
+- lib/docyard/templates/assets/css/components/code-block.css
+- lib/docyard/templates/assets/css/components/icon.css
+- lib/docyard/templates/assets/css/components/logo.css
+- lib/docyard/templates/assets/css/components/navigation.css
+- lib/docyard/templates/assets/css/components/tabs.css
+- lib/docyard/templates/assets/css/components/theme-toggle.css
+- lib/docyard/templates/assets/css/layout.css
 - lib/docyard/templates/assets/css/main.css
-- lib/docyard/templates/assets/css/syntax.css
+- lib/docyard/templates/assets/css/markdown.css
+- lib/docyard/templates/assets/css/reset.css
+- lib/docyard/templates/assets/css/typography.css
+- lib/docyard/templates/assets/css/variables.css
+- lib/docyard/templates/assets/favicon.svg
+- lib/docyard/templates/assets/js/components/code-block.js
+- lib/docyard/templates/assets/js/components/tabs.js
 - lib/docyard/templates/assets/js/reload.js
 - lib/docyard/templates/assets/js/theme.js
+- lib/docyard/templates/assets/logo-dark.svg
+- lib/docyard/templates/assets/logo.svg
+- lib/docyard/templates/config/docyard.yml.erb
 - lib/docyard/templates/errors/404.html.erb
 - lib/docyard/templates/errors/500.html.erb
 - lib/docyard/templates/layouts/default.html.erb
-- lib/docyard/templates/markdown/getting-started.md.erb
+- lib/docyard/templates/markdown/components/callouts.md.erb
+- lib/docyard/templates/markdown/components/icons.md.erb
+- lib/docyard/templates/markdown/components/tabs.md.erb
+- lib/docyard/templates/markdown/configuration.md.erb
+- lib/docyard/templates/markdown/core-concepts/file-structure.md.erb
+- lib/docyard/templates/markdown/core-concepts/markdown.md.erb
+- lib/docyard/templates/markdown/getting-started/installation.md.erb
+- lib/docyard/templates/markdown/getting-started/introduction.md.erb
+- lib/docyard/templates/markdown/getting-started/quick-start.md.erb
 - lib/docyard/templates/markdown/index.md.erb
+- lib/docyard/templates/partials/_callout.html.erb
+- lib/docyard/templates/partials/_code_block.html.erb
+- lib/docyard/templates/partials/_icon.html.erb
+- lib/docyard/templates/partials/_icon_file_extension.html.erb
+- lib/docyard/templates/partials/_icons.html.erb
+- lib/docyard/templates/partials/_nav_group.html.erb
+- lib/docyard/templates/partials/_nav_item.html.erb
+- lib/docyard/templates/partials/_nav_leaf.html.erb
+- lib/docyard/templates/partials/_nav_list.html.erb
+- lib/docyard/templates/partials/_nav_section.html.erb
+- lib/docyard/templates/partials/_sidebar.html.erb
+- lib/docyard/templates/partials/_sidebar_footer.html.erb
+- lib/docyard/templates/partials/_tabs.html.erb
+- lib/docyard/templates/partials/_theme_toggle.html.erb
+- lib/docyard/utils/path_resolver.rb
+- lib/docyard/utils/text_formatter.rb
 - lib/docyard/version.rb
 - sig/docyard.rbs
 homepage: https://github.com/sanifhimani/docyard

data/lib/docyard/templates/assets/css/syntax.css

@@ -1,116 +0,0 @@
-.highlight table td { padding: 5px; }
-.highlight table pre { margin: 0; }
-.highlight, .highlight .w {
-  color: #24292f;
-  background-color: #f6f8fa;
-}
-.highlight .k, .highlight .kd, .highlight .kn, .highlight .kp, .highlight .kr, .highlight .kt, .highlight .kv {
-  color: #cf222e;
-}
-.highlight .gr {
-  color: #f6f8fa;
-}
-.highlight .gd {
-  color: #82071e;
-  background-color: #ffebe9;
-}
-.highlight .nb {
-  color: #953800;
-}
-.highlight .nc {
-  color: #953800;
-}
-.highlight .no {
-  color: #953800;
-}
-.highlight .nn {
-  color: #953800;
-}
-.highlight .sr {
-  color: #116329;
-}
-.highlight .na {
-  color: #116329;
-}
-.highlight .nt {
-  color: #116329;
-}
-.highlight .gi {
-  color: #116329;
-  background-color: #dafbe1;
-}
-.highlight .ges {
-  font-weight: bold;
-  font-style: italic;
-}
-.highlight .kc {
-  color: #0550ae;
-}
-.highlight .l, .highlight .ld, .highlight .m, .highlight .mb, .highlight .mf, .highlight .mh, .highlight .mi, .highlight .il, .highlight .mo, .highlight .mx {
-  color: #0550ae;
-}
-.highlight .sb {
-  color: #0550ae;
-}
-.highlight .bp {
-  color: #0550ae;
-}
-.highlight .ne {
-  color: #0550ae;
-}
-.highlight .nl {
-  color: #0550ae;
-}
-.highlight .py {
-  color: #0550ae;
-}
-.highlight .nv, .highlight .vc, .highlight .vg, .highlight .vi, .highlight .vm {
-  color: #0550ae;
-}
-.highlight .o, .highlight .ow {
-  color: #0550ae;
-}
-.highlight .gh {
-  color: #0550ae;
-  font-weight: bold;
-}
-.highlight .gu {
-  color: #0550ae;
-  font-weight: bold;
-}
-.highlight .s, .highlight .sa, .highlight .sc, .highlight .dl, .highlight .sd, .highlight .s2, .highlight .se, .highlight .sh, .highlight .sx, .highlight .s1, .highlight .ss {
-  color: #0a3069;
-}
-.highlight .nd {
-  color: #8250df;
-}
-.highlight .nf, .highlight .fm {
-  color: #8250df;
-}
-.highlight .err {
-  color: #f6f8fa;
-  background-color: #82071e;
-}
-.highlight .c, .highlight .ch, .highlight .cd, .highlight .cm, .highlight .cp, .highlight .cpf, .highlight .c1, .highlight .cs {
-  color: #6e7781;
-}
-.highlight .gl {
-  color: #6e7781;
-}
-.highlight .gt {
-  color: #6e7781;
-}
-.highlight .ni {
-  color: #24292f;
-}
-.highlight .si {
-  color: #24292f;
-}
-.highlight .ge {
-  color: #24292f;
-  font-style: italic;
-}
-.highlight .gs {
-  color: #24292f;
-  font-weight: bold;
-}

data/lib/docyard/templates/markdown/getting-started.md.erb

@@ -1,40 +0,0 @@
----
-title: Getting Started
-description: Learn how to use Docyard
----
-
-# Getting Started
-
-Welcome! This guide will help you get started with Docyard.
-
-## Writing Documentation
-
-Just write markdown files in the `docs/` folder.
-
-### Frontmatter
-
-Each markdown file can have YAML frontmatter:
-
-```yaml
----
-title: Page Title
-description: Page description
----
-
-Markdown Syntax
-
-Docyard supports all standard markdown:
-
-- Bold text
-- Italic text
-- Code snippets
-- Links and images
-- Code blocks with syntax highlighting
-
-Next Steps
-
-- Add more markdown files to docs/
-- Organize files into folders
-- Customize your site with docyard.yml
-
-Happy documenting! 📚