docyard 0.7.0 → 0.9.0

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

@@ -2,9 +2,7 @@
   <div class="search-modal-backdrop" data-search-backdrop></div>
   <div class="search-modal-container">
     <div class="search-modal-header">
-      <svg class="search-modal-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor" aria-hidden="true">
-        <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"></path>
-      </svg>
+      <span class="search-modal-icon"><%= icon(:magnifying_glass) %></span>
       <input
         type="text"
         class="search-modal-input"
@@ -26,9 +24,7 @@
       </div>
 
       <div class="search-modal-empty" data-search-empty hidden>
-        <svg class="search-empty-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor">
-          <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"></path>
-        </svg>
+        <span class="search-empty-icon"><%= icon(:magnifying_glass) %></span>
         <span class="search-empty-title">No results found</span>
         <span class="search-empty-hint">Try different keywords or check your spelling</span>
       </div>

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

@@ -6,16 +6,12 @@
   data-search-trigger
 >
   <span class="search-trigger-icon" aria-hidden="true">
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor">
-      <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"></path>
-    </svg>
+    <%= icon(:magnifying_glass) %>
   </span>
   <span class="search-trigger-text">Search...</span>
   <kbd class="search-trigger-shortcut" data-search-shortcut>
     <span class="search-trigger-shortcut-icon" aria-hidden="true">
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor">
-        <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"></path>
-      </svg>
+      <%= icon(:command) %>
     </span>
     <span class="search-trigger-shortcut-text">K</span>
   </kbd>

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

@@ -1,6 +1,23 @@
 <aside class="sidebar" role="navigation" aria-label="Documentation navigation">
-  <nav>
-    <%= @nav_content %>
-  </nav>
-  <%= @footer_html %>
+  <% if @header_ctas&.any? %>
+  <div class="sidebar-ctas">
+    <% @header_ctas.sort_by { |cta| cta[:variant] == 'secondary' ? 0 : 1 }.each do |cta| %>
+    <a href="<%= cta[:external] ? cta[:href] : link_path(cta[:href]) %>"
+       class="sidebar-cta sidebar-cta--<%= cta[:variant] || 'primary' %>"
+       <%= 'target="_blank" rel="noopener noreferrer"' if cta[:external] %>>
+      <%= cta[:text] %>
+      <% if cta[:variant] != 'secondary' %>
+      <svg class="sidebar-cta-arrow" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M9 5l7 7-7 7"/>
+      </svg>
+      <% end %>
+    </a>
+    <% end %>
+  </div>
+  <% end %>
+  <div class="sidebar-scroll">
+    <nav>
+      <%= @nav_content %>
+    </nav>
+  </div>
 </aside>

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

@@ -0,0 +1,14 @@
+<div class="docyard-step<%= ' docyard-step--last' if @is_last %>">
+  <div class="docyard-step__indicator">
+    <span class="docyard-step__number"><%= @number %></span>
+    <% unless @is_last %><div class="docyard-step__connector"></div><% end %>
+  </div>
+  <div class="docyard-step__content">
+    <h3 class="docyard-step__title"><%= @title %></h3>
+    <% unless @content_html.empty? %>
+    <div class="docyard-step__body">
+      <%= @content_html %>
+    </div>
+    <% end %>
+  </div>
+</div>

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

@@ -0,0 +1,25 @@
+<% if @has_tabs && @tabs&.any? %>
+<nav class="tab-bar" aria-label="Main navigation">
+  <div class="tab-bar-content">
+    <% @tabs.each do |tab| %>
+    <a href="<%= tab[:external] ? tab[:href] : link_path(tab[:href]) %>"
+       class="tab-item<%= ' is-active' if tab[:active] %>"
+       <%= 'target="_blank" rel="noopener noreferrer"' if tab[:external] %>
+       data-tab-href="<%= tab[:href] %>">
+      <% if tab[:icon] %>
+      <span class="tab-icon"><%= icon(tab[:icon]) %></span>
+      <% end %>
+      <span><%= tab[:text] %></span>
+      <% if tab[:external] %>
+      <svg class="tab-external-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path>
+        <polyline points="15 3 21 3 21 9"></polyline>
+        <line x1="10" y1="14" x2="21" y2="3"></line>
+      </svg>
+      <% end %>
+    </a>
+    <% end %>
+    <div class="tab-indicator" id="tabIndicator"></div>
+  </div>
+</nav>
+<% end %>

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

@@ -1,14 +1,13 @@
 <% unless @toc.empty? %>
-  <aside class="docyard-toc" aria-label="Table of contents">
-    <div class="docyard-toc__header">
-      <h2 class="docyard-toc__title">
-        <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" fill="currentColor" viewBox="0 0 256 256" aria-hidden="true">
-          <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"/>
-        </svg>
-        On this page
-      </h2>
-    </div>
-    <nav id="toc-content" class="docyard-toc__nav">
+  <div class="docyard-toc" role="complementary" aria-label="Table of contents">
+    <div class="docyard-toc__scroll">
+      <div class="docyard-toc__header">
+        <h2 class="docyard-toc__title">
+          <%= icon(:table) %>
+          On this page
+        </h2>
+      </div>
+      <nav id="toc-content" class="docyard-toc__nav">
       <ul class="docyard-toc__list">
         <% @toc.each do |heading| %>
           <li class="docyard-toc__item docyard-toc__item--level-<%= heading[:level] %>">
@@ -40,6 +39,7 @@
           </li>
         <% end %>
       </ul>
-    </nav>
-  </aside>
+      </nav>
+    </div>
+  </div>
 <% end %>

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

@@ -1,8 +1,6 @@
 <% unless @toc.empty? %>
   <button class="secondary-header-toc-toggle" aria-expanded="false" aria-controls="toc-content" aria-label="Toggle table of contents">
     <span>On this page</span>
-    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 256 256" fill="currentColor" aria-hidden="true">
-      <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"/>
-    </svg>
+    <%= icon(:caret_down) %>
   </button>
 <% end %>

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

@@ -13,9 +13,9 @@
           <% if tab[:icon] %>
             <span class="docyard-tabs__icon">
               <% if tab[:icon_source] == "file-extension" %>
-                <%= Docyard::Icons.render_file_extension(tab[:icon]) %>
+                <%= icon_file_extension(tab[:icon]) %>
               <% elsif tab[:icon_source] == "phosphor" %>
-                <%= Docyard::Icons.render(tab[:icon]) %>
+                <%= icon(tab[:icon]) %>
               <% end %>
             </span>
           <% end %>

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

@@ -1,13 +1,4 @@
 <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>
+  <span class="theme-toggle-sun"><%= icon(:sun) %></span>
+  <span class="theme-toggle-moon"><%= icon(:moon_stars) %></span>
 </button>

data/lib/docyard/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docyard
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Sanif Himani
@@ -191,17 +191,29 @@ files:
 - lib/docyard/cli.rb
 - lib/docyard/components/aliases.rb
 - lib/docyard/components/base_processor.rb
+- lib/docyard/components/processors/abbreviation_processor.rb
+- lib/docyard/components/processors/accordion_processor.rb
+- lib/docyard/components/processors/badge_processor.rb
 - lib/docyard/components/processors/callout_processor.rb
+- lib/docyard/components/processors/cards_processor.rb
 - lib/docyard/components/processors/code_block_diff_preprocessor.rb
 - lib/docyard/components/processors/code_block_focus_preprocessor.rb
 - lib/docyard/components/processors/code_block_options_preprocessor.rb
 - lib/docyard/components/processors/code_block_processor.rb
+- lib/docyard/components/processors/code_group_processor.rb
 - lib/docyard/components/processors/code_snippet_import_preprocessor.rb
+- lib/docyard/components/processors/custom_anchor_processor.rb
+- lib/docyard/components/processors/file_tree_processor.rb
 - lib/docyard/components/processors/heading_anchor_processor.rb
 - lib/docyard/components/processors/icon_processor.rb
+- lib/docyard/components/processors/image_caption_processor.rb
+- lib/docyard/components/processors/include_processor.rb
+- lib/docyard/components/processors/steps_processor.rb
 - lib/docyard/components/processors/table_of_contents_processor.rb
 - lib/docyard/components/processors/table_wrapper_processor.rb
 - lib/docyard/components/processors/tabs_processor.rb
+- lib/docyard/components/processors/tooltip_processor.rb
+- lib/docyard/components/processors/video_embed_processor.rb
 - lib/docyard/components/registry.rb
 - lib/docyard/components/support/code_block/feature_extractor.rb
 - lib/docyard/components/support/code_block/icon_detector.rb
@@ -209,22 +221,35 @@ files:
 - lib/docyard/components/support/code_block/line_wrapper.rb
 - lib/docyard/components/support/code_block/patterns.rb
 - lib/docyard/components/support/code_detector.rb
+- lib/docyard/components/support/code_group/html_builder.rb
+- lib/docyard/components/support/markdown_code_block_helper.rb
 - lib/docyard/components/support/tabs/icon_detector.rb
 - lib/docyard/components/support/tabs/parser.rb
 - lib/docyard/components/support/tabs/range_finder.rb
 - lib/docyard/config.rb
 - lib/docyard/config/branding_resolver.rb
 - lib/docyard/config/constants.rb
+- lib/docyard/config/logo_detector.rb
 - lib/docyard/config/validator.rb
 - lib/docyard/initializer.rb
+- lib/docyard/navigation/breadcrumb_builder.rb
 - lib/docyard/navigation/prev_next_builder.rb
+- lib/docyard/navigation/sidebar/children_discoverer.rb
 - lib/docyard/navigation/sidebar/config_parser.rb
+- lib/docyard/navigation/sidebar/file_resolver.rb
 - lib/docyard/navigation/sidebar/file_system_scanner.rb
 - lib/docyard/navigation/sidebar/item.rb
+- lib/docyard/navigation/sidebar/local_config_loader.rb
+- lib/docyard/navigation/sidebar/metadata_extractor.rb
+- lib/docyard/navigation/sidebar/metadata_reader.rb
+- lib/docyard/navigation/sidebar/path_prefixer.rb
 - lib/docyard/navigation/sidebar/renderer.rb
+- lib/docyard/navigation/sidebar/sorter.rb
 - lib/docyard/navigation/sidebar/title_extractor.rb
 - lib/docyard/navigation/sidebar/tree_builder.rb
+- lib/docyard/navigation/sidebar/tree_filter.rb
 - lib/docyard/navigation/sidebar_builder.rb
+- lib/docyard/rendering/icon_helpers.rb
 - lib/docyard/rendering/icons.rb
 - lib/docyard/rendering/icons/LICENSE.phosphor
 - lib/docyard/rendering/icons/file_types.rb
@@ -232,28 +257,47 @@ files:
 - lib/docyard/rendering/language_mapping.rb
 - lib/docyard/rendering/markdown.rb
 - lib/docyard/rendering/renderer.rb
+- lib/docyard/rendering/template_resolver.rb
+- lib/docyard/routing/fallback_resolver.rb
 - lib/docyard/search/build_indexer.rb
 - lib/docyard/search/dev_indexer.rb
 - lib/docyard/search/pagefind_support.rb
 - lib/docyard/server/asset_handler.rb
 - lib/docyard/server/dev_server.rb
 - lib/docyard/server/file_watcher.rb
+- lib/docyard/server/pagefind_handler.rb
 - lib/docyard/server/preview_server.rb
 - lib/docyard/server/rack_application.rb
 - lib/docyard/server/resolution_result.rb
 - lib/docyard/server/router.rb
 - lib/docyard/templates/assets/css/code.css
+- lib/docyard/templates/assets/css/components/abbreviation.css
+- lib/docyard/templates/assets/css/components/accordion.css
+- lib/docyard/templates/assets/css/components/badges.css
+- lib/docyard/templates/assets/css/components/banner.css
+- lib/docyard/templates/assets/css/components/breadcrumbs.css
 - lib/docyard/templates/assets/css/components/callout.css
+- lib/docyard/templates/assets/css/components/cards.css
 - lib/docyard/templates/assets/css/components/code-block.css
+- lib/docyard/templates/assets/css/components/code-group.css
+- lib/docyard/templates/assets/css/components/figure.css
+- lib/docyard/templates/assets/css/components/file-tree.css
 - lib/docyard/templates/assets/css/components/heading-anchor.css
 - lib/docyard/templates/assets/css/components/icon.css
+- lib/docyard/templates/assets/css/components/lightbox.css
 - lib/docyard/templates/assets/css/components/logo.css
+- lib/docyard/templates/assets/css/components/nav-menu.css
 - lib/docyard/templates/assets/css/components/navigation.css
 - lib/docyard/templates/assets/css/components/prev-next.css
 - lib/docyard/templates/assets/css/components/search.css
+- lib/docyard/templates/assets/css/components/steps.css
+- lib/docyard/templates/assets/css/components/tab-bar.css
 - lib/docyard/templates/assets/css/components/table-of-contents.css
 - lib/docyard/templates/assets/css/components/tabs.css
 - lib/docyard/templates/assets/css/components/theme-toggle.css
+- lib/docyard/templates/assets/css/components/tooltip.css
+- lib/docyard/templates/assets/css/components/video.css
+- lib/docyard/templates/assets/css/landing.css
 - lib/docyard/templates/assets/css/layout.css
 - lib/docyard/templates/assets/css/main.css
 - lib/docyard/templates/assets/css/markdown.css
@@ -261,12 +305,21 @@ files:
 - lib/docyard/templates/assets/css/typography.css
 - lib/docyard/templates/assets/css/variables.css
 - lib/docyard/templates/assets/favicon.svg
+- lib/docyard/templates/assets/fonts/Inter-Variable.ttf
+- lib/docyard/templates/assets/js/components/abbreviation.js
+- lib/docyard/templates/assets/js/components/banner.js
 - lib/docyard/templates/assets/js/components/code-block.js
+- lib/docyard/templates/assets/js/components/code-group.js
+- lib/docyard/templates/assets/js/components/file-tree.js
 - lib/docyard/templates/assets/js/components/heading-anchor.js
+- lib/docyard/templates/assets/js/components/lightbox.js
 - lib/docyard/templates/assets/js/components/navigation.js
 - lib/docyard/templates/assets/js/components/search.js
+- lib/docyard/templates/assets/js/components/sidebar-toggle.js
+- lib/docyard/templates/assets/js/components/tab-navigation.js
 - lib/docyard/templates/assets/js/components/table-of-contents.js
 - lib/docyard/templates/assets/js/components/tabs.js
+- lib/docyard/templates/assets/js/components/tooltip.js
 - lib/docyard/templates/assets/js/reload.js
 - lib/docyard/templates/assets/js/theme.js
 - lib/docyard/templates/assets/logo-dark.svg
@@ -275,25 +328,37 @@ files:
 - 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/installation.md.erb
-- lib/docyard/templates/markdown/guides/configuration.md.erb
-- lib/docyard/templates/markdown/guides/markdown-features.md.erb
-- lib/docyard/templates/markdown/index.md.erb
+- lib/docyard/templates/layouts/splash.html.erb
+- lib/docyard/templates/partials/_accordion.html.erb
+- lib/docyard/templates/partials/_banner.html.erb
+- lib/docyard/templates/partials/_breadcrumbs.html.erb
 - lib/docyard/templates/partials/_callout.html.erb
+- lib/docyard/templates/partials/_card.html.erb
 - lib/docyard/templates/partials/_code_block.html.erb
+- lib/docyard/templates/partials/_doc_footer.html.erb
+- lib/docyard/templates/partials/_features.html.erb
+- lib/docyard/templates/partials/_footer.html.erb
+- lib/docyard/templates/partials/_head.html.erb
+- lib/docyard/templates/partials/_header.html.erb
 - lib/docyard/templates/partials/_heading_anchor.html.erb
+- lib/docyard/templates/partials/_hero.html.erb
 - lib/docyard/templates/partials/_icon.html.erb
 - lib/docyard/templates/partials/_icon_file_extension.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_menu.html.erb
+- lib/docyard/templates/partials/_nav_nested_section.html.erb
 - lib/docyard/templates/partials/_nav_section.html.erb
 - lib/docyard/templates/partials/_prev_next.html.erb
+- lib/docyard/templates/partials/_scripts.html.erb
 - lib/docyard/templates/partials/_search_modal.html.erb
 - lib/docyard/templates/partials/_search_trigger.html.erb
 - lib/docyard/templates/partials/_sidebar.html.erb
 - lib/docyard/templates/partials/_sidebar_footer.html.erb
+- lib/docyard/templates/partials/_step.html.erb
+- lib/docyard/templates/partials/_tab_bar.html.erb
 - lib/docyard/templates/partials/_table_of_contents.html.erb
 - lib/docyard/templates/partials/_table_of_contents_toggle.html.erb
 - lib/docyard/templates/partials/_tabs.html.erb

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

@@ -1,77 +0,0 @@
-# Installation
-
-Get your documentation site up and running in minutes.
-
-## Prerequisites
-
-::: note Requirements
-- Ruby 3.0 or higher
-- Bundler (optional, for Gemfile-based projects)
-:::
-
-Check your Ruby version:
-
-```bash
-ruby --version
-```
-
-## Install Docyard
-
-:::tabs
-== Gem Install
-```bash
-gem install docyard
-```
-
-== Bundler
-Add to your `Gemfile`:
-
-```ruby
-gem 'docyard'
-```
-
-Then install:
-
-```bash
-bundle install
-```
-:::
-
-## Verify Installation
-
-Check that Docyard was installed successfully:
-
-```bash
-docyard version
-```
-
-## Quick Start
-
-Initialize a new documentation project:
-
-```bash
-# Create new project
-docyard init
-
-# Start development server
-docyard serve
-```
-
-Visit [http://localhost:4200](http://localhost:4200) to see your documentation.
-
-## Available Commands
-
-| Command | Description |
-|---------|-------------|
-| `docyard init` | Initialize a new documentation project |
-| `docyard serve` | Start development server with hot reload |
-| `docyard build` | Build static site for production |
-| `docyard preview` | Preview production build locally |
-
-## Next Steps
-
-::: tip What's Next?
-- Explore [Markdown Features](../guides/markdown-features) to see what you can do
-- Learn about [Configuration](../guides/configuration) options
-- Start writing your documentation!
-:::

data/lib/docyard/templates/markdown/guides/configuration.md.erb

@@ -1,202 +0,0 @@
-# Configuration
-
-Customize your documentation site with `docyard.yml`.
-
-## Getting Started
-
-Docyard works without any configuration, but you can customize it by creating a `docyard.yml` file in your project root.
-
-::: tip
-The `docyard init` command creates a `docyard.yml` file with helpful examples.
-:::
-
-## Basic Configuration
-
-```yaml
-site:
-  title: "My Documentation"
-  description: "Documentation for my project"
-```
-
-## Branding
-
-### Custom Logo
-
-Add your own logo:
-
-```yaml
-branding:
-  logo: "assets/logo.svg"           # Light mode logo
-  logo_dark: "assets/logo-dark.svg" # Dark mode logo (optional)
-  favicon: "assets/favicon.svg"      # Browser tab icon
-```
-
-::: note File Paths
-- Paths are relative to the `docs/` directory
-- Or use full URLs: `https://cdn.example.com/logo.svg`
-- Supported formats: SVG, PNG, JPG
-:::
-
-### Logo Visibility
-
-Control what appears in the header:
-
-```yaml
-branding:
-  appearance:
-    logo: true   # Show/hide logo
-    title: true  # Show/hide site title
-```
-
-## Sidebar Navigation
-
-Customize the sidebar structure and order:
-
-```yaml
-sidebar:
-  items:
-    # Simple page reference
-    - installation
-
-    # Page with custom text
-    - quick-start:
-        text: "Quick Start Guide"
-
-    # Page with icon
-    - configuration:
-        text: "Configuration"
-        icon: "gear"
-
-    # Nested group
-    - guides:
-        text: "User Guides"
-        icon: "book-open"
-        items:
-          - markdown-features
-          - customization
-
-    # External link
-    - text: "GitHub"
-      link: "https://github.com/yourusername/yourproject"
-      icon: "github-logo"
-      target: "_blank"
-```
-
-::: tip Icons
-Browse available icons at [phosphoricons.com](https://phosphoricons.com). Just use the icon name (e.g., `rocket-launch`, `book-open`).
-:::
-
-### Collapsible Groups
-
-Control whether groups start expanded or collapsed:
-
-```yaml
-sidebar:
-  items:
-    - api:
-        text: "API Reference"
-        collapsed: true  # Start collapsed
-        items:
-          - authentication
-          - endpoints
-          - errors
-```
-
-## Build Configuration
-
-Configure the build output:
-
-```yaml
-build:
-  output_dir: "dist"      # Output directory for built site
-  base_url: "/"           # Base URL for deployment
-  clean: true             # Clean output directory before building
-```
-
-### Base URL
-
-Set the base URL for subdirectory deployments:
-
-```yaml
-build:
-  base_url: "/docs/"  # For example.com/docs/
-```
-
-::: warning Base URL
-If deploying to a subdirectory, make sure base_url matches your deployment path. Otherwise assets won't load correctly.
-:::
-
-## Complete Example
-
-Here's a full configuration file:
-
-```yaml
-site:
-  title: "Acme API Documentation"
-  description: "Official API documentation for Acme"
-
-branding:
-  logo: "assets/logo.svg"
-  logo_dark: "assets/logo-dark.svg"
-  favicon: "assets/favicon.svg"
-  appearance:
-    logo: true
-    title: true
-
-sidebar:
-  items:
-    - index
-
-    - getting-started:
-        text: "Getting Started"
-        icon: "rocket-launch"
-        items:
-          - installation
-          - authentication
-          - quick-start
-
-    - guides:
-        text: "Guides"
-        icon: "book-open"
-        items:
-          - making-requests
-          - error-handling
-          - rate-limiting
-
-    - api:
-        text: "API Reference"
-        icon: "code"
-        collapsed: false
-        items:
-          - users
-          - products
-          - orders
-
-    - text: "GitHub"
-      link: "https://github.com/acme/api"
-      icon: "github-logo"
-      target: "_blank"
-
-build:
-  output_dir: "dist"
-  base_url: "/api/"
-  clean: true
-```
-
-## Configuration Tips
-
-::: tip Best Practices
-1. **Start simple** - Add configuration as you need it
-2. **Use icons consistently** - Pick a set and stick with it
-3. **Organize logically** - Group related pages together
-4. **Test base_url** - Preview with `docyard preview` before deploying
-5. **Keep it maintainable** - Don't over-configure
-:::
-
-## Next Steps
-
-::: note
-- Learn about [markdown features](markdown-features)
-- Check the [installation guide](../getting-started/installation)
-- Start customizing your site!
-:::