lifer 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea41a2cd1a058f5a103121b6b7641ce5857ec74300ecad4bb36ec33578170650
-  data.tar.gz: f752dc7498a0457945d895fc591eefc7a27a296e01a5b547264a13fd8113c3b5
+  metadata.gz: f1d33c1f633f27b80005a2e2e7c1919f43d86a5fdba9f12523dd4dcdb4e47422
+  data.tar.gz: 37927e9a39b49363ee0de3f34294c4e8ccf82b83a7a73b8d86ebc1bae8243947
 SHA512:
-  metadata.gz: 4665579521538df261c0839f6c1a7ee6b24362ca75c03cc6d8fbf42dfffa028ad0bc39c1fe01ef2407459cb1be6bdf9d08e60cd5abacd1e233b0819bbcab6186
-  data.tar.gz: e1bfbd9fa63bd2de10022f2b5810cfcf518acc5112f51bb843c19c936bc269436807a606c335ab90693bafac53569315b0bfcbe245b9c8570a56ff6ab60af6f0
+  metadata.gz: db511f0ace1e617851b7e4de0fd12f9a615c283db318d3c05013cdadbae40ab89cd6be06bc429f4c443caf5d1c67f1d385276f4596788eadbfe3d22916e9c20d
+  data.tar.gz: 917d189530c40b4c15fb57a9d1bfce28a809b00fd07267b5a2485997adcb8c3e557dcf242def3a515297b908a5000902a1e7fcbe4bff29240791a88681b2fa1f

data/CHANGELOG.md

@@ -1,5 +1,42 @@
 ## Next
 
+## v0.10.0
+
+These commits collect work to let all layout files (either Liquid or ERB files)
+provide a reference to parent, or "root", layout files that should wrap the via
+frontmatter.
+
+Previously, we did this for Liquid layouts using the custom `layout` tag. But
+because there was no equivalent tag for ERB files, I realized it would be less
+work to just provide the value via frontmatter. The same way for every type of
+layout file.
+
+End users (just me?) must update their Lifer project Liquid layouts accordingly:
+
+```diff
+- {% layout "layouts/root_layout.html.liquid" %}
++ ---
++ layout: layouts/root_layout.html.liquid
++ ---
+
+  Layout content.
+```
+
+## v0.9.0
+
+Atom feeds now support entries with both `#published_at` and `#updated_at`
+timestamp. There is no standard equivalent way to provide this functonality for
+RSS-format feeds, unfortunately. As part of this change, we removed all
+`Entry#date` methods in favour of `Entry#published_at` onces. In Atom feeds, if
+an article has no last updated date, the publication date is used instead.
+
+Additionally, this release includes a new environment variable:
+`LIFER_UNPARALLELIZED`. You can use this environment variable to run `lifer
+build` or `lifer serve` without any parallelization turned on. This could be
+useful for reproducing bugs and so on. Example usage:
+
+    LIFER_UNPARALLELIZED=1 lifer build
+
 ## v0.8.0
 
 ### Tags

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lifer (0.8.0)
+    lifer (0.10.0)
       i18n (< 2)
       kramdown (~> 2.4)
       liquid (~> 5.6, < 6)
@@ -32,9 +32,9 @@ GEM
       irb (~> 1.10)
       reline (>= 0.3.8)
     diff-lcs (1.5.1)
-    ffi (1.17.1-arm64-darwin)
-    ffi (1.17.1-x86_64-darwin)
-    ffi (1.17.1-x86_64-linux-gnu)
+    ffi (1.17.2-arm64-darwin)
+    ffi (1.17.2-x86_64-darwin)
+    ffi (1.17.2-x86_64-linux-gnu)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     io-console (0.7.2)
@@ -44,7 +44,7 @@ GEM
     kramdown (2.5.1)
       rexml (>= 3.3.9)
     language_server-protocol (3.17.0.3)
-    liquid (5.8.1)
+    liquid (5.8.6)
       bigdecimal
       strscan (>= 3.1.1)
     listen (3.9.0)
@@ -107,7 +107,7 @@ GEM
       sorbet-runtime (>= 0.5.10782)
     sorbet-runtime (0.5.11558)
     stringio (3.1.1)
-    strscan (3.1.2)
+    strscan (3.1.5)
     xpath (3.2.0)
       nokogiri (~> 1.8)
     yard (0.9.37)

data/lib/lifer/builder/html/from_any.rb

@@ -0,0 +1,66 @@
+class Lifer::Builder
+  class HTML
+    # A base class for all HTML builder adapters. The methods provided by this
+    # class are either required or reusable by builder subclasses. See the
+    # committed HTML builder adapter classes for example implementations.
+    class FromAny
+      class << self
+        # Build and render an entry.
+        #
+        # @param entry [Lifer::Entry] The entry to be rendered.
+        # @return [String] The rendered entry.
+        def build(entry:)
+          new(entry: entry).render
+        end
+      end
+
+      # The base class does not provide a render method, but any subclass
+      # should be expected to.
+      #
+      # @raise [NotImplementedError]
+      def render
+        raise NotImplementedError,
+          "subclasses must implement a custom `#render` method"
+      end
+
+      private
+
+      # The frontmatter provided by the layout file.
+      #
+      # @return [Hash] The frontmatter represented as a hash.
+      def frontmatter
+        return {} unless frontmatter?
+
+        Lifer::Utilities.symbolize_keys(
+          YAML.load layout_file_contents(raw: true)[Lifer::FRONTMATTER_REGEX, 1],
+            permitted_classes: [Time]
+        )
+      end
+
+      # Checks whether frontmatter is present in the layout file.
+      #
+      # @return [boolean]
+      def frontmatter?
+        @frontmatter ||=
+          layout_file_contents(raw: true).match?(Lifer::FRONTMATTER_REGEX)
+      end
+
+      # The contents of the layout file.
+      #
+      # @param raw [boolean] Whether to include or exclude frontmatter from
+      #   the contents.
+      # @return [String] The contents of the layout file.
+      def layout_file_contents(raw: false)
+        cache_variable = "@layout_file_contents_#{raw}"
+        cached_value = instance_variable_get cache_variable
+
+        return cached_value if cached_value
+
+        contents = File.read layout_file
+        contents = contents.gsub(Lifer::FRONTMATTER_REGEX, "") unless raw
+
+        instance_variable_set cache_variable, contents
+      end
+    end
+  end
+end

data/lib/lifer/builder/html/from_erb.rb

@@ -23,23 +23,21 @@ class Lifer::Builder::HTML
   #       </body>
   #     </html>
   #
-  class FromERB
-    class << self
-      # Build and render an entry.
-      #
-      # @param entry [Lifer::Entry] The entry to be rendered.
-      # @return [String] The rendered entry.
-      def build(entry:)
-        new(entry: entry).render
-      end
-    end
-
+  class FromERB < FromAny
     # Reads the entry as ERB, given our renderer context (see the documentation
     # for `#build_binding_context`) and renders the production-ready entry.
     #
     # @return [String] The rendered entry.
     def render
-      ERB.new(File.read layout_file).result context
+      document = ERB.new(layout_file_contents).result context
+
+      return document unless (relative_layout_path = frontmatter[:layout])
+
+      document_binding = binding.tap { |binding|
+        binding.local_variable_set :content, document
+      }
+      layout_path = "%s/%s" % [Lifer.root, relative_layout_path]
+      ERB.new(File.read layout_path).result(document_binding)
     end
 
     private

data/lib/lifer/builder/html/from_liquid/drops/entry_drop.rb

@@ -4,7 +4,9 @@ module Lifer::Builder::HTML::FromLiquid::Drops
   #
   # @example Usage
   #     <h1>{{ entry.title }}</h1>
-  #     <small>Published on <datetime>{{ entry.date }}</datetime></small>
+  #     <small>
+  #       Published on <datetime>{{ entry.published_at }}</datetime>
+  #     </small>
   #
   class EntryDrop < Liquid::Drop
     attr_accessor :lifer_entry, :collection
@@ -30,11 +32,6 @@ module Lifer::Builder::HTML::FromLiquid::Drops
     # @return [String]
     def content = (@content ||= lifer_entry.to_html)
 
-    # The entry date (as a string).
-    #
-    # @return [String]
-    def date = (@date ||= lifer_entry.date)
-
     # The entry frontmatter data.
     #
     # @return [FrontmatterDrop]
@@ -50,6 +47,11 @@ module Lifer::Builder::HTML::FromLiquid::Drops
     # @return [String] The entry permalink.
     def permalink = (@permalink ||= lifer_entry.permalink)
 
+    # The entry publication date (as a string).
+    #
+    # @return [String]
+    def published_at = (@published_at ||= lifer_entry.published_at)
+
     # The summary of the entry.
     #
     # @return [String] The summary of the entry.
@@ -59,5 +61,10 @@ module Lifer::Builder::HTML::FromLiquid::Drops
     #
     # @return [String] The entry title.
     def title = (@title ||= lifer_entry.title)
+
+    # The entry's last updated date (as a string).
+    #
+    # @return [String]
+    def updated_at = (@updated_at ||= lifer_entry.updated_at)
   end
 end

data/lib/lifer/builder/html/from_liquid/filters.rb

@@ -2,7 +2,7 @@
 # In many cases these utilities exist to be pseudo-compatible with Jekyll.
 #
 # @example A filter in a Liquid template.
-#     {{ entry.date | date_to_xmlschema }}
+#     {{ entry.published_at | date_to_xmlschema }}
 #
 module Lifer::Builder::HTML::FromLiquid::Filters
   # @!visibility private

data/lib/lifer/builder/html/from_liquid/liquid_env.rb

@@ -22,8 +22,6 @@ class Lifer::Builder::HTML::FromLiquid
           Liquid::LocalFileSystem.new(Lifer.root, "%s.html.liquid")
 
         environment.register_filter Lifer::Builder::HTML::FromLiquid::Filters
-        environment.register_tag "layout",
-          Lifer::Builder::HTML::FromLiquid::LayoutTag
       end
     end
   end

data/lib/lifer/builder/html/from_liquid.rb

@@ -1,10 +1,5 @@
 require "liquid"
 
-require_relative "from_liquid/drops"
-require_relative "from_liquid/filters"
-require_relative "from_liquid/layout_tag"
-require_relative "from_liquid/liquid_env"
-
 class Lifer::Builder::HTML
   # If the HTML builder is given a Liquid template, it uses this class to parse
   # the Liquid into HTML. Lifer project metadata is provided as context. For
@@ -28,16 +23,10 @@ class Lifer::Builder::HTML
   #       </body>
   #     </html>
   #
-  class FromLiquid
-    class << self
-      # Render and build a Lifer entry.
-      #
-      # @param entry [Lifer::Entry] The entry to render.
-      # @return [String] The rendered entry, ready for output.
-      def build(entry:) = new(entry:).render
-    end
-
-    attr_accessor :entry, :layout_file
+  class FromLiquid < FromAny
+    require_relative "from_liquid/drops"
+    require_relative "from_liquid/filters"
+    require_relative "from_liquid/liquid_env"
 
     # Reads the entry as Liquid, given our document context, and renders
     # an entry.
@@ -49,13 +38,23 @@ class Lifer::Builder::HTML
           .parse(entry.to_html, **parse_options)
           .render(context, **render_options)
       )
+      document = Liquid::Template
+        .parse(layout_file_contents, **parse_options)
+        .render(document_context, **render_options)
+
+      return document unless (relative_layout_path = frontmatter[:layout])
+
+      layout_path = "%s/%s" % [Lifer.root, relative_layout_path]
+      document_context = context.merge! "content" => document
       Liquid::Template
-        .parse(layout, **parse_options)
+        .parse(File.read layout_path, **parse_options)
         .render(document_context, **render_options)
     end
 
     private
 
+    attr_accessor :entry, :layout_file
+
     def initialize(entry:)
       @entry = entry
       @layout_file = entry.collection.layout_file
@@ -79,19 +78,6 @@ class Lifer::Builder::HTML
       }
     end
 
-    # @private
-    # It's possible for the provided layout to request a parent layout, which
-    # makes this method a bit complicated.
-    #
-    # @return [String] A Liquid layout document, ready for parsing.
-    def layout
-      contents = File.read layout_file
-
-      return contents unless contents.match?(/\{%\s*#{LayoutTag::NAME}.*%\}/)
-
-      contents + "\n{% #{LayoutTag::ENDNAME} %}"
-    end
-
     def liquid_environment = (@liquid_environment ||= LiquidEnv.global)
 
     def parse_options
@@ -103,6 +89,7 @@ class Lifer::Builder::HTML
 
     def render_options
       {
+        registers: {file_system: liquid_environment.file_system},
         strict_variables: true,
         strict_filters: true
       }

data/lib/lifer/builder/html.rb

@@ -33,6 +33,7 @@ require "fileutils"
 class Lifer::Builder::HTML < Lifer::Builder
   self.name = :html
 
+  require_relative "html/from_any"
   require_relative "html/from_erb"
   require_relative "html/from_liquid"
 

data/lib/lifer/builder/rss.rb

@@ -65,8 +65,7 @@ class Lifer::Builder::RSS < Lifer::Builder
   # The name of the format type, as needed by `RSS::Maker`, used by default by
   # this feed builder.
   #
-  DEFAULT_MAkER_FORMAT_NAME = FORMATS[:rss]
-
+  DEFAULT_MAKER_FORMAT_NAME = FORMATS[:rss]
 
   self.name = :rss
   self.settings = [
@@ -96,7 +95,7 @@ class Lifer::Builder::RSS < Lifer::Builder
 
     return FORMATS[format] if FORMATS.keys.include? format
 
-    DEFAULT_MAkER_FORMAT_NAME
+    DEFAULT_MAKER_FORMAT_NAME
   end
 
   # Traverses and renders an RSS feed for feedable collection.
@@ -220,8 +219,21 @@ class Lifer::Builder::RSS < Lifer::Builder
       rss_feed_item.link = lifer_entry.permalink
       rss_feed_item.title = lifer_entry.title
       rss_feed_item.summary = lifer_entry.summary
-      rss_feed_item.updated = Time.now.to_s
-      rss_feed_item.content_encoded = lifer_entry.to_html
+
+      if feed_format(lifer_entry.collection) == "atom"
+        rss_feed_item.content.content = lifer_entry.to_html
+        rss_feed_item.published = lifer_entry.published_at
+
+        # Note: RSS does not provide a standard way to share last updated
+        # timestamps at all, while Atom does. This is the reason there is no
+        # equivalent call in the condition for RSS feeds.
+        #
+        rss_feed_item.updated =
+          lifer_entry.updated_at(fallback: lifer_entry.published_at)
+      else
+        rss_feed_item.content_encoded = lifer_entry.to_html
+        rss_feed_item.pubDate = lifer_entry.published_at.to_time.rfc2822
+      end
     end
   end
 

data/lib/lifer/collection.rb

@@ -57,9 +57,9 @@ class Lifer::Collection
         cached_entries_variable,
         case order
         when :latest
-          @entries_collection.sort_by { |entry| entry.date }.reverse
+          @entries_collection.sort_by { |entry| entry.published_at }.reverse
         when :oldest
-          @entries_collection.sort_by { |entry| entry.date }
+          @entries_collection.sort_by { |entry| entry.published_at }
         end
       )
   end

data/lib/lifer/entry.rb

@@ -39,10 +39,6 @@ module Lifer
     #
     FILENAME_DATE_FORMAT = /^(\d{4}-\d{1,2}-\d{1,2})-/
 
-    # We expect frontmatter to be provided in the following format.
-    #
-    FRONTMATTER_REGEX = /^---\n(.*)---\n/m
-
     # If tags are represented in YAML frontmatter as a string, they're split on
     # commas and/or spaces.
     #
@@ -147,27 +143,7 @@ module Lifer
     def body
       return full_text.strip unless frontmatter?
 
-      full_text.gsub(FRONTMATTER_REGEX, "").strip
-    end
-
-    # Since text files would only store dates as simple strings, it's nice to
-    # attempt to convert those into Ruby date or datetime objects.
-    #
-    # @return [Time] A Ruby representation of the date and time provided by the
-    #   entry frontmatter or filename.
-    def date
-      date_data = frontmatter[:date] || filename_date
-
-      case date_data
-      when Time then date_data
-      when String then DateTime.parse(date_data).to_time
-      else
-        Lifer::Message.log("entry.no_date_metadata", filename: file)
-        Lifer::Entry::DEFAULT_DATE
-      end
-    rescue ArgumentError => error
-      Lifer::Message.error("entry.date_error", filename: file, error:)
-      Lifer::Entry::DEFAULT_DATE
+      full_text.gsub(Lifer::FRONTMATTER_REGEX, "").strip
     end
 
     def feedable?
@@ -188,7 +164,8 @@ module Lifer
       return {} unless frontmatter?
 
       Lifer::Utilities.symbolize_keys(
-        YAML.load(full_text[FRONTMATTER_REGEX, 1], permitted_classes: [Time])
+        YAML.load full_text[Lifer::FRONTMATTER_REGEX, 1],
+          permitted_classes: [Time]
       )
     end
 
@@ -232,6 +209,27 @@ module Lifer
     # @return [String] The absolute URI path to the entry.
     def path = permalink(host: "/")
 
+    # The entry's publication date. The published date can be inferred in a few
+    # ways. The priority is:
+    #
+    #    1. the frontmatter's `published_at` field
+    #    2. the frontmatter's `published` field
+    #    3. the frontamtter's `date` field
+    #    4. The date in the filename.
+    #
+    # Since text files would only store dates as simple strings, it's nice to
+    # attempt to convert those into Ruby date or datetime objects.
+    #
+    # @return [Time] A Ruby representation of the date and time provided by the
+    #   entry frontmatter or filename.
+    def published_at
+      date_for frontmatter[:published_at],
+        frontmatter[:published],
+        frontmatter[:date],
+        filename_date,
+        missing_metadata_translation_key: "entry.no_published_at_metadata"
+    end
+
     # If given a summary in the frontmatter of the entry, we can use this to
     # provide a summary.
     #
@@ -263,6 +261,26 @@ module Lifer
       raise NotImplementedError, I18n.t("shared.not_implemented_method")
     end
 
+    # The entry's last updated date. In the frontmatter, the last updated date
+    # can be specified using one of two fields. In priority order:
+    #
+    #    1. the `updated_at` field
+    #    2. the `updated` field
+    #
+    # The developer could set a fallback value as a fallback. For example, when
+    # building RSS feeds one might want the value of `#published_at` if there is
+    # no last updated date.
+    #
+    # @param fallback [Time, String, NilClass] Provide datetime data, a string
+    #   that parses to a datetime object, or nil.
+    # @return [Time] A Ruby representation of the date and time provided by the
+    #   entry frontmatter.
+    def updated_at(fallback: nil)
+      date_for frontmatter[:updated_at],
+        frontmatter[:updated],
+        default_date: fallback
+    end
+
     private
 
     # It is conventional for users to use spaces or commas to delimit tags in
@@ -278,12 +296,33 @@ module Lifer
       end.uniq
     end
 
+    def date_for(
+      *candidate_date_fields,
+      default_date: Lifer::Entry::DEFAULT_DATE,
+      missing_metadata_translation_key: nil
+    )
+      date_data = candidate_date_fields.detect(&:itself)
+
+      case date_data
+      when Time then date_data
+      when String then DateTime.parse(date_data).to_time
+      else
+        if (translation_string = missing_metadata_translation_key)
+          Lifer::Message.log(translation_string, filename: file)
+        end
+        default_date
+      end
+    rescue ArgumentError => error
+      Lifer::Message.error("entry.date_error", filename: file, error:)
+      default_date
+    end
+
     def filename_date
       return unless file && File.basename(file).match?(FILENAME_DATE_FORMAT)
 
       File.basename(file).match(FILENAME_DATE_FORMAT)[1]
     end
 
-    def frontmatter? = (full_text && full_text.match?(FRONTMATTER_REGEX))
+    def frontmatter? = (full_text && full_text.match?(Lifer::FRONTMATTER_REGEX))
   end
 end

data/lib/lifer/utilities.rb

@@ -76,7 +76,10 @@ module Lifer::Utilities
     # @raise [Exception] Any exception thrown by a child process.
     # @return [Array] The mapped results of the operation.
     def parallelized(collection, &block)
-      results = Parallel.map(collection) do |collection_item|
+      options = {}
+      options[:in_threads] = 0 if Lifer.parallelism_disabled?
+
+      results = Parallel.map(collection, **options) do |collection_item|
         begin
           yield collection_item
         rescue => error

data/lib/lifer/version.rb

@@ -1,3 +1,3 @@
 module Lifer
-  VERSION = "0.8.0"
+  VERSION = "0.10.0"
 end

data/lib/lifer.rb

@@ -24,6 +24,10 @@ module Lifer
     "(\\/\\.)+"   # Contains a dot directory.
   ] | IGNORE_DIRECTORIES.map { |d| "^(#{d})" }
 
+  # We expect frontmatter in any file to be provided in the following format.
+  #
+  FRONTMATTER_REGEX = /^---\n(.*)---\n/m
+
   class << self
     # The first time `Lifer.brain` is referenced, we build a new `Lifer::Brain`
     # object that is used and reused until the current process has ended.
@@ -96,6 +100,16 @@ module Lifer
     #   project would be built to.
     def output_directory = brain.output_directory
 
+    # Returns false if the Lifer project will be built with parallelism. This
+    # should return false almost always--unless you've explicitly set the
+    # `LIFER_UNPARALLELIZED` environment variable before running the program.
+    #
+    # This method is used internally by Lifer to determine whether features that
+    # would normally run in parallel should *not* run in parallel for some reason.
+    #
+    # @return [boolean] Returns whether parallelism is disabled.
+    def parallelism_disabled? = ENV["LIFER_UNPARALLELIZED"].is_a?(String)
+
     # Register new settings so that they are "safe" and can be read from a Lifer
     # configuration file. Unregistered settings are ignored.
     #

data/locales/en.yml

@@ -33,7 +33,7 @@ en:
     date_error: "[%{filename}]: %{error}"
     feedable_error: >
       please set `%{entry_class}.include_in_feeds` to true or false
-    no_date_metadata: "[%{filename}]: no date metadata"
+    no_published_at_metadata: "[%{filename}]: no `published_at` metadata"
     not_found: >
       file "%{file}" does not exist
   config:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lifer
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - benjamin wil
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-11 00:00:00.000000000 Z
+date: 2025-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
@@ -159,6 +159,7 @@ files:
 - lib/lifer/brain.rb
 - lib/lifer/builder.rb
 - lib/lifer/builder/html.rb
+- lib/lifer/builder/html/from_any.rb
 - lib/lifer/builder/html/from_erb.rb
 - lib/lifer/builder/html/from_liquid.rb
 - lib/lifer/builder/html/from_liquid/drops.rb
@@ -170,7 +171,6 @@ files:
 - lib/lifer/builder/html/from_liquid/drops/tag_drop.rb
 - lib/lifer/builder/html/from_liquid/drops/tags_drop.rb
 - lib/lifer/builder/html/from_liquid/filters.rb
-- lib/lifer/builder/html/from_liquid/layout_tag.rb
 - lib/lifer/builder/html/from_liquid/liquid_env.rb
 - lib/lifer/builder/rss.rb
 - lib/lifer/builder/txt.rb
@@ -210,8 +210,8 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/benjaminwil/lifer/blob/v0.8.0/README.md
-  source_code_uri: https://github.com/benjaminwil/lifer/tree/v0.8.0
+  homepage_uri: https://github.com/benjaminwil/lifer/blob/v0.10.0/README.md
+  source_code_uri: https://github.com/benjaminwil/lifer/tree/v0.10.0
   changelog_uri: https://github.com/benjaminwil/lifer/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []

data/lib/lifer/builder/html/from_liquid/layout_tag.rb

@@ -1,66 +0,0 @@
-class Lifer::Builder::HTML::FromLiquid
-  # Note that if you want to learn more about the shape of this class, check out
-  # `Liquid::Block` in the `liquid` gem.
-  #
-  # The layout tag is a bit magic. The idea here is to emulate how Jekyll
-  # handles `layout:` YAML frontmatter within entries to change the normal
-  # parent layout to an override parent layout--but without the need for
-  # frontmatter.
-  #
-  # The reason we took this strategy was to avoid pre-processing every entry for
-  # frontmatter when we didn't need to. Maybe in the long run this was a bad
-  # call? I don't know.
-  #
-  # @example Usage from a Liquid template.
-  #     {% layout "path/to/my_liquid_layout_template" %}
-  #
-  # (The required `endlayout` tag will be appended to the end of the file
-  # on render if you do not insert it yourself.
-  #
-  class LayoutTag < Liquid::Block
-    # The name of the tag in Liquid templates, `layout`.
-    #
-    NAME = :layout
-
-    # The end name of the tag in Liquid templates, `endlayout`.
-    #
-    ENDNAME = ("end%s" % NAME).to_sym
-
-    def initialize(layout, path, options)
-      @path = path.delete("\"").strip
-      super
-    end
-
-    # A layout tag wraps an entire document and outputs it inside of whatever
-    # the `@layout` is. This lets a child document specify a parernt layout!
-    # Very confusing stuff.
-    #
-    # @param context [Liquid::Context] All of the context of the Liquid
-    #   document that would be rendered.
-    # @return [String] A rendered document.
-    def render(context)
-      document_context = context.environments.first
-      parse_options = document_context["parse_options"]
-      liquid_file_system = parse_options[:environment].file_system
-      render_options = document_context["render_options"]
-
-      current_layout_file = File
-        .read(document_context["entry"]["collection"]["layout_file"])
-        .gsub(/\{%\s*#{tag_name}.+%\}/, "")
-
-      content_with_layout = Liquid::Template
-        .parse(current_layout_file, **parse_options)
-        .render(document_context, **render_options)
-
-      Liquid::Template
-        .parse(
-          liquid_file_system.read_template_file(@path),
-          **parse_options
-        )
-        .render(
-          document_context.merge({"content" => content_with_layout}),
-          **render_options
-        )
-    end
-  end
-end