lifer 0.10.1 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae7d44054aac227a4d75940cf8c6d30b46ba403780f5d8583d0db22dfd8cf36e
-  data.tar.gz: 7c8ac4e684afa95e23f22dc1b6ad0472391c3fc946a6b7bbbdf9acfbf46ac31d
+  metadata.gz: a63fea0c89c87889fa7aab9fc17e53385a562d2bf5bbca5aa552076acc31ed10
+  data.tar.gz: d158cad653234c27d4f17291f2a4511e3896684e148e5aa12206ffdef4403603
 SHA512:
-  metadata.gz: 464566f240f05e2c5e199582555ccecd9bc6449ad477d53adb24905d76e07b9f93c13d050f69cd6c5923f9f9434edca1d14b4d01d674c5b4148bb5d9c85723df
-  data.tar.gz: 270f4d8c20bc24b180ae474a6d62037b2f2347a4d9e25f7a4af207d0e85d6df66fec0f92a82f57248e05ac34966ba69ff542a30c9e36d4f90e99fe41a46eeba6
+  metadata.gz: 59974cefd0e30b280ff61b6e2d624aea02ddeb099afc97eff50796f208f09f1a8327a91004441b87f5e7b5ea1d66908f8ebd56c467d1e2bdddf7f4ed8d1faafe
+  data.tar.gz: b4b288d0a7dd6e1766bdd8dc6ea72b7851aabaaaf16eb6eaf3a1c11f6d14ef2a3d2f4f859c38f6c4ed6127afedb1655cf9b5f705ade2d22683eb3f27224f8589

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 ## Next
 
+## v0.11.0
+
+This release adds new functionality to our URI strategies, adding
+`URIStrategy#permalink`, to make support for pretty URI strategies (i.e. where
+entries all end in `/index.ext`) better and more compatible with web servers
+where `foo` is the "same thing" as `foo/index.html`.
+
+Example output filename:
+
+    /my/filename/index.html
+
+Expected permalink for this file using a pretty URI strategy:
+
+    /my/filename
+
+## v0.10.2
+
+This release resolves another bug in `Entry#summary` causing entries without
+full-stops within the truncation threshold to not be truncated with a "..."
+properly.
+
 ## v0.10.1
 
 This release resolves a bug with `Entry#summary`. When I originally implemented

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lifer (0.10.1)
+    lifer (0.11.0)
       i18n (< 2)
       kramdown (~> 2.4)
       liquid (~> 5.6, < 6)

data/lib/lifer/entry/markdown.rb

@@ -35,12 +35,12 @@ class Lifer::Entry::Markdown < Lifer::Entry
     text = raw_first_paragraph_text
     return text if text.length <= TRUNCATION_THRESHOLD
 
-    truncated_text = text[0..TRUNCATION_THRESHOLD]
-    if (index_of_final_fullstop = text.rindex ". ")
-      truncated_text[0..index_of_final_fullstop]
-    else
-      "%s..." % truncated_text
-    end
+    text = text[0..TRUNCATION_THRESHOLD]
+
+    # Index of the fullstop from the last complete sentence in the truncated
+    # text.
+    last_fullstop_index = text.rindex /(\.) /
+    last_fullstop_index ? text[0..last_fullstop_index] : "%s..." % text
   end
 
   # The title or a default title.

data/lib/lifer/entry.rb

@@ -194,9 +194,10 @@ module Lifer
           cached_permalink_variable,
           File.join(
             host,
-            Lifer::URIStrategy.find(collection.setting :uri_strategy)
+            Lifer::URIStrategy
+              .find(collection.setting :uri_strategy)
               .new(root: Lifer.root)
-              .output_file(self)
+              .permalink(self)
           )
         )
     end

data/lib/lifer/uri_strategy/pretty.rb

@@ -14,8 +14,15 @@ class Lifer::URIStrategy::Pretty < Lifer::URIStrategy
     basename = File.basename entry.file,
       Lifer::Utilities.file_extension(entry.file)
 
-    Pathname entry.file.to_s
+    entry.file.to_s
       .gsub(/#{root}[\/]{0,1}/, "")
-      .gsub(/#{basename}(\..+)/, "#{basename}/index.#{file_extension(entry)}")
+      .gsub(/#{basename}(\..+)/, "#{basename}#{pretty_part entry}")
   end
+
+  # @see Lifer::UriStrategy#permalink
+  def permalink(entry) = output_file(entry).gsub pretty_part(entry), ""
+
+  private
+
+  def pretty_part(entry) = "/index.#{file_extension(entry)}"
 end

data/lib/lifer/uri_strategy/pretty_root.rb

@@ -11,14 +11,28 @@ class Lifer::URIStrategy
 
     # @see Lifer::URIStrategy#output_file
     def output_file(entry)
-      basename = File.basename entry.file,
-        Lifer::Utilities.file_extension(entry.file)
+      if basename(entry) == "index"
+        "index.html"
+      else
+        "#{basename entry}#{pretty_part entry}"
+      end
+    end
 
-      if basename == "index"
-        Pathname "index.html"
+    # @see Lifer::UriStrategy#permalink
+    def permalink(entry)
+      if basename(entry) == "index"
+        "/"
       else
-        Pathname "#{basename}/index.#{file_extension(entry)}"
+        output_file(entry).gsub pretty_part(entry), ""
       end
     end
+
+    private
+
+    def basename(entry)
+      File.basename entry.file, Lifer::Utilities.file_extension(entry.file)
+    end
+
+    def pretty_part(entry) = "/index.#{file_extension(entry)}"
   end
 end

data/lib/lifer/uri_strategy/pretty_yyyy_mm_dd.rb

@@ -24,9 +24,16 @@
     basename = File.basename entry.file,
       Lifer::Utilities.file_extension(entry.file)
 
-    Pathname entry.file.to_s
+    entry.file.to_s
       .gsub(/#{root}[\/]{0,1}/, "")
-      .gsub(/#{basename}(\..+)/, "#{basename}/index.#{file_extension(entry)}")
+      .gsub(/#{basename}(\..+)/, "#{basename}#{pretty_part entry}")
       .gsub(DATE_REGEXP, "")
   end
+
+  # @see Lifer::UriStrategy#permalink
+  def permalink(entry) = output_file(entry).gsub pretty_part(entry), ""
+
+  private
+
+  def pretty_part(entry) = "/index.#{file_extension(entry)}"
 end

data/lib/lifer/uri_strategy/root.rb

@@ -11,7 +11,10 @@ class Lifer::URIStrategy
       basename = File.basename entry.file,
         Lifer::Utilities.file_extension(entry.file)
 
-      Pathname "#{basename}.#{file_extension(entry)}"
+      "#{basename}.#{file_extension(entry)}"
     end
+
+    # @see Lifer::UriStrategy#permalink
+    def permalink(entry) = output_file(entry)
   end
 end

data/lib/lifer/uri_strategy/simple.rb

@@ -10,8 +10,11 @@ class Lifer::URIStrategy::Simple < Lifer::URIStrategy
     basename = File.basename entry.file,
       Lifer::Utilities.file_extension(entry.file)
 
-    Pathname entry.file.to_s
+    entry.file.to_s
       .gsub(/#{root}[\/]{0,1}/, "")
       .gsub(/#{basename}(\..+)/, "#{basename}.#{file_extension(entry)}")
   end
+
+  # @see Lifer::UriStrategy#permalink
+  def permalink(entry) = output_file(entry)
 end

data/lib/lifer/uri_strategy.rb

@@ -39,6 +39,24 @@ class Lifer::URIStrategy
     raise NotImplementedError, I18n.t("shared.not_implemented_method")
   end
 
+  # This method should sometimes return the path to the file in the format
+  # specified by the current URI strategy. Of course, this depends on what the URI
+  # stategy is. For "pretty" strategies, the permalink may differ from the output
+  # filename. For example, the output file may point to
+  #
+  #    entry-name/index.html
+  #
+  # While the permalink like points to:
+  #
+  #    entry-name
+  #
+  # @raise [NotImplementedError] This method must be implemented on each
+  #   subclass.
+  # @return [String] The permalink to the built output file.
+  def permalink(entry)
+    raise NotImplementedError, I18n.t("shared.not_implemented_error")
+  end
+
   private
 
   def file_extension(entry) = entry.class.output_extension

data/lib/lifer/version.rb

@@ -1,3 +1,3 @@
 module Lifer
-  VERSION = "0.10.1"
+  VERSION = "0.11.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lifer
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.11.0
 platform: ruby
 authors:
 - benjamin wil
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-10 00:00:00.000000000 Z
+date: 2025-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
@@ -210,8 +210,8 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/benjaminwil/lifer/blob/v0.10.1/README.md
-  source_code_uri: https://github.com/benjaminwil/lifer/tree/v0.10.1
+  homepage_uri: https://github.com/benjaminwil/lifer/blob/v0.11.0/README.md
+  source_code_uri: https://github.com/benjaminwil/lifer/tree/v0.11.0
   changelog_uri: https://github.com/benjaminwil/lifer/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []