perron 0.13.3 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebff05f1548f6e133cde9cdfc40ba692d65a52d548cdf47df78b16b52d072b49
-  data.tar.gz: 8fcf6d0a11a8ed4b7426c11473d1d8d791a329cd47417d072434b8a1d28e8c6c
+  metadata.gz: f86f6e49cb1954ed51dc8aa0c2b6cfdaf3f1fcc3c78141b36c837f0eef26a9c8
+  data.tar.gz: efaff555c00579430812ca06e3ee6a87376db403321ab302762b393356d7607a
 SHA512:
-  metadata.gz: fcb6b264a9d159852991f67803bf9f8e666d535a87dc8f12cd82e87362ce326ec3cfa47c0681bfa13e83889e7374fbfe3289d86674b7f8c120971c34969928a0
-  data.tar.gz: 45f0d1fd94a3152d396e64ef8178639fffdd527d8a7fc3c50318578cc71684587fa4622aa99f8b3cc347cf8729460d0d6853e22e0d07122c3b88de01c18c444d
+  metadata.gz: c7e7c64d77fac8aadb06e3fc3541db5f8593a571938c12020dcbcb03e3f968dd326eede32b06342843df4b0e84e8722b4beb95b5d202283539b763ba3db01ada
+  data.tar.gz: 1a3f470b3412fa9187bca282ee1ac051cd1674c34a19a761b6cdedf901f0e5e2e6bb2c1a025ffadf1e2f478fcf13b9f8a90ab29579d46ae0cf3594099b13fb5d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    perron (0.13.3)
+    perron (0.15.0)
       csv
       json
       psych

data/README.md

@@ -1,6 +1,6 @@
 # Perron
 
-A Rails-based static site generator.
+Static Site Generator for Ruby on Rails. Build with Rails. Deploy static sites.
 
 **Sponsored By [Rails Designer](https://railsdesigner.com/)**
 

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/perron/templates/README.md.tt

@@ -1,37 +1,25 @@
 # Data
 
-Perron can consume structured data from YML, JSON, or CSV files, making them available within your templates.
-This is useful for populating features, team members, or any other repeated data structure.
+Perron can consume structured data from YML, JSON, or CSV files, making them available within your templates. This is useful for populating features, team members, or any other repeated data structure.
 
 
 ## Usage
 
-To use a data file, you can access it through the `Perron::Site.data` object followed by the basename of the file:
+To use a data file, instantiate `Perron::Site.data` with the basename of the file and iterate over the result.
 ```erb
 <%% Perron::Site.data.features.each do |feature| %>
   <h4><%%= feature.name %></h4>
-
-  <p><%%= feature.description %></p>
-<%% end %>
-```
-
-This is a convenient shorthand for `Perron::Data.new("features")`, which can also be used directly:
-```ruby
-<%% Perron::Data.new("features").each do |feature| %>
-  <h4><%%= feature.name %></h4>
-
   <p><%%= feature.description %></p>
 <%% end %>
 ```
 
 
-## File Location and Formats
+## File location and formats
 
-By default, Perron looks up `app/content/data/` for files with a `.yml`, `.json`, or `.csv` extension.
-For a `new("features")` call, it would find `features.yml`, `features.json`, or `features.csv`. You can also provide a full, absolute path to any data file, like `Perron::Data.new("path-to-some-data-file")`.
+By default, Perron looks up `app/content/data/` for files with a `.yml`, `.json`, or `.csv` extension. For a `features` call, it would find `features.yml`, `features.json`, or `features.csv`. You can also provide a path to any data file, via `Perron::Data.new("path/to/data.json")`.
 
 
-## Accessing Data
+## Accessing data
 
 The wrapper object provides flexible, read-only access to each record's attributes. Both dot notation and hash-like key access are supported.
 ```ruby

data/lib/generators/perron/templates/initializer.rb.tt

@@ -1,7 +1,7 @@
 Perron.configure do |config|
   # config.output = "output"
 
-  # config.site_name = "Helptail"
+  # config.site_name = "Chirp Form"
 
   # The build mode for Perron. Can be :standalone or :integrated
   # config.mode = :standalone
@@ -16,8 +16,8 @@ Perron.configure do |config|
 
   # Set default meta values
   # Examples:
-  # - `config.metadata.description = "Put your routine tasks on autopilot"`
-  # - `config.metadata.author = "Helptail Team"`
+  # - `config.metadata.description = "Add forms to any static site. Display responses anywhere."`
+  # - `config.metadata.author = "Chirp Form Team"`
 
   # Set meta title suffix
   # config.metadata.title_suffix = nil

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/engine.rb

@@ -9,6 +9,7 @@ module Perron
     rake_tasks do
       load File.expand_path("../tasks/build.rake", __FILE__)
       load File.expand_path("../tasks/validate.rake", __FILE__)
+      load File.expand_path("../tasks/sync_sources.rake", __FILE__)
     end
   end
 end

data/lib/perron/markdown.rb

@@ -17,39 +17,69 @@ module Perron
         @parser ||= markdown_parser
       end
 
-      def markdown_parser
-        if defined?(::Commonmarker)
-          CommonMarkerParser.new
-        elsif defined?(::Kramdown)
-          KramdownParser.new
-        elsif defined?(::Redcarpet)
-          RedcarpetParser.new
+      def configured_parser
+        return unless (parser_name = Perron.configuration.markdown_parser)
+        class_name = parser_name.to_s.camelize
+        class_name += "Parser" unless class_name.end_with?("Parser")
+
+        klass = if const_defined?(class_name)
+          const_get(class_name)
+        elsif Object.const_defined?(class_name)
+          Object.const_get(class_name)
         else
-          PlainTextParser.new
+          raise "Can't find parser #{parser_name} by class name #{class_name}"
+        end
+
+        unless klass.available?
+          raise "Parser #{parser_name} #{class_name} is not available (gem not installed?)"
         end
+
+        klass
       end
-    end
 
-    class CommonMarkerParser
-      def parse(text) = Commonmarker.to_html(text, **Perron.configuration.markdown_options)
+      def available_parser = Parser.descendants.find(&:available?) || Parser
+
+      def markdown_parser
+        (configured_parser || available_parser).new(**Perron.configuration.markdown_options)
+      end
     end
 
-    class KramdownParser
-      def parse(text) = Kramdown::Document.new(text, Perron.configuration.markdown_options).to_html
+    class Parser
+      attr_reader :options
+
+      def initialize(**options)
+        @options = options
+      end
+
+      def parse(text) = text.to_s
+
+      def self.available? = true
     end
 
-    class RedcarpetParser
-      def parse(text)
-        options = Perron.configuration.markdown_options
-        renderer = Redcarpet::Render::HTML.new(options.fetch(:renderer_options, {}))
-        markdown = Redcarpet::Markdown.new(renderer, options.fetch(:markdown_options, {}))
+    class RedcarpetParser < Parser
+      def renderer
+        @renderer ||= Redcarpet::Render::HTML.new(options.fetch(:renderer_options, {}))
+      end
 
-        markdown.render(text)
+      def markdown
+        @markdown ||= Redcarpet::Markdown.new(renderer, options.fetch(:markdown_options, {}))
       end
+
+      def parse(text) = markdown.render(text)
+
+      def self.available? = defined?(::Redcarpet)
     end
 
-    class PlainTextParser
-      def parse(text) = text.to_s
+    class KramdownParser < Parser
+      def parse(text) = Kramdown::Document.new(text, options).to_html
+
+      def self.available? = defined?(::Kramdown)
+    end
+
+    class CommonMarkerParser < Parser
+      def parse(text) = Commonmarker.to_html(text, **options)
+
+      def self.available? = defined?(::Commonmarker)
     end
   end
 end

data/lib/perron/resource/associations.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Perron
+  class Resource
+    module Associations
+      extend ActiveSupport::Concern
+
+      class_methods do
+        def belongs_to(association_name, **options)
+          define_method(association_name) do
+            cache_belongs_to_association(association_name) do
+              associated_class = association_class_for(association_name, **options)
+              foreign_key = foreign_key_for(association_name, **options)
+              identifier = metadata[foreign_key]
+
+              identifier ? associated_class.find(identifier) : nil
+            end
+          end
+        end
+
+        def has_many(association_name, **options)
+          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)
+
+              associated_class.all.select { |record| record.metadata[foreign_key] == lookup_value }
+            end
+          end
+        end
+      end
+
+      private
+
+      def cache_belongs_to_association(name)
+        @belongs_to_cache ||= {}
+        return @belongs_to_cache[name] if @belongs_to_cache.key?(name)
+
+        @belongs_to_cache[name] = yield
+      end
+
+      def cache_has_many_association(name)
+        @has_many_cache ||= {}
+        return @has_many_cache[name] if @has_many_cache.key?(name)
+
+        @has_many_cache[name] = yield
+      end
+
+      def association_class_for(association_name, singularize: false, **options)
+        class_name = options[:class_name] || begin
+          name = association_name.to_s
+          name = name.singularize if singularize
+
+          "Content::#{name.classify}"
+        end
+
+        class_name.constantize
+      end
+
+      def foreign_key_for(base_name, **options)
+        (options[:foreign_key] || "#{base_name}_id").to_s
+      end
+
+      def inverse_association_name = self.class.name.demodulize.underscore
+    end
+  end
+end

data/lib/perron/resource/metadata.rb

@@ -49,10 +49,14 @@ module Perron
         return @frontmatter[:canonical_url] if @frontmatter[:canonical_url]
         return Rails.application.routes.url_helpers.root_url(**Perron.configuration.default_url_options) if @resource.slug == "/"
 
-        Rails.application.routes.url_helpers.polymorphic_url(
-          @resource,
+        begin
+          Rails.application.routes.url_helpers.polymorphic_url(
+            @resource,
           **Perron.configuration.default_url_options
-        )
+          )
+        rescue
+          false
+        end
       end
 
       def site_data

data/lib/perron/resource/previewable.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Perron
+  class Resource
+    module Previewable
+      extend ActiveSupport::Concern
+
+      included do
+        def previewable?
+          frontmatter.preview.present? && (draft? || scheduled?)
+        end
+
+        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/reading_time.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Perron
+  class Resource
+    module ReadingTime
+      extend ActiveSupport::Concern
+
+      def estimated_reading_time(wpm: DEFAULT_WORDS_PER_MINUTE, format: DEFAULT_FORMAT)
+        word_count = content.scan(/\b[a-zA-Z]+\b/).size
+        total_minutes = [(word_count.to_f / wpm).ceil, 1].max
+
+        hours = total_minutes / 60
+        minutes = total_minutes % 60
+        seconds = ((word_count.to_f / wpm) * 60).to_i % 60
+
+        return total_minutes if format.blank?
+
+        format % {
+          minutes: minutes,
+          total_minutes: total_minutes,
+          hours: hours,
+          seconds: seconds,
+          min: minutes,
+          h: hours,
+          s: seconds
+        }
+      end
+      alias_method :reading_time, :estimated_reading_time
+
+      private
+
+      DEFAULT_WORDS_PER_MINUTE = 200
+      DEFAULT_FORMAT = "%{minutes} min read"
+    end
+  end
+end

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

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Perron
+  class Resource
+    module Sourceable
+      extend ActiveSupport::Concern
+
+      class_methods do
+        def sources(*arguments)
+          @source_definitions = parsed(*arguments)
+        end
+        alias_method :source, :sources
+
+        def source_definitions
+          @source_definitions || {}
+        end
+
+        def source_names = source_definitions.keys
+
+        def generate_from_sources!
+          return unless source_backed?
+
+          combinations.each do |combo|
+            content = content_with combo
+            filename = filename_with combo
+
+            FileUtils.mkdir_p(output_dir)
+            File.write(output_dir.join("#{filename}.erb"), content)
+          end
+        end
+
+        def source_backed? = source_names.any?
+
+        private
+
+        def parsed(*arguments)
+          return {} if arguments.empty?
+
+          arguments.flat_map { it.is_a?(Hash) ? it.to_a : [[it, {primary_key: :id}]] }.to_h
+        end
+
+        def combinations
+          datasets = source_names.map { Perron::Site.data.public_send(it) }
+
+          datasets.first.product(*datasets[1..])
+        end
+
+        def content_with(combo)
+          data = source_names.each.with_index.to_h { |name, index| [name, combo[index]] }
+          sources = Source.new(data)
+
+          source_template(sources)
+        end
+
+        def filename_with(combo)
+          source_names.each_with_index.map do |name, index|
+            primary_key = source_definitions[name][:primary_key]
+
+            combo[index].public_send(primary_key)
+          end.join("-")
+        end
+
+        def output_dir = Perron.configuration.input.join(model_name.collection)
+      end
+
+      def source_backed? = self.class.source_backed?
+
+      def sources
+        @sources ||= begin
+          data = self.class.source_definitions.each_with_object({}) do |(name, options), hash|
+            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 }
+          end
+
+          Source.new(data)
+        end
+      end
+
+      def source_template(sources)
+        raise NotImplementedError, "#{self.class.name} must implement #source_template"
+      end
+
+      class Source
+        def initialize(data)
+          @data = data
+        end
+
+        def method_missing(name, *arguments, &block)
+          return super if arguments.any? || block
+          return @data[name] if @data.key?(name)
+
+          super
+        end
+
+        def respond_to_missing?(name, _) = @data.key?(name)
+      end
+      private_constant :Source
+    end
+  end
+end

data/lib/perron/resource.rb

@@ -3,12 +3,16 @@
 require "perron/resource/configuration"
 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"
 require "perron/resource/renderer"
 require "perron/resource/slug"
 require "perron/resource/separator"
+require "perron/resource/sourceable"
 require "perron/resource/table_of_content"
 
 module Perron
@@ -20,7 +24,11 @@ module Perron
     include Perron::Resource::Configuration
     include Perron::Resource::Core
     include Perron::Resource::ClassMethods
+    include Perron::Resource::Associations
+    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

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

@@ -25,7 +25,7 @@ module Perron
                 items: resources.map do |resource|
                   {
                     id: resource.id,
-                    url: url.polymorphic_url(resource),
+                    url: url.polymorphic_url(resource, ref: feed_configuration.ref).delete_suffix("?ref="),
                     date_published: resource.published_at&.iso8601,
                     title: resource.metadata.title,
                     content_html: Perron::Markdown.render(resource.content)

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

@@ -27,7 +27,7 @@ module Perron
                     resources.each do |resource|
                       xml.item do
                         xml.guid resource.id
-                        xml.link url.polymorphic_url(resource), isPermaLink: true
+                        xml.link url.polymorphic_url(resource, ref: feed_configuration.ref).delete_suffix("?ref="), isPermaLink: true
                         xml.pubDate(resource.published_at&.rfc822)
                         xml.title resource.metadata.title
                         xml.description { xml.cdata(Perron::Markdown.render(resource.content)) }

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/validate.rb

@@ -19,11 +19,13 @@ module Perron
 
         puts [
           "Validation finished",
-          (" with #{@failures.count} failures" if @failures.any?),
+          (" with #{@failures.count} failures" if failed?),
           "."
         ].join
       end
 
+      def failed? = @failures.any?
+
       private
 
       Failure = ::Data.define(:identifier, :errors)

data/lib/perron/tasks/sync_sources.rake

@@ -0,0 +1,12 @@
+namespace :perron do
+  desc "Sync source-backed resources"
+  task :sync_sources, [:name] => :environment do |_, arguments|
+    Rails.application.eager_load!
+
+    resource_classes = arguments.name ? ["Content::#{arguments.name.classify}".constantize] : Perron::Resource.descendants
+
+    resource_classes.compact.each do |resource_class|
+      resource_class.generate_from_sources! if resource_class.source_backed?
+    end
+  end
+end

data/lib/perron/tasks/validate.rake

@@ -1,6 +1,6 @@
 namespace :perron do
   desc "Validate all site resources"
   task validate: :environment do
-    Perron::Site.validate
+    abort if Perron::Site::Validate.new.tap(&:validate).failed?
   end
 end

data/lib/perron/version.rb

@@ -1,3 +1,3 @@
 module Perron
-  VERSION = "0.13.3"
+  VERSION = "0.15.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: perron
 version: !ruby/object:Gem::Version
-  version: 0.13.3
+  version: 0.15.0
 platform: ruby
 authors:
 - Rails Designer Developers
@@ -86,16 +86,16 @@ 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
@@ -113,16 +113,20 @@ files:
 - lib/perron/metatags.rb
 - lib/perron/refinements/delete_suffixes.rb
 - lib/perron/resource.rb
+- lib/perron/resource/associations.rb
 - lib/perron/resource/class_methods.rb
 - 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
 - lib/perron/resource/related/stop_words.rb
 - lib/perron/resource/renderer.rb
 - lib/perron/resource/separator.rb
 - lib/perron/resource/slug.rb
+- lib/perron/resource/sourceable.rb
 - lib/perron/resource/table_of_content.rb
 - lib/perron/root.rb
 - lib/perron/site.rb
@@ -137,6 +141,7 @@ files:
 - lib/perron/site/builder/sitemap.rb
 - lib/perron/site/validate.rb
 - lib/perron/tasks/build.rake
+- lib/perron/tasks/sync_sources.rake
 - lib/perron/tasks/validate.rake
 - lib/perron/version.rb
 - perron.gemspec
@@ -160,7 +165,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.1
 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