perron 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '080352c09efb475419f74de6ee7cf01a491d4cc349f6cf0d6e23d35132c83953'
-  data.tar.gz: 156c0419afc4c3aa77411ac7f7508cbea56de584d164624be86b4d2615baf7f5
+  metadata.gz: 709c1a304332c522dd7e425824f2718b1a84994db9695b842cddab07fa2a6c2d
+  data.tar.gz: cd636faddbff65dd1cc27652fb9141a936ce7df7e5f4fca1e156fd7b1ff27522
 SHA512:
-  metadata.gz: c75e1453c34bf8a8b8a4345d9167110745c1c47d8094aea3345e85fb46de51b0d326c904a7132c20e058ae89156c48dac5b9311121fc0359ad1d348ccde7d27f
-  data.tar.gz: a3acd15ee6f0224c032b31dac7272539e6ed6e6c9451a4b22d47c83c108f8fa374f5b6b7ceab97ae7bf4d6cc1296bbac8cd9c8788b28c7187f50c29c4621ee01
+  metadata.gz: 40df8027fb5974b0670a80b4c61e918da1f3dd7cec833e5fab48cdb606ddb9d9e56480cb69ad3c3033c2fdf1deb09e0c105cb15730cb92581e1d57c3db57ce3f
+  data.tar.gz: af0d331538e600ad27d23f9377d6cdabcc1f3142ad7d07de517b002334c0414896edb45d6d0d5d6ab50a6af81be12f4b2bf667c15e8bc50e211a824b6701d1b2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    perron (0.14.0)
+    perron (0.16.0)
       csv
       json
       psych
@@ -120,7 +120,8 @@ GEM
       net-smtp
     marcel (1.0.4)
     mini_mime (1.1.5)
-    minitest (5.25.5)
+    mini_portile2 (2.8.9)
+    minitest (5.27.0)
     net-imap (0.5.9)
       date
       net-protocol
@@ -131,6 +132,9 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.4)
+    nokogiri (1.18.8)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
     nokogiri (1.18.8-aarch64-linux-gnu)
       racc (~> 1.4)
     nokogiri (1.18.8-aarch64-linux-musl)
@@ -244,7 +248,7 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
+    unicode-emoji (4.2.0)
     useragent (0.16.11)
     websocket-driver (0.8.0)
       base64

data/lib/generators/perron/install_generator.rb

@@ -11,10 +11,7 @@ module Perron
     end
 
     def create_data_directory
-      data_directory = Rails.root.join("app", "content", "data")
-      empty_directory data_directory
-
-      template "README.md.tt", File.join(data_directory, "README.md")
+      template "README.md.tt", "app/content/data/README.md"
     end
 
     def add_markdown_gems

data/lib/generators/rails/content/USAGE

@@ -0,0 +1,41 @@
+Description:
+    Generates content model scaffold (controller, views, routes) or creates
+    new content files from templates.
+
+Examples:
+    Generate content scaffold:
+        rails generate content Post
+        rails generate content Post index
+        rails generate content Post index show
+
+    This will create:
+        app/content/posts/
+        app/models/content/post.rb
+        app/controllers/content/posts_controller.rb
+        app/views/content/posts/index.html.erb
+        app/views/content/posts/show.html.erb
+
+    And adds: resources :posts, module: :content, only: %w[index show]
+
+    Create new content file from template:
+        rails generate content Post --new
+        rails generate content Post --new "My First Post"
+
+    This will create a new content file in app/content/posts/ using:
+        - YYYY-MM-DD-template.*.tt (if exists, with date prefix)
+        - template.*.tt (if exists, without date prefix)
+        - Empty file with frontmatter dashes (if no template)
+
+    Template files support ERB:
+        ---
+        title: <%= @title %>
+        published_at: <%= Time.current %>
+        ---
+
+Arguments:
+    NAME: Name of the content model (singular or plural)
+    actions: Actions to generate (default: index show)
+
+Options:
+    --new [TITLE]: Create new content file instead of scaffold
+    --force-plural: Use plural form for model name and class

data/lib/generators/rails/content/content_generator.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module Rails
+  module Generators
+    class ContentGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :force_plural, type: :boolean, default: false, desc: "Forces the use of a plural model name and class"
+      class_option :new, type: :string, default: nil, banner: "TITLE",
+        desc: "Create a new content file from template instead of generating scaffold"
+
+      argument :actions, type: :array, default: %w[index show], banner: "actions", desc: "Specify which actions to generate (index/show)"
+
+      def initialize(*args)
+        super
+
+        @content_mode = !options[:new].nil?
+        @content_title = options[:new].presence
+      end
+
+      def create_content_file
+        return unless @content_mode
+
+        @title = @content_title
+
+        if template_file
+          create_file File.join(content_directory, filename_from_template), ERB.new(File.read(template_file)).result(binding)
+        else
+          create_file File.join(content_directory, filename_from_template), "---\n---\n"
+        end
+      end
+
+      def create_model
+        return if @content_mode
+
+        template "model.rb.tt", File.join("app/models/content", "#{file_name}.rb")
+      end
+
+      def create_controller
+        return if @content_mode
+
+        template "controller.rb.tt", File.join("app/controllers/content", "#{plural_file_name}_controller.rb")
+      end
+
+      def create_views
+        return if @content_mode
+
+        empty_directory view_directory
+
+        actions.each do |action|
+          template "#{action}.html.erb.tt", File.join(view_directory, "#{action}.html.erb")
+        end
+      end
+
+      def create_content_directory
+        return if @content_mode
+
+        FileUtils.mkdir_p(content_directory)
+      end
+
+      def create_pages_root
+        return if @content_mode
+        return unless pages_controller?
+
+        template "root.erb.tt", File.join(content_directory, "root.erb")
+      end
+
+      def add_content_route
+        return if @content_mode
+
+        route "resources :#{plural_file_name}, module: :content, only: %w[#{actions.join(" ")}]"
+      end
+
+      def add_root_route
+        return if @content_mode
+        return unless pages_controller?
+        return if root_route_exists?
+
+        inject_into_file "config/routes.rb", "  root to: \"content/pages#root\"\n", before: /^\s*end\s*$/
+      end
+
+      private
+
+      def file_name
+        options[:force_plural] ? super.pluralize : super.singularize
+      end
+
+      def class_name
+        options[:force_plural] ? super.pluralize : super.singularize
+      end
+
+      def view_directory = File.join(destination_root, "app", "views", "content", plural_file_name)
+
+      def content_directory = File.join(destination_root, "app", "content", plural_file_name)
+
+      def plural_class_name = plural_name.camelize
+
+      def pages_controller? = plural_file_name == "pages"
+
+      def root_route_exists?
+        routes = File.join(destination_root, "config", "routes.rb")
+
+        return false unless File.exist?(routes)
+
+        File.read(routes).match?(/\broot\s+to:/)
+      end
+
+      def template_file
+        @template_file ||= Dir.glob(File.join(content_directory, "{YYYY-MM-DD-,}template.*.tt")).first
+      end
+
+      def filename_from_template
+        @filename_from_template ||= begin
+          return "untitled.md" unless template_file
+
+          File.basename(template_file, ".tt").tap do |name|
+            name.gsub!("YYYY-MM-DD", Time.current.strftime("%Y-%m-%d"))
+            name.sub!("template", @content_title ? @content_title.parameterize : "untitled")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/perron/collection.rb

@@ -16,17 +16,12 @@ module Perron
     end
 
     def all(resource_class = "Content::#{name.classify}".safe_constantize)
-      allowed_extensions = Perron.configuration.allowed_extensions.map { ".#{it}" }.to_set
-
-      Dir.glob("#{@collection_path}/**/*.*")
-        .select { allowed_extensions.include?(File.extname(it)) }
-        .map { resource_class.new(it) }
-        .select(&:published?)
+      load_resources(resource_class).select(&:published?)
     end
     alias_method :resources, :all
 
     def find(slug, resource_class = Resource)
-      resource = all(resource_class).find { it.slug == slug }
+      resource = load_resources(resource_class).find { it.slug == slug }
 
       return resource if resource
 
@@ -40,5 +35,15 @@ module Perron
     end
 
     def validate = Perron::Site::Validate.new(collections: [self]).validate
+
+    private
+
+    def load_resources(resource_class = "Content::#{name.classify}".safe_constantize)
+      allowed_extensions = Perron.configuration.allowed_extensions.map { ".#{it}" }.to_set
+
+      Dir.glob("#{@collection_path}/**/*.*")
+        .select { allowed_extensions.include?(File.extname(it)) }
+        .map { resource_class.new(it) }
+    end
   end
 end

data/lib/perron/configuration.rb

@@ -16,8 +16,6 @@ module Perron
       @config.site_name = nil
       @config.site_description = nil
 
-      @config.site_email = nil
-
       @config.output = "output"
 
       @config.mode = :standalone

data/lib/perron/content/data.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Content
+  module Data
+    def self.const_missing(name)
+      klass = Class.new(Perron::Data) do
+        def self.const_missing(nested_name) = const_set(nested_name, Class.new(Perron::Data))
+      end
+
+      const_set(name, klass)
+    end
+  end
+end

data/lib/perron/data.rb

@@ -13,6 +13,17 @@ module Perron
     end
 
     class << self
+      def all
+        parts = name.to_s.split("::").drop(2)
+        identifier = parts.empty? ? name.demodulize.underscore : parts.map(&:underscore).join("/")
+
+        new(identifier)
+      end
+
+      def find(id)
+        all.find { it[:id] == id || it["id"] == id }
+      end
+
       def path_for(identifier)
         path = Pathname.new(identifier)
 
@@ -107,6 +118,8 @@ module Perron
 
       def [](key) = @attributes[key.to_sym]
 
+      def association_value(key) = self[key]
+
       def to_partial_path
         @to_partial_path ||= begin
           identifier = @identifier.to_s

data/lib/perron/deprecator.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Perron
+  def self.deprecator
+    @deprecator ||= ActiveSupport::Deprecation.new("1.0", "Perron")
+  end
+end

data/lib/perron/engine.rb

@@ -1,15 +1,22 @@
 # frozen_string_literal: true
 
+require "perron/output_server"
+
 module Perron
   class Engine < Rails::Engine
     initializer "perron.default_url_options" do |app|
       app.config.action_controller.default_url_options = Perron.configuration.default_url_options
     end
 
+    initializer "perron.output_server" do |app|
+      app.middleware.use Perron::OutputServer
+    end
+
     rake_tasks do
       load File.expand_path("../tasks/build.rake", __FILE__)
-      load File.expand_path("../tasks/validate.rake", __FILE__)
+      load File.expand_path("../tasks/clobber.rake", __FILE__)
       load File.expand_path("../tasks/sync_sources.rake", __FILE__)
+      load File.expand_path("../tasks/validate.rake", __FILE__)
     end
   end
 end

data/lib/perron/output_server.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Perron
+  class OutputServer
+    def initialize(app)
+      @app = app
+    end
+
+    def call(environment)
+      return @app.call(environment) if disabled?
+
+      static_file(environment).then do |file|
+        file ? serve(file) : @app.call(environment)
+      end
+    end
+
+    private
+
+    def disabled? = !enabled?
+
+    def static_file(environment)
+      request_path = Rack::Request.new(environment).path_info
+      file_path = File.join(output_path, request_path, "index.html")
+
+      File.file?(file_path) ? file_path : nil
+    end
+
+    def serve(file_path)
+      content = File.read(file_path)
+
+      [
+        200,
+
+        {
+          "Content-Type" => "text/html; charset=utf-8",
+          "Content-Length" => content.bytesize.to_s
+        },
+
+        [content]
+      ]
+    end
+
+    def enabled? = Dir.exist?(output_path)
+
+    def output_path
+      @output_path ||= Rails.root.join(Perron.configuration.output)
+    end
+  end
+end

data/lib/perron/resource/associations.rb

@@ -22,11 +22,11 @@ module Perron
           define_method(association_name) do
             cache_has_many_association(association_name) do
               associated_class = association_class_for(association_name, singularize: true, **options)
-              foreign_key = foreign_key_for(inverse_association_name, **options)
-              primary_key_method = options.fetch(:primary_key, :slug)
-              lookup_value = public_send(primary_key_method)
+              ids_key = "#{association_name}_ids"
 
-              associated_class.all.select { |record| record.metadata[foreign_key] == lookup_value }
+              metadata[ids_key] ?
+                records_for_ids(associated_class, metadata[ids_key]) :
+                records_for_foreign_key(associated_class, association_name, **options)
             end
           end
         end
@@ -41,6 +41,10 @@ module Perron
         @belongs_to_cache[name] = yield
       end
 
+      def foreign_key_for(base_name, **options)
+        (options[:foreign_key] || "#{base_name}_id").to_s
+      end
+
       def cache_has_many_association(name)
         @has_many_cache ||= {}
         return @has_many_cache[name] if @has_many_cache.key?(name)
@@ -49,18 +53,28 @@ module Perron
       end
 
       def association_class_for(association_name, singularize: false, **options)
-        class_name = options[:class_name] || begin
+        if options[:class_name]
+          options[:class_name].to_s.constantize
+        else
           name = association_name.to_s
           name = name.singularize if singularize
 
-          "Content::#{name.classify}"
+          "Content::#{name.classify}".constantize
         end
+      end
 
-        class_name.constantize
+      def records_for_ids(associated_class, ids)
+        ids = Array(ids)
+
+        associated_class.all.select { ids.include?(it[:id]) || ids.include?(it["id"]) }
       end
 
-      def foreign_key_for(base_name, **options)
-        (options[:foreign_key] || "#{base_name}_id").to_s
+      def records_for_foreign_key(associated_class, association_name, **options)
+        foreign_key = foreign_key_for(inverse_association_name, **options)
+        primary_key_method = options.fetch(:primary_key, :slug)
+        lookup_value = public_send(primary_key_method)
+
+        associated_class.all.select { it.association_value(foreign_key) == lookup_value }
       end
 
       def inverse_association_name = self.class.name.demodulize.underscore

data/lib/perron/resource/previewable.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Perron
+  class Resource
+    module Previewable
+      extend ActiveSupport::Concern
+
+      included do
+        def previewable?
+          frontmatter.preview.present? && (draft? || scheduled?)
+        end
+        alias_method :preview?, :previewable?
+
+        def preview_token
+          return nil unless previewable?
+
+          @preview_token ||= if frontmatter.preview == true
+            Digest::SHA256.hexdigest(file_path)[0..11]
+          else
+            frontmatter.preview
+          end
+        end
+      end
+    end
+  end
+end

data/lib/perron/resource/publishable.rb

@@ -16,8 +16,16 @@ module Perron
           true
         end
 
+        def buildable?
+          published? || previewable?
+        end
+
         def scheduled? = publication_date&.after?(Time.current)
 
+        def draft?
+          frontmatter.draft == true || frontmatter.published == false
+        end
+
         def publication_date
           @publication_date ||= begin
             from_meta = frontmatter.published_at.present? ? begin

data/lib/perron/resource/slug.rb

@@ -15,8 +15,9 @@ module Perron
       def create
         return "/" if Perron.configuration.allowed_extensions.any? { @resource.filename == "root.#{it}" }
 
-        @frontmatter.slug.presence ||
-          @resource.filename.sub(/^[\d-]+-/, "").delete_suffixes(dot_prepended_allowed_extensions)
+        base_slug = @frontmatter.slug.presence || @resource.filename.sub(/^[\d-]+-/, "").delete_suffixes(dot_prepended_allowed_extensions)
+
+        [base_slug, @resource.preview_token].compact.join("-")
       end
 
       private

data/lib/perron/resource/sourceable.rb

@@ -40,7 +40,7 @@ module Perron
         end
 
         def combinations
-          datasets = source_names.map { Perron::Site.data.public_send(it) }
+          datasets = source_names.map { Perron::Data.new(it.to_s) }
 
           datasets.first.product(*datasets[1..])
         end
@@ -71,7 +71,8 @@ module Perron
             primary_key = options[:primary_key]
             singular_name = name.to_s.singularize
             identifier = frontmatter["#{singular_name}_#{primary_key}"]
-            hash[name] = Perron::Site.data.public_send(name).find { it.public_send(primary_key).to_s == identifier.to_s }
+
+            hash[name] = Perron::Data.new(name.to_s).find { it.public_send(primary_key).to_s == identifier.to_s }
           end
 
           Source.new(data)

data/lib/perron/resource.rb

@@ -5,6 +5,7 @@ require "perron/resource/core"
 require "perron/resource/class_methods"
 require "perron/resource/associations"
 require "perron/resource/metadata"
+require "perron/resource/previewable"
 require "perron/resource/publishable"
 require "perron/resource/reading_time"
 require "perron/resource/related"
@@ -27,6 +28,7 @@ module Perron
     include Perron::Resource::ReadingTime
     include Perron::Resource::Sourceable
     include Perron::Resource::Publishable
+    include Perron::Resource::Previewable
     include Perron::Resource::TableOfContent
 
     attr_reader :file_path, :id
@@ -64,6 +66,8 @@ module Perron
       render_inline_erb using: page_content
     end
 
+    def association_value(key) = metadata[key]
+
     def to_partial_path
       @to_partial_path ||= begin
         element = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(self.class.model_name))

data/lib/perron/site/builder/feeds/author.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Perron
+  module Site
+    class Builder
+      class Feeds
+        module Author
+          private
+
+          def author(resource)
+            author = resource.author || feed_configuration.author
+
+            Author.new(author) if author
+          end
+
+          class Author
+            def initialize(author)
+              @author = author
+            end
+
+            def name
+              @author.respond_to?(:metadata) ? @author.metadata.name : @author[:name]
+            end
+
+            def email
+              @author.respond_to?(:metadata) ? @author.metadata.email : @author[:email]
+            end
+
+            def url
+              @author.respond_to?(:metadata) ? @author.metadata.url : @author[:url]
+            end
+
+            def avatar
+              @author.respond_to?(:metadata) ? @author.metadata.avatar : @author[:avatar]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/perron/site/builder/feeds/json.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "json"
+require "perron/site/builder/feeds/author"
 
 module Perron
   module Site
     class Builder
       class Feeds
         class Json
+          include Feeds::Author
+
           def initialize(collection:)
             @collection = collection
             @configuration = Perron.configuration
@@ -27,6 +30,7 @@ module Perron
                     id: resource.id,
                     url: url.polymorphic_url(resource, ref: feed_configuration.ref).delete_suffix("?ref="),
                     date_published: resource.published_at&.iso8601,
+                    authors: authors(resource),
                     title: resource.metadata.title,
                     content_html: Perron::Markdown.render(resource.content)
                   }
@@ -48,6 +52,14 @@ module Perron
           end
 
           def feed_configuration = @collection.configuration.feeds.json
+
+          def authors(resource)
+            author = author(resource)
+
+            return nil unless author&.name
+
+            [{name: author.name, email: author.email, url: author.url, avatar: author.avatar}.compact].presence
+          end
         end
       end
     end

data/lib/perron/site/builder/feeds/rss.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "nokogiri"
+require "perron/site/builder/feeds/author"
 
 module Perron
   module Site
     class Builder
       class Feeds
         class Rss
+          include Feeds::Author
+
           def initialize(collection:)
             @collection = collection
             @configuration = Perron.configuration
@@ -29,6 +32,9 @@ module Perron
                         xml.guid resource.id
                         xml.link url.polymorphic_url(resource, ref: feed_configuration.ref).delete_suffix("?ref="), isPermaLink: true
                         xml.pubDate(resource.published_at&.rfc822)
+                        if (author = author(resource)) && author.email
+                          xml.author author.name ? "#{author.email} (#{author.name})" : author.email
+                        end
                         xml.title resource.metadata.title
                         xml.description { xml.cdata(Perron::Markdown.render(resource.content)) }
                       end

data/lib/perron/site/builder/paths.rb

@@ -12,7 +12,7 @@ module Perron
           @paths << routes.public_send(index_path) if routes.respond_to?(index_path)
 
           if routes.respond_to?(show_path)
-            @collection.all.each do |resource|
+            @collection.send(:load_resources).select(&:buildable?).each do |resource|
               root = resource.slug == "/"
 
               next if skip? root

data/lib/perron/site/builder.rb

@@ -31,6 +31,8 @@ module Perron
         Perron::Site::Builder::Sitemap.new(@output_path).generate
         Perron::Site::Builder::Feeds.new(@output_path).generate
 
+        output_preview_urls
+
         puts "\n✅ Build complete"
       end
 
@@ -43,6 +45,17 @@ module Perron
       end
 
       def render_page(path) = Perron::Site::Builder::Page.new(path).render
+
+      def output_preview_urls
+        previewable_resources = Perron::Site.collections.flat_map { it.send(:load_resources) }.select(&:previewable?)
+
+        if previewable_resources.any?
+          puts "\n🔒 Preview URLs:"
+          previewable_resources.each do |resource|
+            puts "   #{Rails.application.routes.url_helpers.polymorphic_url(resource, **Perron.configuration.default_url_options)}"
+          end
+        end
+      end
     end
   end
 end

data/lib/perron/site.rb

@@ -24,6 +24,8 @@ module Perron
     def collection(name) = Collection.new(name)
 
     def data(name = nil)
+      Perron.deprecator.deprecation_warning(:data, "Use Content::Data::ClassName instead, e.g. `Content::Data::Users.all`")
+
       (name && Perron::Data.new(name)) || Perron::Data::Proxy.new
     end
   end

data/lib/perron/tasks/clobber.rake

@@ -0,0 +1,12 @@
+namespace :perron do
+  desc "Remove compiled static output"
+  task clobber: :environment do
+    output_path = Rails.root.join(Perron.configuration.output)
+
+    if Dir.exist?(output_path)
+      FileUtils.rm_rf(output_path)
+
+      puts "Removed #{output_path}"
+    end
+  end
+end

data/lib/perron/version.rb

@@ -1,3 +1,3 @@
 module Perron
-  VERSION = "0.14.0"
+  VERSION = "0.16.0"
 end

data/lib/perron.rb

@@ -2,9 +2,11 @@
 
 require "perron/version"
 require "perron/configuration"
+require "perron/deprecator"
 require "perron/errors"
 require "perron/root"
 require "perron/site"
+require "perron/content/data"
 require "perron/resource"
 require "perron/markdown"
 require "perron/feeds"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: perron
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Rails Designer Developers
@@ -86,21 +86,23 @@ files:
 - bin/rails
 - bin/release
 - bin/setup
-- lib/generators/content/USAGE
-- lib/generators/content/content_generator.rb
-- lib/generators/content/templates/controller.rb.tt
-- lib/generators/content/templates/index.html.erb.tt
-- lib/generators/content/templates/model.rb.tt
-- lib/generators/content/templates/root.erb.tt
-- lib/generators/content/templates/show.html.erb.tt
 - lib/generators/perron/install_generator.rb
 - lib/generators/perron/templates/README.md.tt
 - lib/generators/perron/templates/initializer.rb.tt
+- lib/generators/rails/content/USAGE
+- lib/generators/rails/content/content_generator.rb
+- lib/generators/rails/content/templates/controller.rb.tt
+- lib/generators/rails/content/templates/index.html.erb.tt
+- lib/generators/rails/content/templates/model.rb.tt
+- lib/generators/rails/content/templates/root.erb.tt
+- lib/generators/rails/content/templates/show.html.erb.tt
 - lib/perron.rb
 - lib/perron/collection.rb
 - lib/perron/configuration.rb
+- lib/perron/content/data.rb
 - lib/perron/data.rb
 - lib/perron/data/proxy.rb
+- lib/perron/deprecator.rb
 - lib/perron/engine.rb
 - lib/perron/errors.rb
 - lib/perron/feeds.rb
@@ -111,6 +113,7 @@ files:
 - lib/perron/html_processor/target_blank.rb
 - lib/perron/markdown.rb
 - lib/perron/metatags.rb
+- lib/perron/output_server.rb
 - lib/perron/refinements/delete_suffixes.rb
 - lib/perron/resource.rb
 - lib/perron/resource/associations.rb
@@ -118,6 +121,7 @@ files:
 - lib/perron/resource/configuration.rb
 - lib/perron/resource/core.rb
 - lib/perron/resource/metadata.rb
+- lib/perron/resource/previewable.rb
 - lib/perron/resource/publishable.rb
 - lib/perron/resource/reading_time.rb
 - lib/perron/resource/related.rb
@@ -132,6 +136,7 @@ files:
 - lib/perron/site/builder.rb
 - lib/perron/site/builder/assets.rb
 - lib/perron/site/builder/feeds.rb
+- lib/perron/site/builder/feeds/author.rb
 - lib/perron/site/builder/feeds/json.rb
 - lib/perron/site/builder/feeds/rss.rb
 - lib/perron/site/builder/page.rb
@@ -140,6 +145,7 @@ files:
 - lib/perron/site/builder/sitemap.rb
 - lib/perron/site/validate.rb
 - lib/perron/tasks/build.rake
+- lib/perron/tasks/clobber.rake
 - lib/perron/tasks/sync_sources.rake
 - lib/perron/tasks/validate.rake
 - lib/perron/version.rb
@@ -164,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Rails-based static site generator
 test_files: []

data/lib/generators/content/USAGE

@@ -1,16 +0,0 @@
-Description:
-    Creates a new content model with specified actions
-
-Example:
-    rails generate content post
-
-    This will create:
-      - app/models/content/post.rb
-      - app/controllers/content/posts_controller.rb
-      - app/views/content/posts/index.html.erb
-      - app/views/content/posts/show.html.erb
-      - …and add `resource :posts, module: :content, only: %w[index show]` to `config/routes.rb`
-
-Arguments:
-    NAME: Name of the content model
-    actions: List of actions to generate (index or show)

data/lib/generators/content/content_generator.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-require "rails/generators/base"
-
-class ContentGenerator < Rails::Generators::NamedBase
-  source_root File.expand_path("templates", __dir__)
-
-  class_option :force_plural, type: :boolean, default: false, desc: "Forces the use of a plural model name and class"
-
-  argument :actions, type: :array, default: %w[index show], banner: "actions", desc: "Specify which actions to generate (index/show)"
-
-  def create_model
-    template "model.rb.tt", File.join("app/models/content", "#{file_name}.rb")
-  end
-
-  def create_controller
-    template "controller.rb.tt", File.join("app/controllers/content", "#{plural_file_name}_controller.rb")
-  end
-
-  def create_views
-    empty_directory view_directory
-
-    actions.each do |action|
-      template "#{action}.html.erb.tt", File.join(view_directory, "#{action}.html.erb")
-    end
-  end
-
-  def create_content_directory = FileUtils.mkdir_p(content_directory)
-
-  def create_pages_root
-    return unless pages_controller?
-
-    template "root.erb.tt", File.join(content_directory, "root.erb")
-  end
-
-  def add_content_route
-    route "resources :#{plural_file_name}, module: :content, only: %w[#{actions.join(" ")}]"
-  end
-
-  def add_root_route
-    return unless pages_controller?
-    return if root_route_exists?
-
-    inject_into_file "config/routes.rb", "  root to: \"content/pages#root\"\n", before: /^\s*end\s*$/
-  end
-
-  private
-
-  def file_name
-    options[:force_plural] ? super.pluralize : super.singularize
-  end
-
-  def class_name
-    options[:force_plural] ? super.pluralize : super.singularize
-  end
-
-  def view_directory = Rails.root.join("app", "views", "content", plural_file_name)
-
-  def content_directory = Rails.root.join("app", "content", plural_file_name)
-
-  def plural_class_name = plural_name.camelize
-
-  def pages_controller? = plural_file_name == "pages"
-
-  def root_route_exists?
-    routes = Rails.root.join("config", "routes.rb")
-
-    return false unless File.exist?(routes)
-
-    File.read(routes).match?(/\broot\s+to:/)
-  end
-end