middleman-blog 4.1.0 → 4.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f743fdf5f36a7b8d557f705f36ec9eda56b07a9e1f00aa841e81efea01c79870
-  data.tar.gz: 6336688644973e8b3311f1b8685a4a41e6c2a4f95217ccdfb89170db983aa017
+  metadata.gz: 7c5a345f50c066864dda5b42af46442cf9ca240c0facdfd53b9ef51286b1bdb7
+  data.tar.gz: 198ba52cd58f09e38f62ed9853834eaafbb3cd39aeb939facc7c4b37e20c99cf
 SHA512:
-  metadata.gz: 96abca8c8cef038c1c97d7f2749b152be8c5c19e6ed9d36b1270a3178ba6912f1ec5d757e1d49a7c99963dc4ca897cc6bb29ed66f083c55874af8ff8dc084124
-  data.tar.gz: adf5d4268a645634c8350070791051d637f1494b0858f7856a0257267b5a884e0d386b4307c644f8e292098368f124876e03ed334267414a609e95c283a5758a
+  metadata.gz: 1d57a33a414d34a975ef901a81ab3bfd89765125701b52a856924a63c6cfb50b35050a2b7389ace9fb96fe4a74ae6c6aeba4ce99288e859f22866748deffc150
+  data.tar.gz: d8f216cf40da81e347a54456258cd6671d729b98838b44b22ef65a8ca6c8ecd3c1509bae8e8d561b815b18b53a3d43471c8e20ea737c57d3fffb10fcec046365

data/.gitattributes

@@ -0,0 +1,3 @@
+# Exclude test features and fixtures from language statistics
+features/** linguist-vendored
+fixtures/** linguist-vendored

data/.gitignore

@@ -6,7 +6,6 @@ pkg/*
 .DS_Store
 .rbenv-version
 .ruby-version
-.ruby-gemset
 tmp
 doc
 .yardoc
@@ -14,5 +13,4 @@ build/
 .sass-cache
 coverage
 .byebug_history
-bin/
-.config
+vendor/

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## 4.2.0
+
+* Add preserve_underscores_in_slugs option to control URL formatting (#393).
+* Fix summary separator behavior: article.body should only show content after separator (#395)
+* Add bulk alias functionality for automatic URL redirects (#396)
+
 ## 4.1.0
 
 * Migrate CI to GitHub Actions (#386).

data/Gemfile

@@ -19,10 +19,5 @@ gem 'cucumber', require: false
 gem 'rspec', require: false
 gem 'timecop', require: false
 
-# Optional dependencies, included for tests
-gem 'kramdown'
-gem 'rack'
-gem 'activesupport', RUBY_VERSION < '3.2' ? '~> 7.0' : '~> 8.0'
-
 # Code Quality
 gem 'simplecov', require: false

data/features/alias.feature

@@ -0,0 +1,41 @@
+Feature: Blog aliases
+
+  Scenario: Blog articles can have bulk aliases configured
+
+    Given the Server is running at "alias-app"
+
+    When I go to "/2024/03/14/pi-day.html"
+    Then I should see "This is a test article for pi day."
+
+    When I go to "/2024-03-14-pi-day.html"
+    Then I should see "You are being redirected."
+    And I should see "/2024/03/14/pi-day.html"
+
+    When I go to "/2024/03-14-pi-day"
+    Then I should see "You are being redirected."
+    And I should see "/2024/03/14/pi-day.html"
+
+  Scenario: Blog aliases work with prefix configuration
+
+    Given the Server is running at "alias-prefix-app"
+
+    When I go to "/blog/2024/01/15/prefix-test.html"
+    Then I should see "This article tests prefix functionality"
+
+    When I go to "/blog/2024-01-15-prefix-test.html"
+    Then I should see "You are being redirected."
+    And I should see "/blog/2024/01/15/prefix-test.html"
+
+    When I go to "/blog/archive/2024/prefix-test"
+    Then I should see "You are being redirected."
+    And I should see "/blog/2024/01/15/prefix-test.html"
+
+  Scenario: Empty aliases configuration generates no redirects
+
+    Given the Server is running at "blog-sources-app"
+
+    When I go to "/2011/01/01/new-article.html"
+    Then I should see "/2011/01/01/new-article.html"
+
+    When I go to "/2011-01-01-new-article.html"
+    Then I should see "Not Found"

data/features/summary.feature

@@ -1,5 +1,5 @@
 Feature: Article summary generation
-  Scenario: Article has no summary separator
+  Scenario: Article has standard summary separator
     Given the Server is running at "summary-app"
     When I go to "/index.html"
     Then I should see:
@@ -7,9 +7,20 @@ Feature: Article summary generation
       <p>Summary from article with separator.
       </p>
       """
-    Then I should not see "Extended part from article with separator."
+    And I should not see "Extended part from article with separator."
+    When I go to "/2011/01/01/article-with-standard-summary-separator.html"
+    Then I should see "Extended part from article with separator."
+    And I should not see "READMORE"
+    And I should not see "Summary from article with separator."
+
+  Scenario: Article has no summary separator
+    Given the Server is running at "summary-app"
+    When I go to "/index.html"
     Then I should see "<p>Summary from article with no separator.</p>"
     Then I should not see "Extended part from article with no separator."
+    When I go to "/2012/06/19/article-with-no-summary-separator.html"
+    And I should see "Summary from article with no separator."
+    Then I should see "Extended part from article with no separator."
 
   Scenario: Article has custom summary separator
     Given a fixture app "summary-app"
@@ -28,6 +39,10 @@ Feature: Article summary generation
       """
     Then I should not see "Extended part from article with custom separator."
     Then I should see "Extended part from article with separator."
+    When I go to "/2013/05/08/article-with-custom-separator.html"
+    And I should see "Extended part from article with custom separator."
+    Then I should not see "SPLIT_SUMMARY_BEFORE_THIS"
+    Then I should not see "Summary from article with custom separator."
 
   Scenario: Article has custom summary separator that's an HTML comment
     Given a fixture app "summary-app"
@@ -46,6 +61,10 @@ Feature: Article summary generation
       """
     Then I should not see "Extended part from article with HTML comment separator."
     Then I should see "Extended part from article with separator."
+    When I go to "/2016/05/21/article-with-comment-separator.html"
+    And I should see "Extended part from article with HTML comment separator."
+    Then I should not see "<!--more-->"
+    Then I should not see "Summary from article with HTML comment separator."
 
   Scenario: Using a custom summary generator
     Given a fixture app "summary-app"

data/fixtures/alias-app/config.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+activate :blog do |blog|
+  blog.sources = ':year-:month-:day-:title.html'
+  blog.permalink = ':year/:month/:day/:title.html'
+  blog.aliases = [
+    ':year-:month-:day-:title.html',
+    ':year/:month-:day-:title'
+  ]
+end

data/fixtures/alias-app/source/2024-03-14-pi-day.html.markdown

@@ -0,0 +1,7 @@
+---
+title: "Test Article"
+date: 2024-03-14
+layout: false
+---
+
+This is a test article for pi day.

data/fixtures/alias-app/source/index.html

@@ -0,0 +1 @@
+<h1>Blog</h1>

data/fixtures/alias-prefix-app/config.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+activate :blog do |blog|
+  blog.prefix = 'blog'
+  blog.sources = ':year-:month-:day-:title.html'
+  blog.permalink = ':year/:month/:day/:title.html'
+  blog.aliases = [
+    ':year-:month-:day-:title.html',
+    'archive/:year/:title'
+  ]
+end

data/fixtures/alias-prefix-app/source/blog/2024-01-15-prefix-test.html.markdown

@@ -0,0 +1,7 @@
+---
+title: "Prefix Test Article"
+date: 2024-01-15
+layout: false
+---
+
+This article tests prefix functionality with aliases.

data/fixtures/alias-prefix-app/source/index.html

@@ -0,0 +1 @@
+<h1>Blog with Prefix</h1>

data/fixtures/summary-app/source/layout.erb

@@ -0,0 +1,6 @@
+<!doctype html>
+<html>
+  <body>
+    <%= yield %>
+  </body>
+</html>

data/lib/middleman-blog/alias_pages.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+require 'middleman-core'
+require 'middleman-core/sitemap/resource'
+require 'middleman-blog/uri_templates'
+
+module Middleman
+  module Blog
+    ##
+    # A sitemap resource manipulator that adds alias/redirect pages to the sitemap
+    # for each blog article based on the configured alias patterns
+    ##
+    class AliasPages
+      include UriTemplates
+
+      ##
+      # Initialise Alias pages
+      #
+      # @param  app             [Object] Middleman app
+      # @param  blog_controller [Object] Blog controller
+      ##
+      def initialize(app, blog_controller)
+        @sitemap         = app.sitemap
+        @blog_controller = blog_controller
+        @blog_data       = blog_controller.data
+        @alias_patterns  = blog_controller.options.aliases || []
+        @alias_templates = @alias_patterns.map { |pattern| uri_template(pattern) }
+      end
+
+      ##
+      # Update the main sitemap resource list
+      #
+      # @param  resources [Array] Existing resources
+      # @return           [Array] Resources with alias pages added
+      ##
+      def manipulate_resource_list(resources)
+        return resources if @alias_patterns.empty?
+
+        alias_resources = []
+
+        @blog_data.articles.each do |article|
+          @alias_templates.each do |template|
+            alias_path = generate_alias_path(template, article)
+            next if alias_path == article.destination_path # Don't create alias to itself
+
+            alias_resources << alias_page_resource(alias_path, article)
+          end
+        end
+
+        resources + alias_resources
+      end
+
+      private
+
+      ##
+      # Generate an alias path for an article using the given template
+      #
+      # @param  template [Addressable::Template] URI template for the alias
+      # @param  article  [BlogArticle] The blog article
+      # @return [String] The generated alias path
+      ##
+      def generate_alias_path(template, article)
+        # Get the same parameters used for the main permalink
+        params = permalink_options(article)
+        apply_uri_template(template, params)
+      end
+
+      ##
+      # Generate permalink options for an article (same as BlogData uses)
+      #
+      # @param  article [BlogArticle] The blog article
+      # @return [Hash] Parameters for URL generation
+      ##
+      def permalink_options(article)
+        # Get variables from all alias templates
+        all_variables = @alias_templates.flat_map(&:variables).uniq
+        
+        # Allow any frontmatter data to be substituted into the alias URL
+        page_data = article.metadata[:page] || {}
+        params = page_data.slice(*all_variables.map(&:to_sym))
+
+        params.each do |k, v|
+          params[k] = safe_parameterize(v)
+        end
+
+        params
+          .merge(date_to_params(article.date))
+          .merge(lang: article.lang.to_s, locale: article.locale.to_s, title: article.slug)
+      end
+
+      ##
+      # Create an alias page resource that redirects to the main article
+      #
+      # @param  alias_path [String] The path for the alias
+      # @param  article    [BlogArticle] The target article
+      # @return [Sitemap::Resource] A redirect resource
+      ##
+      def alias_page_resource(alias_path, article)
+        target_url = article.destination_path
+        # Ensure target URL starts with '/' for absolute URLs
+        target_url = "/#{target_url}" unless target_url.start_with?('/')
+        AliasResource.new(@sitemap, alias_path, target_url, article)
+      end
+    end
+
+    ##
+    # A resource that generates redirect HTML for alias pages
+    ##
+    class AliasResource < ::Middleman::Sitemap::Resource
+      def initialize(store, path, target_url, alias_resource)
+        @target_url = target_url
+        @alias_resource = alias_resource
+        super(store, path)
+      end
+
+      def source_file
+        @alias_resource.source_file
+      end
+
+      def template?
+        false
+      end
+
+      def render(*args, &block)
+        %[
+          <html>
+            <head>
+              <link rel="canonical" href="#{@target_url}" />
+              <meta name="robots" content="noindex,follow" />
+              <meta http-equiv="cache-control" content="no-cache" />
+              <script>
+                // Attempt to keep search and hash
+                window.location.replace("#{@target_url}"+window.location.search+window.location.hash);
+              </script>
+              <meta http-equiv=refresh content="0; url=#{@target_url}" />
+            </head>
+            <body>
+              <a href="#{@target_url}">You are being redirected.</a>
+            </body>
+          </html>
+        ]
+      end
+
+      def binary?
+        false
+      end
+
+      def raw_data
+        @alias_resource.raw_data
+      end
+
+      def ignored?
+        false
+      end
+
+      def metadata
+        @alias_resource.metadata
+      end
+    end
+  end
+end

data/lib/middleman-blog/blog_article.rb

@@ -57,7 +57,14 @@ module Middleman
 
         content = super(opts, locs, &block)
 
-        content.sub!(blog_options.summary_separator, '') unless opts[:keep_separator]
+        # Handle summary separator: if not keeping separator and separator exists,
+        # return only content after separator
+        if blog_options.summary_separator && !opts[:keep_separator]
+          if content.match?(blog_options.summary_separator)
+            require 'middleman-blog/truncate_html'
+            content = TruncateHTML.content_after_separator(content, blog_options.summary_separator)
+          end
+        end
 
         content
       end
@@ -238,13 +245,13 @@ module Middleman
       ##
       def slug
         if data['slug']
-          Blog::UriTemplates.safe_parameterize(data['slug'])
+          Blog::UriTemplates.safe_parameterize(data['slug'], preserve_underscores: blog_options.preserve_underscores_in_slugs)
 
         elsif blog_data.source_template.variables.include?('title')
-          Blog::UriTemplates.safe_parameterize(path_part('title'))
+          Blog::UriTemplates.safe_parameterize(path_part('title'), preserve_underscores: blog_options.preserve_underscores_in_slugs)
 
         elsif title
-          Blog::UriTemplates.safe_parameterize(title)
+          Blog::UriTemplates.safe_parameterize(title, preserve_underscores: blog_options.preserve_underscores_in_slugs)
 
         else
           raise "Can't generate a slug for #{path} because it has no :title in its path pattern or title/slug in its frontmatter."

data/lib/middleman-blog/blog_data.rb

@@ -209,7 +209,7 @@ module Middleman
         params = resource.metadata[:page].slice(*@permalink_template.variables.map(&:to_sym))
 
         params.each do |k, v|
-          params[k] = safe_parameterize(v)
+          params[k] = safe_parameterize(v, preserve_underscores: @options.preserve_underscores_in_slugs)
         end
 
         params

data/lib/middleman-blog/commands/article.rb

@@ -67,7 +67,6 @@ module Middleman
         @content = options[:content] || ''
         @date    = options[:date] ? ::Time.zone.parse(options[:date]) : Time.zone.now
         @locale  = options[:locale] || (::I18n.default_locale if defined? ::I18n)
-        @slug    = safe_parameterize(title)
         @tags    = options[:tags]&.split(/\s*,\s*/) || []
         @title   = title
 
@@ -90,6 +89,9 @@ module Middleman
           throw msg
         end
 
+        # Generate slug after we have access to blog options
+        @slug = safe_parameterize(title, preserve_underscores: blog_inst.options.preserve_underscores_in_slugs)
+
         path_template         = blog_inst.data.source_template
         params                = date_to_params(@date).merge(locale: @locale.to_s, title: @slug)
         article_path          = apply_uri_template path_template, params

data/lib/middleman-blog/custom_pages.rb

@@ -23,7 +23,7 @@ module Middleman
       #
       # @param [String] value
       def link(value)
-        apply_uri_template @link_template, property => safe_parameterize(value)
+        apply_uri_template @link_template, property => safe_parameterize(value, preserve_underscores: @blog_controller.options.preserve_underscores_in_slugs)
       end
 
       def manipulate_resource_list(resources)

data/lib/middleman-blog/extension.rb

@@ -41,8 +41,10 @@ module Middleman
     option :publish_future_dated, false, 'Whether articles with a date in the future should be considered published'
     option :custom_collections, {}, 'Hash of custom frontmatter properties to collect articles on and their options (link, template)'
     option :preserve_locale, false, 'Use the global Middleman I18n.locale instead of the lang in the article\'s frontmatter'
+    option :preserve_underscores_in_slugs, false, 'Whether to preserve underscores in article slugs instead of converting them to dashes'
     option :new_article_template, File.expand_path('commands/article.tt', __dir__), 'Path (relative to project root) to an ERb template that will be used to generate new articles from the "middleman article" command.'
     option :default_extension, '.markdown', 'Default template extension for articles (used by "middleman article")'
+    option :aliases, [], 'Array of URL patterns that should redirect to the main permalink (e.g., [":year-:month-:day-:title.html"])'
 
     # @return [BlogData] blog data for this blog, which has all information about the blog articles
     attr_reader :data
@@ -62,6 +64,9 @@ module Middleman
     # @return [Hash<CustomPages>] custom pages handlers for this blog, indexed by property name
     attr_reader :custom_pages
 
+    # @return [AliasPages] alias page handler for this blog
+    attr_reader :alias_pages
+
     # Helpers for use within templates and layouts.
     self.defined_helpers = [Middleman::Blog::Helpers]
 
@@ -94,6 +99,11 @@ module Middleman
       options.custom_collections.each_value do |opts|
         opts[:link] = File.join(options.prefix, opts[:link])
       end
+
+      # Apply prefix to alias patterns if specified
+      unless options.aliases.nil? || options.aliases.empty?
+        options.aliases = options.aliases.map { |alias_pattern| File.join(options.prefix, alias_pattern) }
+      end
     end
 
     def after_configuration
@@ -157,6 +167,12 @@ module Middleman
         @app.sitemap.register_resource_list_manipulator(:"blog_#{name}_paginate", @paginator)
       end
 
+      unless options.aliases.nil? || options.aliases.empty?
+        require 'middleman-blog/alias_pages'
+        @alias_pages = Blog::AliasPages.new(@app, self)
+        @app.sitemap.register_resource_list_manipulator(:"blog_#{name}_aliases", @alias_pages)
+      end
+
       logger.info "== Blog Sources: #{options.sources} (:prefix + :sources)"
     end
 

data/lib/middleman-blog/tag_pages.rb

@@ -33,7 +33,7 @@ module Middleman
       # @return     [String] Safe Tag URL
       ##
       def link(tag)
-        apply_uri_template @tag_link_template, tag: safe_parameterize(tag)
+        apply_uri_template @tag_link_template, tag: safe_parameterize(tag, preserve_underscores: @blog_controller.options.preserve_underscores_in_slugs)
       end
 
       ##

data/lib/middleman-blog/truncate_html.rb

@@ -15,6 +15,20 @@ module TruncateHTML
     doc.inner_html
   end
 
+  def self.content_after_separator(text, separator)
+    text = text.encode('UTF-8') if text.respond_to?(:encode)
+    parts = text.split(separator, 2)
+    
+    if parts.length >= 2
+      # Take the last part (which should be after the separator)
+      content_after = parts.last
+      doc = Nokogiri::HTML::DocumentFragment.parse content_after
+      doc.inner_html
+    else
+      text
+    end
+  end
+
   def self.truncate_at_length(text, max_length, ellipsis = '...')
     ellipsis_length = ellipsis.length
     text = text.encode('UTF-8') if text.respond_to?(:encode)

data/lib/middleman-blog/uri_templates.rb

@@ -54,13 +54,13 @@ module Middleman
       # Reimplementation of this, preserves un-transliterate-able multibyte chars.
       #
       # @see http://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-parameterize
-      def safe_parameterize(str, sep = '-')
+      def safe_parameterize(str, separator: '-', preserve_underscores: false)
         # Remove ending ?
         str = str.to_s.gsub(/\?$/, '')
 
         # Reimplementation of http://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-parameterize that preserves un-transliterate-able multibyte chars.
         parameterized_string = ::ActiveSupport::Inflector.transliterate(str.to_s).downcase
-        parameterized_string.gsub!(/[^a-z0-9\-_?]+/, sep)
+        parameterized_string.gsub!(/[^a-z0-9\-_?]+/, separator)
 
         # Check for multibytes and sub back in
         parameterized_string.chars.to_a.each_with_index do |char, i|
@@ -69,16 +69,16 @@ module Middleman
           parameterized_string[i] = str[i]
         end
 
-        re_sep = ::Regexp.escape(sep)
+        re_sep = ::Regexp.escape(separator)
 
         # No more than one of the separator in a row.
-        parameterized_string.gsub!(/#{re_sep}{2,}/, sep)
+        parameterized_string.gsub!(/#{re_sep}{2,}/, separator)
 
         # Remove leading/trailing separator.
         parameterized_string.gsub!(/^#{re_sep}|#{re_sep}$/, '')
 
-        # Replace all _ with -
-        parameterized_string.tr!('_', '-')
+        # Replace all _ with - (unless preserve_underscores is true)
+        parameterized_string.tr!('_', '-') unless preserve_underscores
 
         # Delete all ?
         parameterized_string.delete!('?')

data/lib/middleman-blog/version.rb

@@ -2,6 +2,6 @@
 
 module Middleman
   module Blog
-    VERSION = '4.1.0'
+    VERSION = '4.2.0'
   end
 end

data/spec/alias_spec.rb

@@ -0,0 +1,116 @@
+require 'middleman-blog/alias_pages'
+require 'middleman-blog/uri_templates'
+
+describe 'Middleman::Blog::AliasPages' do
+  include Middleman::Blog::UriTemplates
+
+  let(:mock_app) { double('app') }
+  let(:mock_sitemap) { double('sitemap') }
+  let(:mock_blog_controller) { double('blog_controller') }
+  let(:mock_blog_data) { double('blog_data') }
+  let(:mock_article) { double('article') }
+  let(:mock_options) { double('options') }
+
+  before do
+    allow(mock_app).to receive(:sitemap).and_return(mock_sitemap)
+    allow(mock_blog_controller).to receive(:data).and_return(mock_blog_data)
+    allow(mock_blog_controller).to receive(:options).and_return(mock_options)
+    allow(mock_article).to receive(:destination_path).and_return('2024/03/14/pi-day.html')
+    allow(mock_article).to receive(:date).and_return(Date.new(2024, 3, 14))
+    allow(mock_article).to receive(:slug).and_return('pi-day')
+    allow(mock_article).to receive(:lang).and_return(:en)
+    allow(mock_article).to receive(:locale).and_return(:en)
+    allow(mock_article).to receive(:metadata).and_return({ page: {} })
+  end
+
+  describe 'alias URL generation' do
+    let(:alias_patterns) { [':year-:month-:day-:title.html', ':year/:month-:day-:title'] }
+
+    before do
+      allow(mock_options).to receive(:aliases).and_return(alias_patterns)
+      allow(mock_blog_data).to receive(:articles).and_return([mock_article])
+    end
+
+    context 'when testing alias path generation' do
+      let(:alias_pages) { Middleman::Blog::AliasPages.new(mock_app, mock_blog_controller) }
+
+      it 'generates correct alias paths from patterns' do
+        template1 = uri_template(':year-:month-:day-:title.html')
+        template2 = uri_template(':year/:month-:day-:title')
+        
+        # Test path generation directly
+        alias_path1 = alias_pages.send(:generate_alias_path, template1, mock_article)
+        alias_path2 = alias_pages.send(:generate_alias_path, template2, mock_article)
+        
+        expect(alias_path1).to eq('2024-03-14-pi-day.html')
+        expect(alias_path2).to eq('2024/03-14-pi-day')
+      end
+
+      it 'filters out aliases that match main permalink' do
+        # Test with an alias pattern that would match the main permalink
+        template = uri_template(':year/:month/:day/:title.html')
+        
+        alias_path = alias_pages.send(:generate_alias_path, template, mock_article)
+        expect(alias_path).to eq('2024/03/14/pi-day.html')
+        
+        # This would be filtered out in manipulate_resource_list because it matches destination_path
+        expect(alias_path).to eq(mock_article.destination_path)
+      end
+    end
+
+    context 'when testing permalink options generation' do
+      let(:alias_pages) { Middleman::Blog::AliasPages.new(mock_app, mock_blog_controller) }
+
+      it 'generates correct permalink options from article data' do
+        params = alias_pages.send(:permalink_options, mock_article)
+        
+        expect(params[:year]).to eq('2024')
+        expect(params[:month]).to eq('03')
+        expect(params[:day]).to eq('14')
+        expect(params[:title]).to eq('pi-day')
+        expect(params[:lang]).to eq('en')
+        expect(params[:locale]).to eq('en')
+      end
+    end
+  end
+
+  describe 'empty aliases configuration' do
+    before do
+      allow(mock_options).to receive(:aliases).and_return([])
+      allow(mock_blog_data).to receive(:articles).and_return([mock_article])
+    end
+
+    it 'returns original resources when aliases array is empty' do
+      alias_pages = Middleman::Blog::AliasPages.new(mock_app, mock_blog_controller)
+      resources = ['existing_resource']
+      result = alias_pages.manipulate_resource_list(resources)
+      
+      # Should return the same resources since no aliases are configured
+      expect(result).to eq(resources)
+    end
+  end
+
+  describe 'alias pattern handling' do
+    before do
+      allow(mock_blog_data).to receive(:articles).and_return([mock_article])
+    end
+
+    it 'handles multiple alias patterns' do
+      patterns = [':year-:month-:day-:title.html', ':year/:month-:day-:title', 'archive/:title']
+      allow(mock_options).to receive(:aliases).and_return(patterns)
+      
+      alias_pages = Middleman::Blog::AliasPages.new(mock_app, mock_blog_controller)
+      
+      # Test that all patterns are converted to templates
+      expect(alias_pages.instance_variable_get(:@alias_templates).length).to eq(3)
+    end
+
+    it 'handles nil alias patterns gracefully' do
+      allow(mock_options).to receive(:aliases).and_return(nil)
+      
+      expect {
+        Middleman::Blog::AliasPages.new(mock_app, mock_blog_controller)
+      }.not_to raise_error
+    end
+  end
+end

data/spec/uri_templates_spec.rb

@@ -26,6 +26,18 @@ describe 'Middleman::Blog::UriTemplates' do
     it 'can handle numbers' do
       expect(safe_parameterize(1)).to eq '1'
     end
+
+    it 'converts underscores to dashes by default' do
+      expect(safe_parameterize('name_of_article')).to eq 'name-of-article'
+    end
+
+    it 'can preserve underscores when requested' do
+      expect(safe_parameterize('name_of_article', preserve_underscores: true)).to eq 'name_of_article'
+    end
+
+    it 'still works with mixed content when preserving underscores' do
+      expect(safe_parameterize('Some MIXED_content', preserve_underscores: true)).to eq 'some-mixed_content'
+    end
   end
 
   describe 'extract_params' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: middleman-blog
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 4.2.0
 platform: ruby
 authors:
 - Thomas Reynolds
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-07 00:00:00.000000000 Z
+date: 2025-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: middleman-core
@@ -64,6 +64,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".editorconfig"
+- ".gitattributes"
 - ".github/CONTRIBUTING.md"
 - ".github/ISSUE_TEMPLATE.md"
 - ".github/workflows/ci.yml"
@@ -75,6 +76,7 @@ files:
 - LICENSE.md
 - README.md
 - Rakefile
+- features/alias.feature
 - features/article_dirs.feature
 - features/blog_sources.feature
 - features/calendar-and-tag.feature
@@ -102,6 +104,12 @@ files:
 - features/tags.feature
 - features/tags_multiblog.feature
 - features/time_zone.feature
+- fixtures/alias-app/config.rb
+- fixtures/alias-app/source/2024-03-14-pi-day.html.markdown
+- fixtures/alias-app/source/index.html
+- fixtures/alias-prefix-app/config.rb
+- fixtures/alias-prefix-app/source/blog/2024-01-15-prefix-test.html.markdown
+- fixtures/alias-prefix-app/source/index.html
 - fixtures/article-dirs-app/config-directory-indexes.rb
 - fixtures/article-dirs-app/config-permalink-with-dot.rb
 - fixtures/article-dirs-app/config.rb
@@ -306,6 +314,7 @@ files:
 - fixtures/summary-app/source/2013-05-08-article-with-custom-separator.html.markdown
 - fixtures/summary-app/source/2016-05-21-article-with-comment-separator.html.markdown
 - fixtures/summary-app/source/index.html.erb
+- fixtures/summary-app/source/layout.erb
 - fixtures/tags-app/config-directory-indexes.rb
 - fixtures/tags-app/config-filters.rb
 - fixtures/tags-app/config-no-tags.rb
@@ -332,6 +341,7 @@ files:
 - fixtures/time-zone-app/config.rb
 - fixtures/time-zone-app/source/blog/2013-06-24-hello.html.erb
 - lib/middleman-blog.rb
+- lib/middleman-blog/alias_pages.rb
 - lib/middleman-blog/blog_article.rb
 - lib/middleman-blog/blog_data.rb
 - lib/middleman-blog/calendar_pages.rb
@@ -347,6 +357,7 @@ files:
 - lib/middleman-blog/version.rb
 - lib/middleman_extension.rb
 - middleman-blog.gemspec
+- spec/alias_spec.rb
 - spec/spec_helper.rb
 - spec/uri_templates_spec.rb
 homepage: https://github.com/middleman/middleman-blog
@@ -368,11 +379,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: Blog engine for Middleman
 test_files:
+- features/alias.feature
 - features/article_dirs.feature
 - features/blog_sources.feature
 - features/calendar-and-tag.feature
@@ -400,6 +412,12 @@ test_files:
 - features/tags.feature
 - features/tags_multiblog.feature
 - features/time_zone.feature
+- fixtures/alias-app/config.rb
+- fixtures/alias-app/source/2024-03-14-pi-day.html.markdown
+- fixtures/alias-app/source/index.html
+- fixtures/alias-prefix-app/config.rb
+- fixtures/alias-prefix-app/source/blog/2024-01-15-prefix-test.html.markdown
+- fixtures/alias-prefix-app/source/index.html
 - fixtures/article-dirs-app/config-directory-indexes.rb
 - fixtures/article-dirs-app/config-permalink-with-dot.rb
 - fixtures/article-dirs-app/config.rb
@@ -604,6 +622,7 @@ test_files:
 - fixtures/summary-app/source/2013-05-08-article-with-custom-separator.html.markdown
 - fixtures/summary-app/source/2016-05-21-article-with-comment-separator.html.markdown
 - fixtures/summary-app/source/index.html.erb
+- fixtures/summary-app/source/layout.erb
 - fixtures/tags-app/config-directory-indexes.rb
 - fixtures/tags-app/config-filters.rb
 - fixtures/tags-app/config-no-tags.rb