docco 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f3ccd592996f2ebbe44ee3b9209210f2fac0772b6f8994483c6ad7d62d3db34
-  data.tar.gz: e82c79a83e7e411a8dffce764b2a16d9749be276c38f21ff00261497aaf9b326
+  metadata.gz: cc8e122cfc342c995aafcd7f252fd4bf40c40e93954b8d53893cb4b1bc542b97
+  data.tar.gz: 7559ebddafbb6294e31650ce213a3526a32ed18bd065def3b396b713898255f9
 SHA512:
-  metadata.gz: f9ca8eadfe55928385cfe667ade869202186e88a0ee3fc019d413bc73cb8fd0bf52cc789eac296554a797cd216bd0224799d9151a9e39c5c1064a37042d9e537
-  data.tar.gz: 71081172e9925c33741b4f5be2d5329f5a8fec02ad27569166b982f6a2a87b0e21451cb93921f4995b6c563c48f09d46b35a7cbe1db6e0136530551cda2c1b86
+  metadata.gz: c01036732ff4b2b6db81ae86d1794c4200590fb222d6bdaa3a72a59681032ac8a402a0afb27ce25a27cd44b5cd96adaec5b389d6ba1c3071d85789eed53e6c79
+  data.tar.gz: eb4237fe63017abaccb95faf6f2edc003ee07a8cf7fa31693af18372e9d293316a7ffdb01e046ede9db1348176eebb793daeb4d5b60001445c676ca35eea8d62

data/lib/docco/builder.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Docco
+  class Builder
+    class SectionBuilder
+      attr_reader :root, :nodes, :info, :path, :to_path, :sections
+
+      def initialize(root:, node:, path:, children:, info:)
+        @root = root
+        @node = node
+        @path = path
+        @nodes = children
+        @sections = @nodes.filter(&:section?)
+        @info = info
+        @path = [*path, node.id]
+        @to_path = @path.join('/')
+      end
+
+      def id = @node.id
+      def level = @node.level
+      def title_html = @node.title_html
+      def title = @node.title
+      def to_html = @node.to_html
+      def section? = @node.section?
+
+      def build(*args)
+        case args
+        in [template]
+          root.link self, template, to_path
+        in [String => path, template]
+          root.link self, template, path
+        end
+      end
+    end
+
+    attr_reader :nodes, :sections, :info, :root, :pages, :path, :to_path
+
+    def initialize(nodes:, info:, root: self)
+      @to_path = ''
+      @path = [@to_path].freeze
+      @nodes = nodes.map do |n|
+        wrap_node(n, @path)
+      end
+      @sections = @nodes.filter(&:section?)
+      @info = info
+      @root = root
+      @pages = {}
+    end
+
+    def root = self
+    def to_html = @nodes.reduce(+'') { |str, n| str << n.to_html }
+
+    def link(node, template, path)
+      return path if @pages.key?(path)
+
+      @pages[path] = true
+      content = template.(node)
+      @pages[path] = content
+      path
+    end
+
+    def visit(theme)
+      link self, theme, to_path
+    end
+
+    def build(*args)
+      case args
+      in [template]
+        link self, template, to_path
+      in [String => path, template]
+        link self, template, path
+      end
+    end
+
+    private
+
+    # def initialize(root:, node:, parent:, children:, info:)
+    def wrap_node(node, parent_path)
+      return node unless node.section?
+
+      children = node.nodes.map { |n| wrap_node(n, [*parent_path, node.id]) }
+      SectionBuilder.new(root: self, node:, path: parent_path, children:, info:)
+    end
+  end
+end

data/lib/docco/parser/content_node.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Docco
+  class Parser
+    class ContentNode
+      def initialize(converter, node)
+        @converter = converter
+        @node = node
+      end
+
+      def inspect = %(<#{self.class}:#{@node.type} [#{@node.children}]>)
+      def section? = false
+
+      def to_html
+        @to_html ||= @converter.convert(@node, 0)
+      end
+    end
+  end
+end

data/lib/docco/parser/root.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Docco
+  class Parser
+    class Root
+      attr_reader :nodes, :level
+
+      def initialize(converter)
+        @converter = converter
+        @nodes = []
+        @level = 0
+      end
+
+      def inspect = %(<#{self.class} [#{@nodes.size} nodes]>)
+      def section? = false
+
+      def <<(section)
+        @nodes << section
+      end
+
+      def add_content(node)
+        @nodes << ContentNode.new(@converter, node)
+      end
+
+      def to_html
+        @to_html ||= @nodes.reduce(+'') do |str, node|
+          str << node.to_html << "\n"
+        end
+      end
+    end
+  end
+end

data/lib/docco/parser/section.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Docco
+  class Parser
+    class Section
+      HEADING_EXP = /<\s*h([1-6])\b[^>]*>(.*?)<\/\s*h\1\s*>/im
+
+      attr_reader :id, :options, :nodes
+
+      def initialize(converter:, node:)
+        @converter = converter
+        @node = node
+        @id = node.attr['id']
+        @options = node.options
+        @nodes = []
+      end
+
+      def inspect = %(<#{self.class}:H#{level}##{id} [#{nodes.size} nodes]>)
+      def section? = true
+
+      def level = @options[:level]
+
+      def <<(section)
+        @nodes << section
+      end
+
+      def add_content(node)
+        @nodes << ContentNode.new(@converter, node)
+      end
+
+      def title_html
+        @to_html ||= @converter.convert(@node, 0)
+      end
+
+      def title
+        @title ||= title_html.match(HEADING_EXP)[2]
+      end
+
+      def to_html
+        @nodes.reduce(title_html) do |str, node|
+          str << "\n" << node.to_html
+        end
+      end
+    end
+  end
+end

data/lib/docco/parser.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'kramdown'
+
+module Docco
+  class Parser
+    def initialize(text, input: 'GFM')
+      @text = text
+      @input = input
+    end
+
+    def structure
+      @structure ||= build
+    end
+
+    private
+    # cc = Kramdown::Converter::Html.send(:new, doc.root, doc.options)
+    # cc.convert doc.children[0], 1 # <= 1 is indent and it's needed
+    def build
+      doc = Kramdown::Document.new(@text, input: @input, auto_ids: true)
+      converter = Kramdown::Converter::Html.send(:new, doc.root, doc.options)
+      root = Root.new(converter)
+      last_section = root
+      levels = Hash.new { |h, k| h[k] = [] }
+      levels[last_section.level] << last_section # root
+
+      doc.root.children.each do |child|
+        if child.type == :header
+          section = Section.new(converter:, node: child)
+          levels[section.level] << section
+          if (parent = levels[section.level - 1].last)
+            parent << section
+          end
+          last_section = section
+        else # not a section. Content belonging to last section, or directly to root
+          last_section.add_content child
+        end
+      end
+
+      root
+    end
+  end
+end
+
+require 'docco/parser/section'
+require 'docco/parser/root'
+require 'docco/parser/content_node'

data/lib/docco/tasks.rake

@@ -3,12 +3,6 @@
 require 'docco'
 
 namespace :docco do
-  desc 'Copy default styles.css to host library docs'
-  task :css, [:output_dir] do |t, args|
-    output_dir = args[:output_dir] || 'docs'
-    Docco::CopyStyles.(output_dir)
-  end
-
   desc 'Generate a Github Action into .github/workflows'
   task :gh do
     Docco::CopyGHAction.()

data/lib/docco/theme.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+require 'erb'
+
+module Docco
+  # Theme is a templating system that uses ERB templates with named slots.
+  # It allows you to define a base template and then create specialized
+  # versions by filling in slots with different content.
+  class Theme
+    class Static
+      def initialize(path, content)
+        @path = path
+        @content = content.respond_to?(:read) ? content : StringIO.new(content)
+      end
+    end
+
+    class Slots
+      def initialize
+        @slots = {}
+      end
+
+      def slot(name, str)
+        @slots[name] = ERB.new(str)
+      end
+
+      def to_h = @slots
+    end
+
+    # Creates a new Theme from an ERB template string.
+    #
+    # @param str [String, #read] ERB template string that defines the layout
+    # @return [Theme] a new Theme instance with the compiled template
+    #
+    # @example Create a basic layout theme
+    #   Layout = Docco::Theme.define <<~HTML
+    #     <html>
+    #       <head>
+    #         <title><%= slots[:doc_title] || 'Home' %></title>
+    #       </head>
+    #       <body>
+    #         <%= slots[:main] %>
+    #       </body>
+    #     </html>
+    #   HTML
+    #
+    # Template can also be a #read() => String interface
+    # for example a File or Pathname to read templates from disk
+    # @example
+    #   Page = Docco::Theme.define(Pathname.new('./theme/page.erb'))
+    def self.define(str)
+      str = str.read if str.respond_to?(:read)
+      tmpl = ERB.new(str)
+      new(tmpl)
+    end
+
+    def self.call(node)
+      raise NotImplementedError, "define #{self}.call(node) to delegate .call(node) to the right root template (usually the homepage)"
+    end
+
+    # Initializes a new Theme instance.
+    #
+    # @param tpl [ERB] compiled ERB template
+    # @param slots [Hash<Symbol, ERB>] hash of named slots with their ERB templates
+    # @return [Theme] a new Theme instance
+    #
+    # @example Create a theme with template and slots
+    #   tpl = ERB.new("<div><%= slots[:content] %></div>")
+    #   slots = { content: ERB.new("<p>Hello</p>") }
+    #   theme = Docco::Theme.new(tpl, slots: slots)
+    def initialize(tpl, slots: {})
+      @tpl = tpl
+      @slots = slots
+    end
+
+    # Creates a new theme by defining slots for the template.
+    # Can accept either a string (which becomes the :main slot) or a block
+    # that yields a Slots object for defining multiple slots.
+    #
+    # @param str [String, nil] optional string to use as the :main slot
+    # @yield [Slots] yields a Slots object for defining named slots
+    # @return [Theme] a new Theme instance with the defined slots
+    #
+    # @example Define a theme with a string for the main slot
+    #   HomeTemplate = Layout.define <<~HTML
+    #     <h1>Home page</h1>
+    #     <% page.sections.each do |s| %>
+    #       <%= s.title_html %>
+    #     <% end %>
+    #   HTML
+    #
+    # @example Define a theme with multiple slots using a block
+    #   PageTemplate = Layout.define do |tpl|
+    #     tpl.slot :doc_title, '<%= page.title %>'
+    #     tpl.slot :main, <<~HTML
+    #       <h1><%= page.title %></h1>
+    #       <% page.nodes.each do |n| %>
+    #         <%= n.to_html %>
+    #       <% end %>
+    #     HTML
+    #   end
+    def define(str = nil, &)
+      slots = Slots.new
+      if str
+        slots.slot(:main, str)
+      elsif block_given?
+        yield slots
+      end
+      self.class.new(@tpl, slots: slots.to_h)
+    end
+
+    Context = Data.define(:node, :slots) do
+      def page = node
+      def get_binding = binding
+    end
+
+    # Renders the theme with the given node by evaluating all slot templates
+    # and then the main template.
+    #
+    # @param node [Object] the node object to render (available as 'page' in templates)
+    # @return [String] the rendered HTML output
+    #
+    # @example Render a theme with a node
+    #   output = PageTemplate.call(node)
+    #   # => "<html><head>...</head><body>...</body></html>"
+    def call(node)
+      ctx = Context.new(node:, slots: {})
+      slots = @slots.transform_values do |tpl|
+        tpl.result(ctx.get_binding)
+      end
+      ctx = Context.new(node:, slots:)
+      @tpl.result(ctx.get_binding)
+    end
+  end
+end

data/lib/docco/{styles.css → themes/default.css}

@@ -159,6 +159,16 @@ body {
     margin: 0;
 }
 
+.nav-menu ul {
+    list-style: none;
+    padding-left: 0;
+    margin: 0;
+}
+
+.nav-menu ul li {
+    margin: 0;
+}
+
 .nav-menu a {
     display: block;
     padding: 0.625rem 1.5rem;
@@ -241,6 +251,14 @@ body {
     padding-left: calc(3.5rem - 3px);
 }
 
+/* Code in navigation */
+.nav-menu a code {
+    background-color: transparent;
+    border: none;
+    padding: 0;
+    font-size: inherit;
+}
+
 /* Main Content */
 .content {
     flex: 1;
@@ -275,6 +293,10 @@ body {
 .section {
     margin-bottom: 4rem;
 }
+.section img {
+  max-width: 100%;
+  height: auto;
+}
 
 .section h2 {
     font-size: 2rem;
@@ -401,6 +423,13 @@ pre code::-webkit-scrollbar-thumb {
     border-radius: 4px;
 }
 
+pre.mermaid {
+    background: transparent;
+    box-shadow: none;
+    padding: 0;
+    text-align: center;
+}
+
 /* Images */
 .image-container {
     margin: 2rem 0;

data/lib/docco/themes/default.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+require 'docco/theme'
+
+module Docco
+  module Themes
+    class Default < Theme
+      Styles = define(Pathname.new(File.join(__dir__, 'default.css')))
+
+      Layout = define <<~HTML
+      <!DOCTYPE html>
+      <html lang="en">
+      <head>
+          <meta charset="UTF-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1.0">
+          <title><%= page.root.info.name %> - <%= page.root.info.description %></title>
+          <link rel="stylesheet" href="<%= page.build('styles.css', Docco::Themes::Default::Styles) %>">
+          <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/atom-one-dark.min.css">
+      </head>
+      <body>
+          <nav class="top-menu">
+              <div class="top-menu-content">
+                  <div class="top-menu-brand">
+                    <span class="brand-name"><%= page.root.info.name %></span>
+                    <span class="brand-tagline"><%= page.root.info.description %></span>
+                  </div>
+                    <a href="<%= page.root.info.repo_url %>" target="_blank" class="github-link" aria-label="View on GitHub">
+                      <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="currentColor">
+                          <path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/>
+                      </svg>
+                      <span>GitHub</span>
+                  </a>
+              </div>
+          </nav>
+          <div class="container">
+              <nav class="sidebar">
+                  <div class="logo">
+                    <h2><%= page.root.info.name %></h2>
+                    <p class="tagline"><%= page.root.info.description %></p>
+                  </div>
+                  <%= Docco::Themes::Default::Menu.(page) %>
+              </nav>
+
+              <main class="content">
+                  <header class="page-header">
+                      <h1><%= page.root.info.name %></h1>
+                      <p class="subtitle"><%= page.root.info.summary %></p>
+                  </header>
+
+                  <%= slots[:main] %>
+              </main>
+          </div>
+          <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+          <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/ruby.min.js"></script>
+          <script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
+          <script>
+              document.querySelectorAll('pre > code.language-mermaid').forEach((code) => {
+                  const pre = code.parentElement;
+                  const container = document.createElement('pre');
+                  container.className = 'mermaid';
+                  container.textContent = code.textContent;
+                  pre.replaceWith(container);
+              });
+              mermaid.initialize({ startOnLoad: false, theme: 'default' });
+              mermaid.run();
+              hljs.highlightAll();
+          </script>
+          <script>
+              // Active section highlighting
+              const observerOptions = {
+                  root: null,
+                  rootMargin: '-20% 0px -60% 0px',
+                  threshold: 0
+              };
+
+              const sections = document.querySelectorAll('section, article[id]');
+              const navLinks = document.querySelectorAll('.nav-menu a');
+
+              // Create a map of href to link elements
+              const linkMap = new Map();
+              navLinks.forEach(link => {
+                  const href = link.getAttribute('href');
+                  if (href && href.startsWith('#')) {
+                      linkMap.set(href, link);
+                  }
+              });
+
+              const observer = new IntersectionObserver((entries) => {
+                  entries.forEach(entry => {
+                      if (entry.isIntersecting) {
+                          const id = entry.target.getAttribute('id');
+                          const activeLink = linkMap.get(`#${id}`);
+
+                          if (activeLink) {
+                              // Remove active class from all links
+                              navLinks.forEach(link => link.classList.remove('active'));
+                              // Add active class to current link
+                              activeLink.classList.add('active');
+
+                              // Update URL hash without scrolling
+                              if (history.replaceState) {
+                                  history.replaceState(null, null, `#${id}`);
+                              } else {
+                                  window.location.hash = id;
+                              }
+                          }
+                      }
+                  });
+              }, observerOptions);
+
+              // Observe all sections
+              sections.forEach(section => {
+                  if (section.id) {
+                      observer.observe(section);
+                  }
+              });
+          </script>
+      </body>
+      </html>
+      HTML
+
+      Menu = Theme.define <<~HTML
+      <ul class="nav-menu">
+        <% page.sections.each do |section| %>
+          <% section.sections.each do |section| %>
+            <li>
+              <a href="#<%= section.id %>"><%= section.title %></a>
+              <% if section.sections.any? %>
+                <ul>
+                  <% section.sections.each do |section| %>
+                    <li class="nav-submenu">
+                      <a href="#<%= section.id %>"><%= section.title %></a>
+                    </li>
+                  <% end %>
+                </ul>
+              <% end %>
+            </li>
+          <% end %>
+        <% end %>
+      </ul>
+      HTML
+
+      Section = Theme.define <<~HTML
+      <section id="<%= page.id %>" class="section">
+        <h2><%= page.title %></h2>
+        <% page.nodes.each do |node| %> 
+          <% if node.section? %> 
+            <article id="<%= node.id %>" class="subsection">
+              <h3><%= node.title %></h3>
+              <% node.nodes.each do |n| %>
+                <%= n.to_html %>
+              <% end %>
+            </article>
+          <% else %>
+            <%= node.to_html %>
+          <% end %>
+        <% end %>
+      </section>
+      HTML
+
+      HomePageTemplate = Layout.define <<~HTML
+      <% page.nodes.each do |node| %> 
+        <% if node.section? %> 
+          <% node.nodes.each do |node| %> 
+            <% if node.section? %> 
+              <%= Docco::Themes::Default::Section.(node) %>
+            <% else %>
+              <%= node.to_html %>
+            <% end %>
+          <% end %>
+        <% else %>
+          <%= node.to_html %>
+        <% end %>
+      <% end %>
+      HTML
+
+      def self.call(node)
+        HomePageTemplate.call(node)
+      end
+    end
+  end
+end

data/lib/docco/version.rb

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

data/lib/docco/writer.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+module Docco
+  # Writes documents to the file system.
+  #
+  # The Writer class handles writing page content to disk with proper directory creation,
+  # path handling, and optional overwrite protection. It transforms logical page paths
+  # into actual file system paths, appending 'index.html' to directory paths as needed.
+  #
+  # @example Writing pages to output directory
+  #   pages = {
+  #     '' => '<html>Home</html>',
+  #     '/docs' => '<html>Docs</html>',
+  #     '/styles.css' => 'body { color: red; }'
+  #   }
+  #   writer = Docco::Writer.new(pages, output_dir: 'output', overwrite: false)
+  #   report = writer.write
+  #
+  # The above example writes the following files:
+  #   output/index.html
+  #   output/docs/index.html
+  #   output/styles.css
+  #
+  class Writer
+    # Initializes a new Writer instance with pages and output configuration.
+    #
+    # Transforms page paths by:
+    # - Converting relative paths to absolute paths within output_dir
+    # - Appending 'index.html' to paths without file extensions (directory paths)
+    # - Creating Pathname objects for each path
+    #
+    # @param pages [Hash<String, String>] Hash of page paths to content strings.
+    #   Keys are logical page paths (e.g., '', '/docs', '/assets/style.css').
+    #   Values are the content to write to those files.
+    #
+    # @param output_dir [String] The root directory where pages will be written.
+    #   All page paths will be relative to this directory.
+    #
+    # @param overwrite [Boolean] Whether to overwrite existing files.
+    #   If false (default), existing files will not be modified.
+    #   If true, existing files will be overwritten with new content.
+    #
+    # @example
+    #   writer = Docco::Writer.new(
+    #     { '' => 'Home', '/docs' => 'Documentation' },
+    #     output_dir: 'output',
+    #     overwrite: false
+    #   )
+    def initialize(pages, output_dir:, overwrite: false)
+      @pages = pages.transform_keys do |path|
+        path = Pathname.new(File.join(output_dir, path))
+        path += 'index.html' if path.extname.empty?
+        path
+      end
+
+      @overwrite = overwrite
+    end
+
+    def write
+      @pages.each.with_object({}) do |(path, content), memo|
+        memo[path.to_s] = write_page(path, content)
+      end
+    end
+
+    private def write_page(path, content)
+      return false if !@overwrite && path.exist?
+
+      path.dirname.mkpath
+      path.write(content)
+    end
+  end
+end

data/lib/docco.rb

@@ -1,8 +1,11 @@
 # frozen_string_literal: true
 
-require 'kramdown'
 require 'fileutils'
 require_relative "docco/version"
+require_relative "docco/parser"
+require_relative "docco/builder"
+require_relative "docco/writer"
+require_relative "docco/themes/default"
 
 module Docco
   STYLES = 'styles.css'
@@ -17,46 +20,39 @@ module Docco
     puts "Github action copied to #{destination}"
   end
 
-  CopyStyles = proc do |output_dir|
-    FileUtils.mkdir_p(output_dir)
-    source = File.join(__dir__, 'docco', STYLES)
-    destination = File.join(output_dir, STYLES)
-    FileUtils.cp(source, destination)
-    puts "Docco styles copied to #{destination}"
+  def self.parse(text)
+    parser = Parser.new(text)
+    parser.structure
+  end
+
+  def self.write(pages, output_dir:, overwrite: false)
+    writer = Writer.new(pages, output_dir:, overwrite:)
+    writer.write
   end
 
+  Info = Data.define(:name, :summary, :description, :repo_url)
+
   class DocsBuilder
     def initialize(readme_path:, output_dir:, gemspec_path: nil)
       @readme_path = readme_path
       @output_dir = output_dir
-      @sections = []
-      @gemspec_path = gemspec_path || find_gemspec
-      load_gemspec_info
+      @info = load_gemspec_info(gemspec_path || find_gemspec)
     end
 
-    def build
-      css = File.join(@output_dir, STYLES)
-      if !File.exist?(css)
-        CopyStyles.(@output_dir)
-      end
-
+    def build(overwrite: false)
       puts "Reading #{@readme_path}..."
       markdown = File.read(@readme_path)
 
       puts "Parsing markdown..."
-      doc = Kramdown::Document.new(markdown, input: 'GFM', auto_ids: true)
-
-      puts "Extracting structure..."
-      extract_structure(doc.root)
+      root = Docco.parse(markdown)
 
-      puts "Generating HTML..."
-      html = generate_html(doc)
+      builder = Docco::Builder.new(nodes: root.nodes, info: @info)
 
-      puts "Writing to #{@output_dir}/index.html..."
-      FileUtils.mkdir_p(@output_dir)
-      File.write(File.join(@output_dir, 'index.html'), html)
-
-      puts "Done! Documentation built successfully."
+      builder.visit(Docco::Themes::Default)
+      report = Docco.write(builder.pages, output_dir: @output_dir, overwrite:)
+      report.each do |path, written|
+        puts "Wrote file #{path}" if written
+      end
     end
 
     private
@@ -74,20 +70,22 @@ module Docco
       end
     end
 
-    def load_gemspec_info
-      if @gemspec_path && File.exist?(@gemspec_path)
-        spec = Gem::Specification.load(@gemspec_path)
-        @gem_name = spec.name
-        @gem_summary = spec.summary
-        @gem_description = spec.description
-        # Prefer source_code_uri from metadata, fall back to homepage
-        @github_url = spec.metadata['source_code_uri'] || spec.homepage
+    def load_gemspec_info(gemspec_path)
+      if gemspec_path && File.exist?(gemspec_path)
+        spec = Gem::Specification.load(gemspec_path)
+        Info.new(
+          name: spec.name,
+          summary: spec.summary,
+          description: spec.description,
+          repo_url: spec.metadata['source_code_uri'] || spec.homepage
+        )
       else
-        # Fallback values if no gemspec found
-        @gem_name = 'Documentation'
-        @gem_summary = 'Project Documentation'
-        @gem_description = 'Project Documentation'
-        @github_url = ''
+        Info.new(
+          name: 'Documentation',
+          summary: 'Project docs',
+          description: 'Project docs',
+          repo_url: nil
+        )
       end
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docco
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ismael Celis
@@ -45,15 +45,24 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/docco.rb
+- lib/docco/builder.rb
 - lib/docco/deploy-docs.yml
-- lib/docco/styles.css
+- lib/docco/parser.rb
+- lib/docco/parser/content_node.rb
+- lib/docco/parser/root.rb
+- lib/docco/parser/section.rb
 - lib/docco/tasks.rake
 - lib/docco/tasks.rb
+- lib/docco/theme.rb
+- lib/docco/themes/default.css
+- lib/docco/themes/default.rb
 - lib/docco/version.rb
-homepage: https://github.com/ismasan/docco
+- lib/docco/writer.rb
+homepage: https://ismasan.github.io/docco
 licenses: []
 metadata:
-  homepage_uri: https://github.com/ismasan/docco
+  homepage_uri: https://ismasan.github.io/docco
+  source_code_uri: https://github.com/ismasan/docco
 post_install_message: |2+
 
   +----------------------------+
@@ -64,7 +73,7 @@ post_install_message: |2+
 
     Now you can run `bundle exec rake docco:docs` to generate HTML docs from your README.md and .gemspec
 
-    You can also run `bundle exec rake docco:gh` to add a Github action to generate docs to Github Pages on deply.
+    You can also run `bundle exec rake docco:gh` to add a Github action to generate docs to Github Pages on deploy.
   +-----------------------------+
 
 rdoc_options: []
@@ -81,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.8
 specification_version: 4
 summary: Builds static HTML documentation from a Ruby gem's README
 test_files: []