ragerender 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 313e3cd9c0ccd4c11ea547a565e2a1cfa77af1fda5e2fc2219c0da8046c6f27a
-  data.tar.gz: 3911407ca12e719f71396099f73d70c6b19aeee29ccc38f796ef4c45b684d80d
+  metadata.gz: c3398336663640ad12e5ca290c96e61fd8fbb19e9851b8944a6434a3eca2c2d2
+  data.tar.gz: d00c31c1051eba512321b80e524c3d117f8d8970ebfd3fc8e9ad7ca4030b358d
 SHA512:
-  metadata.gz: 4ca0ef393683e910b68e9ffe41a5909511ec66da604b50bcb99fbd758cad371bdeafdd594e1a27394e461beb3e0e8f41c4c3033a28f4c7692a492b470251f8b2
-  data.tar.gz: 5509097f24aa3df45416be46acb9d2f31710318b4227b190f9413dcec287d6c473793bff0fd08b3ecf7b1cc49617b9437739fc991d1c9bd2a309fcbd61eef199
+  metadata.gz: 5d7674505e282530b8e19ad5f085b8516888e206bf7a28fb1c9b3e27b127665ca5be9cc056841aca784b382a1eedf8c60d566003a27a851ce227698d55fd2647
+  data.tar.gz: d092d5d375481b8662ea97baa4cbf89e6c1d50347e132654a66af39599750a40dfc9531e1197d2e77761468666e78bd914a65472554254a4cd98e46772011bf7

data/README.rdoc

@@ -49,7 +49,7 @@ To set up a new site, open a terminal and type:
   mkdir mycomic && cd mycomic
   bundle init
   bundle add jekyll
-  bundle add ragerender
+  bundle add ragerender --group=jekyll_plugins
 
 Now you can add comics! Add the image into an <tt>images</tt> folder:
 
@@ -92,6 +92,10 @@ Put something like this in your webcomic folder and call it
   description: >
     My epic story about how him and her
     fell into a romantic polycule with they and them
+  status: active
+  genres:
+  - Comedy
+  - Romance
 
   defaults:
   - scope:
@@ -151,6 +155,8 @@ details of your author notes and blogs manually:
   date: "2025-03-05 16:20"
   image: "images/ghost.png"
   author: "Jane doe"
+  description: "Some spooky mouseover text"
+  keywords: [excellent, comic page, spooky]
   custom:
     # use yes and no for tickbox settings
     spooky: yes
@@ -161,6 +167,9 @@ details of your author notes and blogs manually:
       Testing webcomics
       Now easier than ever
       Thanks to RageRender
+  transcript: >
+    The transcript contains a machine-readable version
+    of all the text in your comic image.
   comments:
     - author: "Skippy"
       date: "13 Mar 2025, 3.45 PM"

data/assets/comic-not-found.html

@@ -0,0 +1,7 @@
+---
+title: Comic not found
+layout: error-page
+hidden: true
+published: false
+---
+This webcomic does not have any comic pages yet!

data/inspector/.gitignore

@@ -0,0 +1,2 @@
+_layouts
+test-layout.cflxml

data/inspector/Rakefile

@@ -0,0 +1,51 @@
+require 'forwardable'
+require 'liquid'
+require_relative '../lib/ragerender/cflxml'
+require_relative '../lib/ragerender/jekyll'
+
+TEMPLATE_DROPS = {
+  'archive' => RageRender::ArchiveDrop,
+  'comic-page' => RageRender::ComicDrop,
+  'error-page' => RageRender::ErrorDrop,
+  'blog-archive' => RageRender::BlogArchiveDrop,
+  'blog-display' => RageRender::BlogDrop,
+  'overview' => RageRender::OverviewDrop,
+  'search' => RageRender::SearchDrop,
+}
+
+Liquid::Template.error_mode = :strict
+Liquid::Template.file_system = Liquid::LocalFileSystem.new('_includes', '%s.html')
+
+directory '_layouts'
+
+TEMPLATE_DROPS.each do |layout, drop|
+  file "_layouts/#{layout}.html" => ['_layouts', RageRender.const_source_location(drop.name).first, "_templates/#{layout}.html", __FILE__] do |t|
+    fields = Set.new(drop.invokable_methods) -
+             Set.new(Jekyll::Drops::DocumentDrop.invokable_methods)
+    all_fields = Set.new(RageRender::WebcomicDrop.invokable_methods) -
+                 Set.new(Jekyll::Drops::DocumentDrop.invokable_methods)
+    template_name = "_templates/#{layout}.html"
+    template = Liquid::Template.parse File::read template_name, environment: ENV
+
+    rake_output_message "liquid ... >#{t.name} <#{template_name}"
+    File::write t.name, template.render!({
+      'title' => "#{drop.name.rpartition(/[A-Z]/).first.split('::').last} Page",
+      'all_fields' => all_fields.to_a.sort,
+      'fields' => fields.to_a.sort,
+      'loops' => [*drop.loops, *RageRender::WebcomicDrop.loops].map {|k, v| {"name" => k.to_s, "fields" => v.map(&:to_s)} },
+    }, strict_variables: true, strict_filters: true)
+  end
+end
+
+file '_layouts/overall.html' => '_templates/overall.html' do |t|
+  cp t.source, t.name
+end
+
+file 'test-layout.cflxml' => ['layout.css', '_layouts/overall.html', *TEMPLATE_DROPS.keys.map {|n| "_layouts/#{n}.html"}] do |t|
+  File.open t.name, 'w' do |f|
+    rake_output_message 'bundle exec jekyll pack'
+    RageRender.pack '_layouts', '.', f
+  end
+end
+
+task :default => 'test-layout.cflxml'

data/inspector/_includes/field_row.html

@@ -0,0 +1,8 @@
+<tr>
+    <td>{{ name }}</td>
+    <td>[v:{{field}}]</td>
+    <td>
+        <script type="text/javascript">document.currentScript.parentElement.append(document.createTextNode([f:js|v:{{field}}]))</script>
+    </td>
+    <td>[c:{{field}}]true[/][c:!{{field}}]false[/]</td>
+</tr>

data/inspector/_includes/field_rows.html

@@ -0,0 +1,15 @@
+{% assign looped_fields = loops | map: "name" %}
+{% for field in fields -%}
+    {%- include "field_row", name: field, field: field -%}
+    {% if looped_fields contains field %}
+        {% assign field_obj = loops | where: "name", field %}
+        {% assign field_fields = field_obj[0].fields %}
+        [l:{{field}}]
+            {% for field_field in field_fields %}
+                {% capture name %}{{field}}[[v:l.aiteration]] → {{ field_field }}{% endcapture %}
+                {% assign field_name = field_field | prepend: "l." %}
+                {%- include "field_row", name: name, field: field_name %}
+            {% endfor %}
+        [/]
+    {% endif %}
+{% endfor -%}

data/inspector/_includes/field_table.html

@@ -0,0 +1,22 @@
+<table>
+    <thead>
+        <tr>
+            <th>Variable name</th>
+            <th>Value on this page</th>
+            <th>Value (escaped)</th>
+            <th>True or false in conditional</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <th colspan=4>Unique to this page</th>
+        </tr>
+        {%- include "field_rows", fields: fields, loops: loops -%}
+    </tbody>
+    <tbody>
+        <tr>
+            <th colspan=4>On all pages</th>
+        </tr>
+        {%- include "field_rows", fields: all_fields, loops: loops -%}
+    </tbody>
+</table>

data/inspector/_templates/archive.html

@@ -0,0 +1,3 @@
+<h2>{{ title }}</h2>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/_templates/blog-archive.html

@@ -0,0 +1,3 @@
+<h2>{{ title }}</h2>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/_templates/blog-display.html

@@ -0,0 +1,3 @@
+<h2>{{ title }}</h2>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/_templates/comic-page.html

@@ -0,0 +1,3 @@
+<h2>{{ title }}</h2>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/_templates/error-page.html

@@ -0,0 +1,3 @@
+<h2>{{ title }}</h2>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/_templates/overall.html

@@ -0,0 +1,90 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1">
+
+        <meta property="og:type" content="website" />
+        <meta property="og:title" content="[v:webcomicname]" />
+        <meta property="og:description" content="[v:pagetitle]" />
+        [c:permalink]
+        <meta property="og:url" content="[v:permalink]" />
+        [/]
+        <meta name="twitter:card" content="summary_large_image" />
+        <meta name="twitter:title" content="[v:webcomicname]" />
+        <meta name="twitter:description" content="[v:pagetitle]" />
+
+        [c:previewimageurl]
+            <meta property="og:image" content="[v:previewimageurl]" />
+            <meta property="og:image:width" content="[v:previewimagewidth]" />
+            <meta property="og:image:height" content="[v:previewimageheight]" />
+            <meta name="twitter:image" content="[v:previewimageurl]" />
+        [/]
+
+		<link rel="alternate" type="application/rss+xml" title="RSS" href="/rss/" />
+
+		<title>[v:webcomicname] - [v:pagetitle]</title>
+		[v:layoutcss]
+	</head>
+	<body>
+        <header>
+            <h1><a href="/">[v:webcomicname]</a></h1>
+            <div id="slogan">[v:webcomicslogan]</div>
+        </header>
+
+
+        <nav class="site-nav">
+            <ul id="navigation">
+                <li><a href="/">Home</a></li>
+                <li><a href="/comics/#content-start">Latest</a></li>
+                <li><a href="/comics/1/#content-start">First</a></li>
+                [c:searchon]
+                    <li><a href="/search/">Search</a></li>
+                [/]
+                <li><a href="/archive/">Archive</a></li>
+                [c:infinitescrollenabled]
+                    <li><a href="[v:infinitescrolllink]">Scroll View</a></li>
+                [/]
+                [c:hasblogs]
+                    <li><a href="/blog/">Blog</a></li>
+                [/]
+                [c:!hidefromhost]
+                    <li><a href="[v:addsubscriptionlink]">Subscribe</a></li>
+                [/]
+                [l:extrapages]
+                    <li><a href="[v:l.link]">[v:l.title]</a></li>
+                [/]
+            </ul>
+        </nav>
+
+        <!--layout:[content]-->
+        <footer>
+            <div>
+                <ul>
+                    <li>
+                        <a href="/rss/">RSS</a>
+                    </li>
+                    [c:!hidefromhost]
+                        <li>
+                            <a href="[v:comicprofile]">Comic Profile</a>
+                        </li>
+                    [/]
+                    <li>
+                        <a href="#">Top</a>
+                    </li>
+                </ul>
+            </div>
+
+            <div class="hostedby">
+                <span>Hosted by </span>
+                <a href="https://comicfury.com">
+                    <img src="https://comicfury.com/images/gator-icon-black.png" height="22" style="height:22px; width:auto;" />
+                    ComicFury
+                </a>
+            </div>
+            <div>
+                &copy; [v:copyrights]<br />
+            </div>
+        </footer>
+	</body>
+</html>

data/inspector/_templates/overview.html

@@ -0,0 +1,3 @@
+<h2>{{ title }}</h2>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/_templates/search.html

@@ -0,0 +1,10 @@
+<h2>{{ title }}</h2>
+
+<form method="post" action="/search/" id="searchbox">
+    <div class="searchbar">
+        <input type="text" name="search" value="[v:searchterm]" placeholder="Search Term" id="bigsearchbox" />
+        <input type="submit" value="Search!" class="submit" />
+    </div>
+</form>
+
+{%- include "field_table", all_fields: all_fields, fields: fields, loops: loops -%}

data/inspector/layout.css

@@ -0,0 +1,50 @@
+body {
+  max-width: 1024px;
+  margin: 2em auto 0;
+
+  font-family: monospace;
+}
+
+body::before {
+	content: "";
+	display: block;
+	position: absolute;
+	left: 0;
+	top: 0;
+	right: 0;
+	height: 0;
+	background: yellow;
+	border-top: 1em black dashed;
+	transform: skewX(-35deg);
+  max-width: 99vw;
+}
+
+table td, table th {
+  background: white;
+  padding: 1ch;
+}
+
+table td:nth-child(2) {
+  max-width: 35vw;
+  overflow: scroll;
+}
+
+table td:nth-child(3) {
+  word-wrap: anywhere;
+}
+
+table tr:nth-child(even) {
+  filter: invert(0.1);
+}
+
+table th {
+  filter: invert(0.2);
+}
+
+td:empty::before {
+  content: 'blank';
+  display: inline-block;
+  background: rgba(0, 0, 0, 0.15);
+  padding: 0px 4px;
+  border-radius: 5px;
+}

data/lib/ragerender/jekyll/archive.rb

@@ -1,6 +1,7 @@
 require 'jekyll/generator'
 require 'jekyll/drops/drop'
 require_relative 'comics'
+require_relative 'chapter'
 require_relative 'pagination'
 require_relative 'pipettes'
 
@@ -113,6 +114,7 @@ module RageRender
       !show_comic_list
     end
 
+    def_loop :chapters, *(RageRender::ChapterDrop.invokable_methods - Jekyll::Drops::DocumentDrop.invokable_methods)
     def chapters
       unless show_chapter_overview
         @obj.site.collections['chapters'].docs.reject do |page|
@@ -123,13 +125,14 @@ module RageRender
       end
     end
 
+    def_loop :comics_paginated, :number, :newchapter, :chapterend, *ComicDrop::PAGINATION_FIELDS, *ChapterDrop::PAGINATION_FIELDS
     def comics_paginated
       number = @obj.data['number']
       comics = if number
         selected_comics.to_a[number - 1]
       else
         selected_comics.to_a.flatten
-      end.group_by {|c| c.data['chapter'] }
+      end&.group_by {|c| c.data['chapter'] } || []
 
       comics.map do |chapter, comics|
         chapter_data = ChapterDrop.new(@obj.site.collections['chapters'].docs.detect {|c| c.data['slug'] == chapter })

data/lib/ragerender/jekyll/blog_archive.rb

@@ -52,11 +52,40 @@ module RageRender
     end
   end
 
+  # Data representing a single paginated blog entry, as available from
+  # [l:blogs_paginated].
+  class PaginatedBlogDrop < Jekyll::Drops::DocumentDrop
+    extend Pipettes
+
+    def_data_delegator :title, :blogtitle
+    def_delegator :@obj, :url, :bloglink
+    def_data_delegator :author, :authorname
+    def_delegator :@obj, :content, :blog
+    # TODO profilelink
+
+    private delegate_method_as :data, :fallback_data
+
+    def posttime
+      comicfury_date(@obj.date)
+    end
+
+    def allowcomments
+      @obj.site.config['allowcomments']
+    end
+
+    def comments
+      (@obj.data['comments'] || []).size
+    end
+  end
+
   # Data to pass to a blog archive page.
   class BlogArchiveDrop < Jekyll::Drops::Drop
+    extend Pipettes
+
     private delegate_method_as :data, :fallback_data
     data_delegator 'number'
 
+    def_loop :blogs_paginated, *(RageRender::PaginatedBlogDrop.invokable_methods - Jekyll::Drops::DocumentDrop.invokable_methods)
     def blogs_paginated
       all_blogs[number-1]&.map {|blog| PaginatedBlogDrop.new(blog).to_liquid } || []
     end
@@ -81,36 +110,11 @@ module RageRender
         }
       end
     end
+    def_loop :pages, :page, :pagelink, :is_current, :skipped_ahead
 
     private
     def all_blogs
       @all_blogs = @obj.site.posts.docs.each_slice(BLOGS_PER_PAGE).to_a
     end
   end
-
-  # Data representing a single paginated blog entry, as available from
-  # [l:blogs_paginated].
-  class PaginatedBlogDrop < Jekyll::Drops::DocumentDrop
-    extend Pipettes
-
-    def_data_delegator :title, :blogtitle
-    def_delegator :@obj, :url, :bloglink
-    def_data_delegator :author, :authorname
-    def_delegator :@obj, :content, :blog
-    # TODO profilelink
-
-    private delegate_method_as :data, :fallback_data
-
-    def posttime
-      comicfury_date(@obj.date)
-    end
-
-    def allowcomments
-      @obj.site.config['allowcomments']
-    end
-
-    def comments
-      (@obj.data['comments'] || []).size
-    end
-  end
 end

data/lib/ragerender/jekyll/chapter.rb

@@ -74,9 +74,8 @@ module RageRender
     COVER_MAX_HEIGHT = 420
     COVER_MAX_WIDTH = 300
 
-    PAGINATION_FIELDS = %w[ chaptername chapterdescription ]
+    PAGINATION_FIELDS = %w[ chaptername chapterdescription chapterid ]
 
-    delegate_method_as :data, :fallback_data
     extend Pipettes
     extend Forwardable
 
@@ -84,11 +83,17 @@ module RageRender
     def_data_delegator :image, :image
     def_delegator :@obj, :url, :chapterarchiveurl
 
+    def chapterid
+      @obj.collection.docs.index @obj
+    end
+
     def chaptername
       escape @obj.data['title']
     end
 
     def cover_width_small
+      return nil if cover_width.nil?
+
       if (cover_height.to_f / COVER_MAX_HEIGHT) > (cover_width.to_f / COVER_MAX_WIDTH)
         (cover_height_small * cover_width) / cover_height
       else
@@ -97,6 +102,8 @@ module RageRender
     end
 
     def cover_height_small
+      return nil if cover_height.nil?
+
       if (cover_height.to_f / COVER_MAX_HEIGHT) > (cover_width.to_f / COVER_MAX_WIDTH)
         [COVER_MAX_HEIGHT, cover_height].min
       else
@@ -116,9 +123,18 @@ module RageRender
 
     private
     def_image_metadata :image
+    private :image_url, :image_width, :image_height
+
+    def comics
+      @obj.site.collections['comics'].docs.select {|c| c.data['chapter'] == @obj.data['slug'] }
+    end
 
     def first_comic
-      @obj.site.collections['comics'].docs.select {|c| c.data['chapter'] == @obj.data['slug'] }.first
+      comics.first
+    end
+
+    def fallback_data
+      {}
     end
 
     public

data/lib/ragerender/jekyll/comics.rb

@@ -1,7 +1,13 @@
+require 'uri'
+require 'liquid/drop'
+require 'jekyll/hooks'
+require 'jekyll/plugin'
 require 'jekyll/generator'
 require 'jekyll/document'
+require 'jekyll/drops/drop'
 require 'jekyll/drops/document_drop'
 require_relative '../date_formats'
+require_relative 'chapter'
 require_relative 'pipettes'
 
 Jekyll::Hooks.register :comics, :pre_render do |page, payload|
@@ -12,6 +18,8 @@ end
 module RageRender
   SPECIAL_COMIC_SLUGS = %w{frontpage index}
 
+  BASE_DIR = File.join(File.dirname(__FILE__), '..', '..', '..')
+
   # Creates comics for each file found in the 'images' directory
   # that does not already have an associated comic object.
   class ComicFromImageGenerator < Jekyll::Generator
@@ -42,9 +50,14 @@ module RageRender
     def generate site
       comics = site.collections['comics']
       index = comics.docs.last.dup
+      collection = comics.docs
+      if index.nil?
+        index = site.pages.detect {|p| p.data["title"] == "Comic not found" }.dup
+        collection = site.pages
+      end
       index.instance_variable_set(:"@data", index.data.dup)
       index.data['slug'] = 'index'
-      comics.docs << index
+      collection << index
     end
   end
 
@@ -53,12 +66,16 @@ module RageRender
 
     def generate site
       site.collections['comics'].docs.each do |comic|
-        comic.data['image'] ||= default_image_path(comic)
+        comic.data['image'] ||= default_image_path(site, comic)
       end
     end
 
-    def default_image_path comic
-      "images/#{comic.data['slug']}.jpg"
+    def images site
+      @images ||= site.static_files.select {|f| f.relative_path.start_with? '/images' }.map {|f| [f.basename, f] }.to_h
+    end
+
+    def default_image_path site, comic
+      images(site)[comic.data['slug']].relative_path
     end
   end
 
@@ -86,31 +103,65 @@ module RageRender
     def_delegator :@obj, :url, :permalink
     data_delegator 'rating'
     data_delegator 'votecount'
+    data_delegator 'comments'
 
     def comictitle
       escape @obj.data['title']
     end
 
+    def comicdescription
+      escape @obj.data['description']
+    end
+
+    def transcript
+      escape @obj.data['transcript']
+    end
+
+    def comickeywords
+      (@obj.data['keywords'] || []).map {|k| escape k }.join(', ')
+    end
+
+    def comicnumber
+      1 + all_comics.index(@obj)
+    end
+
+    def comicsnum
+      all_comics.size
+    end
+
     def posttime
       comicfury_date(@obj.date)
     end
 
-    def usechapters
-      all_comics.any? {|comic| comic.data.include? 'chapter' }
+    def postyear
+      @obj.date.year
+    end
+
+    def postmonth
+      @obj.date.month
     end
 
     def haschapter
       @obj.data.include? 'chapter'
     end
 
-    def chaptername
-      escape(chapter.data['title']) rescue nil
+    def_safe_delegator :chapterdrop, :chapterid, :chapterid
+    def_safe_delegator :chapterdrop, :chaptername, :chaptername
+    def_safe_delegator :chapterdrop, :chapterdescription, :chapterdescription
+    def_safe_delegator :chapter, :url, :chapterlink
+
+    def_safe_delegator :prevchapterdrop, :url, :prevchapter
+    def_safe_delegator :nextchapterdrop, :url, :nextchapter
+
+    def isfirstcomicinchapter
+      (chapterdrop&.send(:comics) || []).first == @obj
     end
 
-    def chapterlink
-      chapter&.url
+    def islastcomicinchapter
+      (chapterdrop&.send(:comics) || []).last == @obj
     end
 
+    def_loop :dropdown, :is_selected, :is_disabled, :title, :grouplabel, :newgroup, :endgroup, :url
     def dropdown
       all_comics.each_with_object([]) do |c, dropdown|
         new_group = dropdown.last.nil? ? true : dropdown.last['grouplabel'] != c.data['chapter']
@@ -143,6 +194,7 @@ module RageRender
       end
     end
 
+    def_loop :authornotes, :is_reply, :comment, :isguest, :avatar, :authorname, :commentanchor, :posttime, :profilelink
     def authornotes
       @obj.data['authornotes'] || [{
         'is_reply' => false,
@@ -174,12 +226,28 @@ module RageRender
       all_comics.last == @obj
     end
 
-    def prevcomic
-      @obj.previous_doc&.url
+    def_safe_delegator :prevcomicdrop, :url, :prevcomic
+    def_safe_delegator :prevcomicdrop, :permalink, :prevcomicpermalink
+    def_safe_delegator :prevcomicdrop, :title, :prevcomictitle
+
+    def_safe_delegator :nextcomicdrop, :url, :nextcomic
+    def_safe_delegator :nextcomicdrop, :permalink, :nextcomicpermalink
+    def_safe_delegator :nextcomicdrop, :title, :nextcomictitle
+
+    def prevcomicbychapter
+      if isfirstcomicinchapter
+        (prevchapterdrop&.send(:comics) || []).last
+      else
+        (chapterdrop&.send(:comics) || []).each_cons(2).detect {|_, this| this == @obj }&.first
+      end&.url
     end
 
-    def nextcomic
-      @obj.next_doc&.url
+    def nextcomicbychapter
+      if islastcomicinchapter
+        nextchapterdrop&.send(:first_comic)
+      else
+        (chapterdrop&.send(:comics) || []).each_cons(2).detect {|this, _| this == @obj }&.last
+      end&.url
     end
 
     # An HTML tag to print for the comic image. If there is a future image, then
@@ -189,7 +257,9 @@ module RageRender
         <a href="#{nextcomic}">
       HTML
       image = <<~HTML
-        <img id="comicimage" src="#{comicimageurl}" width="#{comicwidth}" height="#{comicheight}">
+        <img id="comicimage" src="#{comicimageurl}" alt="#{comictitle}"
+             width="#{comicwidth}" height="#{comicheight}"
+             title="#{comicdescription}">
       HTML
       linkclose = nextcomic ? <<~HTML : ''
         </a>
@@ -197,6 +267,10 @@ module RageRender
       [linkopen, image, linkclose].join
     end
 
+    def keys
+      super.reject {|k| private_methods.include? k.to_sym }
+    end
+
     def to_liquid
       super.reject do |k, v|
         Jekyll::Drops::DocumentDrop::NESTED_OBJECT_FIELD_BLACKLIST.include? k
@@ -212,8 +286,29 @@ module RageRender
       @obj.site.collections['chapters'].docs.detect {|c| c.data['slug'] == @obj.data['chapter'] }
     end
 
+    def nextcomicdrop
+      @obj.next_doc.nil? ? nil : ComicDrop.new(@obj.next_doc)
+    end
+
+    def prevcomicdrop
+      @obj.previous_doc.nil? ? nil : ComicDrop.new(@obj.previous_doc)
+    end
+
+    def chapterdrop
+      chapter.nil? ? nil : ChapterDrop.new(chapter)
+    end
+
+    def prevchapterdrop
+      chapter&.previous_doc.nil? ? nil : ChapterDrop.new(chapter.previous_doc)
+    end
+
+    def nextchapterdrop
+      chapter&.next_doc.nil? ? nil : ChapterDrop.new(chapter.next_doc)
+    end
+
     data_delegator 'image'
     def_image_metadata :image
+    private :image, :image_url, :image_width, :image_height
 
     public
     alias comicimageurl image_url

data/lib/ragerender/jekyll/overview.rb

@@ -7,17 +7,22 @@ require_relative 'blog_archive'
 Jekyll::Hooks.register :pages, :pre_render do |page, payload|
   if page.data['layout'] == 'overview'
     RageRender::Pipettes.clean_payload payload
-    payload.merge! RageRender::ComicDrop.new(page.site.collections['comics'].docs.last).to_liquid
+    latest_comic = page.site.collections['comics'].docs.last
+    if latest_comic
+      payload.merge! RageRender::ComicDrop.new(latest_comic).to_liquid
+    end
     payload.merge! RageRender::OverviewDrop.new(page).to_liquid
   end
 end
 
 module RageRender
   class OverviewDrop < Jekyll::Drops::Drop
+    extend Pipettes
     private delegate_method_as :data, :fallback_data
 
+    def_loop :latestblogs, *(RageRender::PaginatedBlogDrop.invokable_methods - Jekyll::Drops::DocumentDrop.invokable_methods)
     def latestblogs
-      @obj.site.posts.docs[-5..].map {|post| RageRender::PaginatedBlogDrop.new(post) }
+      @obj.site.posts.docs[-5..]&.map {|post| RageRender::PaginatedBlogDrop.new(post) } || []
     end
   end
 end

data/lib/ragerender/jekyll/pipettes.rb

@@ -11,12 +11,26 @@ module RageRender
       payload.send(:fallback_data).delete_if {|k| methods.include? k}
     end
 
+    def def_safe_delegator obj, key, aliaz
+      define_method(aliaz.to_sym) do
+        send(obj.to_sym)&.send(key.to_sym)
+      end
+    end
+
     def def_data_delegator key, aliaz
       define_method(aliaz.to_sym) do
         @obj.data[key.to_s]
       end
     end
 
+    def def_loop method, *fields
+      (@loops ||= {})[method.to_sym] = fields
+    end
+
+    def loops
+      @loops || {}
+    end
+
     def self.extended mod
       mod.define_method(:escape) do |str|
         str.nil? ? nil : CGI.escapeHTML(str)
@@ -33,6 +47,7 @@ module RageRender
       define_method(:"#{prefix}_relative_path") do
         Pathname.new('/').join(send(prefix.to_sym)).to_path
       end
+      private :"#{prefix}_relative_path"
 
       define_method(:"#{prefix}_url") do
         File.join (@obj.site.baseurl || ''), send(:"#{prefix}_relative_path")
@@ -44,17 +59,19 @@ module RageRender
         end
         instance_variable_get(:"@#{prefix}_obj")
       end
+      private :"#{prefix}_obj"
 
       define_method(:"#{prefix}_path") do
         send(:"#{prefix}_obj").path
       end
+      private :"#{prefix}_path"
 
       define_method(:"#{prefix}_width") do
-        send(:"#{prefix}_obj").data['width'] ||= Dimensions.width(send(:"#{prefix}_path")) rescue nil
+        send(:"#{prefix}_obj") && (send(:"#{prefix}_obj").data['width'] ||= Dimensions.width(send(:"#{prefix}_path")) rescue nil)
       end
 
       define_method(:"#{prefix}_height") do
-        send(:"#{prefix}_obj").data['height'] ||= Dimensions.height(send(:"#{prefix}_path")) rescue nil
+        send(:"#{prefix}_obj") && (send(:"#{prefix}_obj").data['height'] ||= Dimensions.height(send(:"#{prefix}_path")) rescue nil)
       end
     end
   end

data/lib/ragerender/jekyll/search.rb

@@ -7,6 +7,8 @@ end
 
 module RageRender
   class SearchDrop < Jekyll::Drops::Drop
+    extend Pipettes
+
     private delegate_method_as :data, :fallback_data
     data_delegator 'searchterm'
 
@@ -14,6 +16,7 @@ module RageRender
       !searchterm.nil?
     end
 
+    def_loop :searchresults, :number, *ComicDrop::PAGINATION_FIELDS
     def searchresults
       return [] unless searched
       @results ||= @obj.site.collections['comics'].docs.select do |comic|

data/lib/ragerender/jekyll.rb

@@ -1,6 +1,10 @@
 require 'etc'
 require 'stringio'
-require 'jekyll'
+require 'jekyll/command'
+require 'jekyll/hooks'
+require 'jekyll/plugin'
+require 'jekyll/generator'
+require 'liquid/drop'
 require_relative 'language'
 require_relative 'functions'
 require_relative 'to_liquid'
@@ -57,6 +61,7 @@ Jekyll::Hooks.register :site, :after_init do |site|
   site.config['theme'] ||= 'ragerender'
   site.config['title'] ||= File.basename(site.source)
   site.config['search'] ||= true
+  site.config['url'] ||= "https://#{File.basename(site.source)}.thecomicseries.com"
   site.config = site.config
 
   setup_collection site, :comics, '/:collection/:slug/', layout: 'comic-page', chapter: '0'
@@ -105,6 +110,10 @@ class RageRender::FrontpageGenerator < Jekyll::Generator
       collection = site.pages
       site.pages.detect {|p| p.data["slug"] == frontpage }
     end.dup
+    if index.nil?
+      collection = site.pages
+      index = site.pages.detect {|p| p.data['title'] == 'Comic not found' }.dup
+    end
     index.instance_variable_set(:"@data", index.data.dup)
     index.data['permalink'] = '/index.html'
     index.data['slug'] = 'frontpage'
@@ -125,8 +134,8 @@ class RageRender::WebcomicDrop < Jekyll::Drops::Drop
   extend Forwardable
   extend RageRender::Pipettes
 
-  def self.def_config_delegator source, target
-    define_method(target) { @obj.site.config[source.to_s] }
+  def self.def_config_delegator source, target, default=nil
+    define_method(target) { @obj.site.config.fetch(source.to_s, default) }
   end
 
   def_config_delegator :search, :searchon
@@ -134,16 +143,62 @@ class RageRender::WebcomicDrop < Jekyll::Drops::Drop
     def_config_delegator var, var
   end
 
+  def webcomicid
+    @obj.site.config['id'] || @obj.site.hash
+  end
+
   def webcomicname
     escape @obj.site.config['title']
   end
 
   def webcomicslogan
+    escape @obj.site.config['slogan']
+  end
+
+  def webcomicdescription
     escape @obj.site.config['description']
   end
 
+  def webcomicactivitystatus
+    escape @obj.site.config['status']&.capitalize
+  end
+
+  def webcomicsub
+    URI.parse(@obj.site.config['url']).host.split.first
+  end
+
+  def comicprofile
+    "https://comicfury.com/comicprofile.php?url=#{webcomicsub}"
+  end
+
+  def addsubscriptionlink
+    "https://comicfury.com/comic.php?action=addsubscription&url=#{webcomicsub}"
+  end
+
+  def_loop :webcomicgenres, :genre_link, :genre_name
+  def webcomicgenres
+    (@obj.site.config['genres'] || []).map do |g|
+      {
+        'genre_name' => escape(g),
+        'genre_link' => "https://comicfury.com/search.php?vr=1&query=&tags=#{g.downcase.gsub(/[^a-z]/, '')}"
+      }
+    end
+  end
+
+  def webcomicgenre
+    (webcomicgenres.first || {})['genre_name']
+  end
+
   def webcomicurl
-    @obj.site.baseurl
+    @obj.site.config['url']
+  end
+
+  def webcomicrating
+    @obj.site.config['rating']
+  end
+
+  def lastupdate
+    comicfury_date Time.now
   end
 
   def lastupdatedmy
@@ -151,7 +206,7 @@ class RageRender::WebcomicDrop < Jekyll::Drops::Drop
   end
 
   def copyrights
-    escape @obj.site.config['copyrights'].gsub('[year]', Date.today.year.to_s)
+    escape @obj.site.config.fetch('copyrights', '').gsub('[year]', Date.today.year.to_s)
   end
 
   def banner
@@ -171,13 +226,34 @@ class RageRender::WebcomicDrop < Jekyll::Drops::Drop
     @obj.site.posts.docs.any?
   end
 
+  def hascomics
+    comicsnum > 0
+  end
+
+  def comicsnum
+    @obj.site.collections['comics'].docs.size
+  end
+
+  def usechapters
+    @obj.site.collections['comics'].docs.any? {|comic| comic.data.include? 'chapter' }
+  end
+
+  %w{subscriptions pageviewsnum visitsnum}.each do |var|
+    def_config_delegator var, var, 0
+  end
+
   def hidefromhost
     false
   end
 
+  def_loop :extrapages, :link, :title, :foldername
   def extrapages
     @obj.site.pages.reject {|page| page.data['hidden'] }.map do |page|
-      {'link' => page.url, 'title' => escape(page.data['title'])}
+      {
+        'link' => page.url,
+        'title' => escape(page.data['title']),
+        'foldername' => File.basename(URI::parse(page.url).path, '.*'),
+      }
     end
   end
 
@@ -194,6 +270,7 @@ class RageRender::WebcomicDrop < Jekyll::Drops::Drop
     css_files << Pathname.new(@obj.site.theme.includes_path).join('layout.css') unless css_files.any?
     css_files.map {|f| File.read f }.join
   end
+  private :css
 
   def layoutcss
     <<~HTML
@@ -207,14 +284,58 @@ class RageRender::WebcomicDrop < Jekyll::Drops::Drop
     escape @obj.data['title']
   end
 
+  def isarchive
+    @obj.data['layout'] == 'archive'
+  end
+
+  def issearch
+    @obj.data['layout'] == 'search'
+  end
+
   def iscomicpage
-    @obj.type == :comics
+    @obj.data['layout'] == 'comic-page'
+  end
+
+  def isblog
+    @obj.data['layout'] == 'blog-archive'
+  end
+
+  def isoverview
+    @obj.data['layout'] == 'overview'
+  end
+
+  def iserrorpage
+    @obj.data['layout'] == 'error-page'
+  end
+
+  def isfrontpage
+    @obj.data['slug'] == 'frontpage'
+  end
+
+  def iscomicrelatedpage
+    @obj.type == :comics || @obj.data['layout'] == 'overview'
   end
 
   def isextrapage
     @obj.type == :pages && @obj.data['hidden'] != true
   end
 
+  def currentdate
+    comicfury_date Date.today
+  end
+
+  def day
+    Date.today.day
+  end
+
+  def month
+    Date.today.month
+  end
+
+  def year
+    Date.today.year
+  end
+
   def fallback_data
     {}
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ragerender
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Simon Worthington
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-21 00:00:00.000000000 Z
+date: 2026-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rsec
@@ -141,7 +141,7 @@ description: |-
     mkdir mycomic && cd mycomic
     bundle init
     bundle add jekyll
-    bundle add ragerender
+    bundle add ragerender --group=jekyll_plugins
 
   Now you can add comics! Add the image into an <tt>images</tt> folder:
 
@@ -184,6 +184,10 @@ description: |-
     description: >
       My epic story about how him and her
       fell into a romantic polycule with they and them
+    status: active
+    genres:
+    - Comedy
+    - Romance
 
     defaults:
     - scope:
@@ -243,6 +247,8 @@ description: |-
     date: "2025-03-05 16:20"
     image: "images/ghost.png"
     author: "Jane doe"
+    description: "Some spooky mouseover text"
+    keywords: [excellent, comic page, spooky]
     custom:
       # use yes and no for tickbox settings
       spooky: yes
@@ -253,6 +259,9 @@ description: |-
         Testing webcomics
         Now easier than ever
         Thanks to RageRender
+    transcript: >
+      The transcript contains a machine-readable version
+      of all the text in your comic image.
     comments:
       - author: "Skippy"
         date: "13 Mar 2025, 3.45 PM"
@@ -350,8 +359,23 @@ files:
 - assets/archive-comics.html
 - assets/archive.html
 - assets/blog.html
+- assets/comic-not-found.html
 - assets/overview.html
 - assets/search.html
+- inspector/.gitignore
+- inspector/Rakefile
+- inspector/_includes/field_row.html
+- inspector/_includes/field_rows.html
+- inspector/_includes/field_table.html
+- inspector/_templates/archive.html
+- inspector/_templates/blog-archive.html
+- inspector/_templates/blog-display.html
+- inspector/_templates/comic-page.html
+- inspector/_templates/error-page.html
+- inspector/_templates/overall.html
+- inspector/_templates/overview.html
+- inspector/_templates/search.html
+- inspector/layout.css
 - lib/ragerender.rb
 - lib/ragerender/cflxml.rb
 - lib/ragerender/date_formats.rb