scriptorium 0.6.1 → 0.7.2

data/lib/scriptorium/view.rb

@@ -1,5 +1,4 @@
 require 'fileutils'
-require_relative 'syntax_highlighter'
 
 class Scriptorium::View
   include Scriptorium::Exceptions
@@ -25,10 +24,14 @@ class Scriptorium::View
   end
 
   def initialize(name, title, subtitle = "", theme = "standard")
-    assume { name.is_a?(String) }
-    assume { title.is_a?(String) }
-    assume { subtitle.is_a?(String) }
-    assume { theme.is_a?(String) }
+    msg = "name must be a String, got #{name.class}"
+    assume(msg) { name.is_a?(String) }
+    msg = "title must be a String, got #{title.class}"
+    assume(msg) { title.is_a?(String) }
+    msg = "subtitle must be a String, got #{subtitle.class}"
+    assume(msg) { subtitle.is_a?(String) }
+    msg = "theme must be a String, got #{theme.class}"
+    assume(msg) { theme.is_a?(String) }
     
     validate_name(name)
     validate_title(title)
@@ -50,46 +53,21 @@ class Scriptorium::View
   end
 
   private def validate_name(name)
-    raise CannotCreateViewNameNil if name.nil?
+    raise ViewNameNil if name.nil?
     
-    raise CannotCreateViewNameEmpty if name.to_s.strip.empty?
+    raise ViewNameEmpty if name.to_s.strip.empty?
     
     unless name.match?(/^[a-zA-Z0-9_-]+$/)
-      raise CannotCreateViewNameInvalid(name)
+      raise ViewNameInvalid(name)
     end
   end
 
   private def validate_title(title)
-    raise CannotCreateViewTitleNil if title.nil?
+    raise ViewTitleNil if title.nil?
     
-    raise CannotCreateViewTitleEmpty if title.to_s.strip.empty?
+    raise ViewTitleEmpty if title.to_s.strip.empty?
   end
 
-=begin
-1. The theme provides layout/config/header.txt with default content instructions.
-2. When the theme is applied, header.txt is copied to views/VIEW/config/.
-3. A placeholder layout/header.html is created in views/VIEW/layout/ with <!-- HEADER CONTENT -->.
-4. The file views/VIEW/config/header.txt is parsed to generate actual HTML.
-5. That HTML replaces the placeholder and is written to views/VIEW/output/panes/header.html.
-6. Later, output/panes/header.html is included when assembling views/VIEW/output/index.html.
-
-That process is clean and logical. I see only minor points worth considering:
-
-Copying header.txt from theme to view config/ is irreversible by design—once copied, 
-any theme updates won’t affect the view’s header.txt. That’s good for isolation, but 
-it might be worth exposing a way to “reapply” or “sync” a theme’s layout/config/ 
-if desired.
-Placeholder files like layout/header.html in layout/ may be unnecessary once 
-output/panes/header.html is reliably generated. If they exist solely for the 
-<!-- CONTENT --> tags, consider templating that in-memory instead.
-You may want to enforce (or warn) if config/header.txt is missing or invalid 
-at generation time, to catch misconfigured views.
-If you add more optional components (like navbars, banners, etc.), consider 
-adding light validation or doc comments to header.txt to aid future users/editors.
-
-But overall, the process is robust and well thought-out. No major changes needed.
-=end
-
   def read_layout
     layout_file = @dir/:config/"layout.txt"
     
@@ -114,7 +92,7 @@ But overall, the process is robust and well thought-out. No major changes needed
     return unless File.exist?(layout_file)
 
     flexing = {
-      header: %[id="header" class="header" style="padding: 10px;"],
+      header: %[id="header" class="header" style="padding: 10px; width: 100%; box-sizing: border-box;"],
       footer: %[class="footer" style="background: lightgray; padding: 10px;"],
       left:   %[class="left" style="width: %{width}; background: #f0f0f0; padding: 10px; flex-grow: 0; flex-shrink: 0;"],
       right:  %[class="right" style="width: %{width}; background: #f0f0f0; padding: 10px; flex-grow: 0; flex-shrink: 0;"],
@@ -155,7 +133,8 @@ But overall, the process is robust and well thought-out. No major changes needed
 
   def apply_theme(theme)
     check_invariants
-    assume { theme.is_a?(String) && !theme.empty? }
+    msg = "theme must be a non-empty String, got #{theme.class} (#{theme.inspect})"
+    assume(msg) { theme.is_a?(String) && !theme.empty? }
     
     # check to see if ever done before?
     # copy layout.txt to view
@@ -204,7 +183,6 @@ But overall, the process is robust and well thought-out. No major changes needed
 
   def section_core(section, hash)
     cfg = @dir/:config
-    template = @dir/:layout/"#{section}.html"
     sectxt = cfg/"#{section}.txt"
     
     # Only add placeholder if section has no real content
@@ -246,7 +224,6 @@ write output:      write the result to output/panes/header.html
 =end
 
   def build_section(section, hash2 = {}, args = "")
-    config = @dir/:config/"#{section}.txt"
     template = @dir/:layout/"#{section}.html"
     output = @dir/:output/:panes/"#{section}.html"
     
@@ -265,11 +242,7 @@ write output:      write the result to output/panes/header.html
     target = content_tag(section)
     temp_txt.sub!(target, core)
     
-    begin
-      write_file(output, temp_txt)
-    rescue Errno::EACCES, Errno::ENOSPC => e
-      raise SectionOutputError(output, section, e.message)
-    end
+    write_file(output, temp_txt)
     
     html = read_file(output)
     html
@@ -292,26 +265,13 @@ write output:      write the result to output/panes/header.html
 
   def build_banner(arg)
     # Check if this is an SVG banner request
-    return build_banner_svg_from_file if arg == "svg"
+    return build_banner_svg("svg") if arg == "svg"
     
     # Otherwise, treat as image filename
     return build_banner_image(arg)
   end
 
-  def build_banner_svg_from_file
-    bsvg = Scriptorium::BannerSVG.new(@title, @subtitle)
-    
-    # Look for svg.txt file in the view's config directory
-    svg_config_file = @dir/:config/"svg.txt"
-    if File.exist?(svg_config_file)
-      bsvg.parse_header_svg(svg_config_file)
-    else
-      # No svg.txt file, use defaults
-      bsvg.parse_header_svg
-    end
-    
-    bsvg.get_svg
-  end
+
 
   def build_banner_image(image_filename)
     # Search for image in multiple locations
@@ -360,16 +320,16 @@ write output:      write the result to output/panes/header.html
   def build_banner_svg(arg)
     bsvg = Scriptorium::BannerSVG.new(@title, @subtitle)
     
-    # Look for config file in the view's config directory
-    config_file = @dir/:config/"config.txt"
-    if File.exist?(config_file)
-      bsvg.parse_header_svg(config_file)
+    # Look for svg.txt file in the view's config directory
+    svg_config_file = @dir/:config/"svg.txt"
+    if File.exist?(svg_config_file)
+      bsvg.parse_header_svg(svg_config_file)
     else
-      # No config file, just use defaults
+      # No svg.txt file, just use defaults
       bsvg.parse_header_svg
     end
     
-    code = bsvg.get_svg
+    bsvg.get_svg
   end
 
   def build_nav(arg)
@@ -390,20 +350,22 @@ write output:      write the result to output/panes/header.html
   def generate_bootstrap_navbar(nav_content)
     menu_items = parse_navbar_content(nav_content)
     
-    # Generate Bootstrap navbar HTML
+    # Generate Bootstrap navbar HTML wrapped in bootstrap-scope
     html = <<~HTML
-      <nav class="navbar navbar-expand-lg navbar-light bg-light">
-        <div class="container-fluid">
-          <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
-            <span class="navbar-toggler-icon"></span>
-          </button>
-          <div class="collapse navbar-collapse" id="navbarNav">
-            <ul class="navbar-nav">
-              #{generate_navbar_items(menu_items)}
-            </ul>
+      <div class="bootstrap-scope">
+        <nav class="navbar navbar-expand-lg navbar-light bg-light">
+          <div class="container-fluid">
+            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
+              <span class="navbar-toggler-icon"></span>
+            </button>
+            <div class="collapse navbar-collapse" id="navbarNav">
+              <ul class="navbar-nav">
+                #{generate_navbar_items(menu_items)}
+              </ul>
+            </div>
           </div>
-        </div>
-      </nav>
+        </nav>
+      </div>
     HTML
     
     html
@@ -467,8 +429,6 @@ write output:      write the result to output/panes/header.html
   end
 
   def generate_dropdown_item(item)
-    dropdown_id = "dropdown-#{item[:label].downcase.gsub(/\s+/, '-')}"
-    
     html = <<~HTML
       <li class="nav-item dropdown">
         <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
@@ -477,9 +437,7 @@ write output:      write the result to output/panes/header.html
         <ul class="dropdown-menu">
     HTML
     
-    item[:children].each do |child|
-      html << generate_dropdown_child(child)
-    end
+    item[:children].each {|child| html << generate_dropdown_child(child) }
     
     html << <<~HTML
         </ul>
@@ -534,7 +492,8 @@ write output:      write the result to output/panes/header.html
   
   def build_widgets(arg)
     check_invariants
-    assume { arg.is_a?(String) }
+    msg = "arg must be a String, got #{arg.class}"
+    assume(msg) { arg.is_a?(String) }
     validate_widget_arg(arg)
     
     widgets = arg.split
@@ -542,27 +501,43 @@ write output:      write the result to output/panes/header.html
     widgets.each do |widget|
       validate_widget_name(widget)
       
-      widget_class = eval("Scriptorium::Widget::#{widget.capitalize}")
-      obj = widget_class.new(@repo, self)
-      obj.generate
-      content << obj.card
+      begin
+        widget_class = eval("Scriptorium::Widget::#{widget.capitalize}")
+        obj = widget_class.new(@repo, self)
+        obj.generate
+        content << obj.card
+      rescue => e
+        raise CannotBuildWidget("Failed to build widget '#{widget}': #{e.message}")
+      end
     end
-    verify { content.is_a?(String) }
+    
+    # Wrap widgets in bootstrap-scope container
+    if content.strip.empty?
+      result = content
+    else
+      result = <<~HTML
+        <div class="bootstrap-scope">
+          #{content}
+        </div>
+      HTML
+    end
+    
+    verify { result.is_a?(String) }
     check_invariants
-    content
+    result
   end
 
   private def validate_widget_arg(arg)
-    raise CannotBuildWidgetsArgNil if arg.nil?
+    raise WidgetsArgNil if arg.nil?
     
-    raise CannotBuildWidgetsArgEmpty if arg.to_s.strip.empty?
+    raise WidgetsArgEmpty if arg.to_s.strip.empty?
   end
 
   private def validate_widget_name(name)
-    raise CannotBuildWidgetNameNil if name.nil? || name.strip.empty?
+    raise WidgetNameNil if name.nil? || name.strip.empty?
     
     unless name.match?(/^[a-zA-Z0-9_]+$/)
-      raise CannotBuildWidgetNameInvalid(name)
+      raise WidgetNameInvalid(name)
     end
   end
 
@@ -592,9 +567,9 @@ write output:      write the result to output/panes/header.html
     args = sections["main"]
     return "" unless args
     html = "  <!-- Section: main (output) -->\n"
-    html << %[  <div id="main" class="main" style="flex-grow: 1; padding: 10px; overflow-y: auto; position: relative; display: flex; flex-direction: column;">]
+    html << %[  <div id="main" class="main" style="flex-grow: 1; padding: 5px; overflow-y: auto; position: relative; display: block;">]
     # html << %[<div id="main" class="main" style="position: relative; display: flex; flex-direction: column;">\n]
-    html << @predef.post_index_style
+    html << support_data('post_index/style.css')
     if view_posts.empty?
       html << "  <h1>No posts yet!</h1>"
     else
@@ -607,32 +582,54 @@ write output:      write the result to output/panes/header.html
 
   def generate_post_index
     posts = @repo.all_posts(self) 
-    str = ""
+    config = read_post_index_config
+    
+    # Build table with configurable margin-top
+    margin_top = config[:"index.margin.top"] || "0px"
+    str = "<table width=100% cellpadding=#{config[:'entry.cellpadding']} style=\"margin-top: #{margin_top};\">"
+    
     # FIXME - many decisions to make here...
-    posts.each do |post|
-      str << post_index_entry(post)
-    end
+    posts.each {|post| str << post_index_entry(post) }
+    str << "</table>"
+    
     write_file(@dir/:output/"post_index.html", str)    
   end
 
   def post_index_entry(post)
-      # grab index-entry template
-      # generate index-entry for each post
-      # append to str
-    num, title, pubdate, blurb = post.attrs(:id, :title, :pubdate, :blurb)
-    template = @predef.index_entry
-    entry = substitute(post, template)
+    template = support_data('templates/index_entry.lt3')
+    config = read_post_index_config
+    vars = post.vars.merge(config)
+    
+    # Add formatted_date to vars (use post.date to get pubdate/created fallback)
+    date_format = config[:"entry.date.format"] || "month dd break yyyy"
+    vars[:formatted_date] = format_date(date_format, post.date)
+    
+    entry = substitute(vars, template)
     entry
   end
 
+  def read_post_index_config
+    # Read global defaults first
+    global_config_file = @repo.root/:config/"post_index_defaults.txt"
+    global_config = File.exist?(global_config_file) ? parse_commented_file(global_config_file) : {}
+    
+    # Read view-specific overrides
+    view_config_file = @dir/:config/"post_index.txt"
+    view_config = File.exist?(view_config_file) ? parse_commented_file(view_config_file) : {}
+    
+    # Merge: view config overrides global defaults
+    global_config.merge(view_config)
+  rescue => e
+    {}
+  end
+
   def post_index_array
-    posts = view_posts.sort {|a,b| cf_time(b.pubdate, a.pubdate) }
+    posts = view_posts.sort {|a,b| post_compare(a, b) }
     posts.map {|post| post_index_entry(post)}
   end
 
   def view_posts
-    posts = []
-    @repo.all_posts(self).sort_by {|post| post.pubdate}
+    @repo.all_posts(self).sort {|a,b| post_compare(a, b)}
   end
 
   def generate_html_head(view = nil)
@@ -667,16 +664,16 @@ write output:      write the result to output/panes/header.html
         content << generate_bootstrap_css(view)
       when "social"
         content << generate_social_meta_tags(args)
-      when "syntax"
-        content << generate_syntax_css
+      when "highlight"
+        content << generate_highlight_css(view) # loads highlight_css.txt
+      when "highlight_custom"
+        content << support_data('highlight/custom.css')
       end
     end
     content << "</head>\n"
     content
   end
 
-
-
   def get_common_js(view = nil)
     global_js = @root/:config/"common.js"
     view_js   = @dir/:config/"common.js"
@@ -723,7 +720,7 @@ write output:      write the result to output/panes/header.html
       when "src"
         src = args
       when "rel"
-        rel = args
+        # rel = args
       when "integrity"
         integrity = args
       when "crossorigin"
@@ -758,8 +755,9 @@ write output:      write the result to output/panes/header.html
     # Get the appropriate title, description, and URL
     if is_post
       title = post_data[:"post.title"] || @title
-      description = post_data[:"post.blurb"] || post_data[:"post.body"]&.truncate(200) || @desc || @subtitle || @title
-      url = "posts/#{post_data[:"post.slug"] || slugify(post_data[:"post.id"], title)}.html"
+      description = post_data[:"post.blurb"] || (post_data[:"post.body"] ? post_data[:"post.body"][0..200] : nil) || @desc || @subtitle || @title
+      slug = post_data[:"post.slug"] || (post_data[:"post.id"] ? slugify(post_data[:"post.id"], title) : 'post')
+      url = "posts/#{slug}#{slug.end_with?('.html') ? '' : '.html'}"
       type = "article"
     else
       title = @title
@@ -829,17 +827,20 @@ write output:      write the result to output/panes/header.html
     # Determine post URL and title
     if post_data
       title = post_data[:"post.title"] || @title
-      url = "posts/#{post_data[:"post.slug"] || slugify(post_data[:"post.id"], title)}.html"
+      slug = post_data[:"post.slug"] || slugify(post_data[:"post.id"], title)
+      url = "posts/#{slug}#{slug.end_with?('.html') ? '' : '.html'}"
     else
       title = @title
       url = "index.html"
     end
     
     # Build Reddit share URL
+    require 'uri'
+    encoded_title = URI.encode_www_form_component(title)
     if subreddit.empty?
-      reddit_url = "https://reddit.com/submit?url=#{escape_html(url)}&title=#{escape_html(title)}"
+      reddit_url = "https://reddit.com/submit?url=#{escape_html(url)}&title=#{encoded_title}"
     else
-      reddit_url = "https://reddit.com/r/#{subreddit}/submit?url=#{escape_html(url)}&title=#{escape_html(title)}"
+      reddit_url = "https://reddit.com/r/#{subreddit}/submit?url=#{escape_html(url)}&title=#{encoded_title}"
     end
     
     # Determine hover text
@@ -847,9 +848,9 @@ write output:      write the result to output/panes/header.html
       hover_text = subreddit.empty? ? "Share on Reddit" : "Share on r/#{subreddit}"
     end
     
-    # Generate button HTML
+    # Generate button HTML (use production-relative ../../assets for posts context)
     button_html = %[<a href="#{reddit_url}" target="_blank" title="#{hover_text}" style="text-decoration: none; margin-right: 8px;">
-      <img src="assets/reddit-logo.png" width="16" height="16" alt="Share on Reddit" style="vertical-align: middle;">
+      <img src="../../assets/icons/social/reddit.png" width="32" height="32" alt="Share on Reddit" style="vertical-align: middle;">
     </a>]
     
     button_html
@@ -870,7 +871,7 @@ write output:      write the result to output/panes/header.html
   end
 
   def pagination_bar(group, count, nth)  # nth group of total 'count'
-    str = %[<div style="align-self: flex-end;">Pages: ]
+    str = %[<div style="text-align: center;">Pages: ]
     1.upto(count) do |i|
       if i == nth  # 0-based
         str << "<b>[#{i}]</b>&nbsp;&nbsp;"
@@ -883,18 +884,28 @@ write output:      write the result to output/panes/header.html
   end
 
   def paginate_posts
+    config = read_post_index_config
     posts = @repo.all_posts(self)
-    posts.sort! {|a,b| cf_time(b.pubdate, a.pubdate) }
-    ppp = 10  # FIXME posts per page
+    posts.sort! {|a,b| post_compare(a, b) }
+    @ppp ||= config[:"posts.per.page"].to_i
     pages = []
-    posts.each_slice(ppp).with_index do |group, i|
+    posts.each_slice(@ppp).with_index do |group, i|
       pages << group.map {|post| post_index_entry(post) }
     end
     out = self.dir/:output
     pages.each.with_index do |page, i|
       bar = pagination_bar(page, pages.size, i+1)
-      page << %[<div style="position: absolute; bottom: 0; width: 100%;">#{bar}</div>]
-      write_file(out/"page#{i+1}.html", page.join)
+      # Wrap rows in a table to preserve layout (match non-paginated index)
+      margin_top = config[:"index.margin.top"] || "0px"
+      cellpadding = config[:'entry.cellpadding']
+      table_open = %(<table width=100% cellpadding=#{cellpadding} style="margin-top: #{margin_top};">)
+      table_close = %(</table>)
+      html = String.new
+      html << table_open
+      html << page.join
+      html << table_close
+      html << %[<div style="position: absolute; bottom: 0; width: 100%;">#{bar}</div>]
+      write_file(out/"page#{i+1}.html", html)
     end
     # Remove existing link if it exists, then create new one
     post_index_link = out/"post_index.html"
@@ -903,17 +914,15 @@ write output:      write the result to output/panes/header.html
   end
 
   def generate_front_page
-    layout_file = @dir/:config/"layout.txt"
     index_file  = @dir/:output/"index.html"
-    panes       = @dir/:output/:panes
-
-    # Ensure output directory exists
     FileUtils.mkdir_p(File.dirname(index_file))
 
     html_head = generate_html_head(true)
     content = build_containers
     common = get_common_js
     boot   = generate_bootstrap_js
+    highlight_js = generate_highlight_js(true)
+    highlight_ruby_js = generate_highlight_ruby_js(true)
     full_html = <<~HTML
       <!DOCTYPE html>
       #{html_head}
@@ -921,26 +930,24 @@ write output:      write the result to output/panes/header.html
         <body style="height: 100%; margin: 0; display: flex; flex-direction: column;">
           #{content.strip}
           #{boot.strip}
+          #{highlight_js.strip}
+          #{highlight_ruby_js.strip}
           #{common.strip}
         </body>
       </html>
     HTML
 
     # Beautify HTML if HtmlBeautifier is available
-    # begin
-    #   full_html = ::HtmlBeautifier.beautify(full_html)
-    # rescue NameError, LoadError => e
-    #   # HtmlBeautifier not available, continue without beautification
-    #   # This is not critical for functionality
-    # end
-
-    # Write the main index file
     begin
-      write_file(index_file, full_html)
-    rescue Errno::ENOSPC, Errno::EACCES => e
-      raise FailedToWriteFrontPage(e.message)
+      full_html = ::HtmlBeautifier.beautify(full_html)
+    rescue NameError, LoadError => e
+      # HtmlBeautifier not available, continue without beautification
+      # This is not critical for functionality
     end
 
+    # Write the main index file
+    write_file(index_file, full_html)
+
     # Write debug file (optional, don't fail if it doesn't work)
     begin
       write_file("/tmp/full.html", full_html)
@@ -960,17 +967,55 @@ write output:      write the result to output/panes/header.html
     end
   end
 
+  def generate_highlight_css(view = nil)
+    global_highlight = @root/:config/"highlight_css.txt"
+    view_highlight   = @dir/:config/"highlight_css.txt"
+    highlight_file = view ? view_highlight : global_highlight
+    lines = read_commented_file(highlight_file)
+    href = rel = nil
+    lines.each do |line|
+      component, args = line.split(/\s+/, 2)
+      case component.downcase
+      when "href"
+        href = args
+      when "rel"
+        rel = args
+      end
+    end
+    %[<link rel="#{rel}" href="#{href}">\n]
+  end
 
-
-
-  def generate_syntax_css
-    highlighter = Scriptorium::SyntaxHighlighter.new
-    "<style>\n#{highlighter.generate_css}\n</style>\n"
+  def generate_highlight_js(view = nil)
+    global_highlight = @root/:config/"highlight_js.txt"
+    view_highlight   = @dir/:config/"highlight_js.txt"
+    highlight_file = view ? view_highlight : global_highlight
+    lines = read_commented_file(highlight_file)
+    src = nil
+    lines.each do |line|
+      component, args = line.split(/\s+/, 2)
+      case component.downcase
+      when "src"
+        src = args
+      end
+    end
+    %[<script src="#{src}"></script>\n]
   end
 
-  def highlight_code(code, language = nil)
-    highlighter = Scriptorium::SyntaxHighlighter.new
-    highlighter.highlight(code, language)
+  def generate_highlight_ruby_js(view = nil)
+    global_highlight = @root/:config/"highlight_ruby_js.txt"
+    view_highlight   = @dir/:config/"highlight_ruby_js.txt"
+    highlight_file = view ? view_highlight : global_highlight
+    lines = read_commented_file(highlight_file)
+    src = nil
+    lines.each do |line|
+      component, args = line.split(/\s+/, 2)
+      case component.downcase
+      when "src"
+        src = args
+      end
+    end
+    %[<script src="#{src}"></script>\n]
   end
 
+
 end

data/lib/scriptorium.rb

@@ -2,6 +2,7 @@ require 'livetext'
 require 'find'
 require 'htmlbeautifier'
 require 'pp'
+require 'digest'
 
 require_relative "skeleton"
 require_relative "scriptorium/version"
@@ -20,4 +21,26 @@ require_relative "scriptorium/widgets/links"
 require_relative "scriptorium/widgets/pages"
 require_relative "scriptorium/widgets/featured_posts"
 require_relative "scriptorium/api"
-require_relative "scriptorium/syntax_highlighter"
+
+# Main Scriptorium class that provides backward compatibility
+class Scriptorium
+  def initialize(testmode: false)
+    @api = Scriptorium::API.new(testmode: testmode)
+  end
+  
+  # Delegate all the main operations to the API
+  def method_missing(method, *args, **kwargs, &block)
+    if @api.respond_to?(method)
+      @api.send(method, *args, **kwargs, &block)
+    else
+      super
+    end
+  end
+  
+  def respond_to_missing?(method, include_private = false)
+    @api.respond_to?(method) || super
+  end
+  
+  # Keep the API accessible for advanced users
+  attr_reader :api
+end

data/lib/skeleton.rb

@@ -1,4 +1,4 @@
-module Scriptorium
+class Scriptorium
 
   module Exceptions
   end
@@ -15,4 +15,7 @@ module Scriptorium
   class UI
   end
 
+  class API
+  end
+
 end

data/scriptorium.gemspec

@@ -28,6 +28,7 @@ spec = Gem::Specification.new do |s|
   s.add_runtime_dependency 'rouge',    '~> 3.25', '>= 3.25.0'
   s.add_runtime_dependency 'sinatra',  '~> 3.0',  '>= 3.0.0'
   s.add_runtime_dependency 'redd',     '~> 0.8.8'
+  s.add_runtime_dependency 'x',        '~> 1.0'
   s.add_runtime_dependency 'htmlbeautifier', '~> 1.4', '>= 1.4.0'
   s.add_runtime_dependency 'clipboard', '~> 1.3', '>= 1.3.6'
 
@@ -52,7 +53,7 @@ spec = Gem::Specification.new do |s|
   s.homepage    = 'https://github.com/Hal9000/scriptorium'
   s.license     = "Ruby"
   s.post_install_message = 
-                  "\n  Success! Run 'sblog' command and type h for help.\n "
+                  "\n  Success! Run command 'sblog help' to get started.\n "
 end
 
 spec