scribo 1.0.38

data/app/views/scribo/shared/_entry.html.slim

@@ -0,0 +1,17 @@
+li.entry class="#{content.kind == 'folder' ? "directory #{state || 'closed'}" : 'file'}" data-content="#{content.id}" data-at-content="#{content.id}" data-controller="#{content.kind == 'folder' ? 'upload' : ''}" data-upload-url="#{upload_admin_site_contents_url(@site)}" data-upload-param-name="content[files][]" data-upload-extra-data=%[{"content[parent_id]": "#{content.id}"}]
+  - if content.kind == 'folder'
+    a.list-item data-action="dblclick->tree-view#rename" data-tree-view-rename-url="#{rename_admin_site_content_url(content.site, content)}"
+      span.name data-path="#{content.path}" = content.path
+      .tools
+        i.fal.fa-file-plus data-action="click->tree-view#create" data-kind="text" data-url="#{admin_site_contents_url(@site)}" title=I18n.t('scribo.tools.new_file')
+        i.fal.fa-folder-plus data-action="click->tree-view#create" data-kind="folder" data-url="#{admin_site_contents_url(@site)}" title=I18n.t('scribo.tools.new_folder')
+        i.fal.fa-trash data-action="click->tree-view#delete" data-url="#{admin_site_content_path(@site, content)}" data-confirm=I18n.t('scribo.confirm.delete_folder') title=I18n.t('scribo.tools.delete_folder')
+
+  - else
+    a.list-item data-action="click->tree-view#open dblclick->tree-view#rename" data-tree-view-url="#{edit_admin_site_content_url(content.site, content)}" data-tree-view-rename-url="#{rename_admin_site_content_url(content.site, content)}"
+      span.name data-path="#{content.path}" = content.path
+      .tools
+        i.fal.fa-trash data-action="click->tree-view#delete" data-url="#{admin_site_content_path(@site, content)}" data-confirm=I18n.t('scribo.confirm.delete_file') title=I18n.t('scribo.tools.delete_file')
+  ul data-parent="#{content.id}"
+    - (content.children.where(kind: 'folder').reorder(:path) + content.children.where("kind <> 'folder'").reorder(:path)).each do |child|
+      = render partial: 'scribo/shared/entry', locals: {content: child, state: 'closed'}

data/app/views/scribo/shared/_ide.html.slim

@@ -0,0 +1,14 @@
+.scribo-ide id="ide" data-controller='open-editors'
+  .explorer-pane data-controller="tree-view upload" data-tree-view-update-url="#{move_admin_site_contents_path(@site)}" data-upload-url="#{upload_admin_site_contents_url(@site)}" data-upload-param-name="content[files][]"
+    .tree-view
+        = render partial: 'scribo/shared/tree-view'
+
+  .editors-pane
+    .editors-tabs data-open-editors-target='tabs' data-action="click->open-editors#clickTabs"
+    .editors-contents data-open-editors-target='contents'
+
+- if @readme
+  #readme style="display: none;" data-id=@readme.id data-path=@readme.path data-full-path=@readme.full_path data-url=@readme.url
+    div style="position: absolute; width: 100%; height: 100%;"
+      textarea id="content-editor-#{@readme.id}" name='content[data_with_frontmatter]' data-controller="text-editor" data-text-editor-content-id=@readme.id data-text-editor-target="textarea" data-text-editor-mode="#{@readme.content_type}" data-text-editor-save-url=admin_site_content_path(@site, @readme) style="display: block; height: 100%;"
+        = @readme.data_with_frontmatter || 'Start typing here'

data/app/views/scribo/shared/_tree-view.html.slim

@@ -0,0 +1,32 @@
+div.section
+  span.title Open editors
+  .tools
+    i.fal.fa-floppy-disks data-action="click->open-editors#saveAll" title=I18n.t('scribo.tools.save_all')
+    i.fal.fa-square-xmark data-action="click->open-editors#closeAll" title=I18n.t('scribo.tools.close_all')
+
+  ul.openEditors data-open-editors-target='list' data-action="click->open-editors#clickList"
+
+div.section
+  span.title = @site.title
+  .tools
+    i.fal.fa-file-plus data-action="click->tree-view#create" data-kind="text" data-url="#{admin_site_contents_url(@site)}" title=I18n.t('scribo.tools.new_file')
+    i.fal.fa-folder-plus data-action="click->tree-view#create" data-kind="folder" data-url="#{admin_site_contents_url(@site)}" title=I18n.t('scribo.tools.new_folder')
+    i.fal.fa-square-plus data-action="click->tree-view#collapseExpandAll" data-tree-view-target="collapseExpand" title=I18n.t('scribo.tools.collapse_all')
+
+  ul data-tree-view-target="contentItems" data-open-editors-target='contentItems'
+    - @contents.each do |content|
+      = render partial: 'scribo/shared/entry', locals: {content: content, state: 'closed'}
+
+  template data-tree-view-target="folderTemplate"
+    li.entry.directory.closed
+      a.list-item
+        span.name
+          input type="text" value="untitled"
+      ul
+
+template data-tree-view-target="entryTemplate"
+  li.entry.file
+    a.list-item
+      span.name data-path="untitled.html"
+        input type="text" value="untitled.html"
+    ul

data/config/locales/en.yml

@@ -0,0 +1,39 @@
+en:
+  scribo:
+    breadcrumbs:
+      admin:
+        sites: Sites
+        contents: Contents
+        translations: Translations
+    sites:
+      export: Download site
+      ide: Open IDE
+      preview: Preview
+      delete: Delete site
+      delete_confirm: Are you sure you want to delete this site?
+      upload: Drop a zip to import a site
+      create: Create a new site
+      create_from_template: Create from template
+    tools:
+      new_file: New file
+      new_folder: New folder
+      delete_file: Delete file
+      delete_folder: Delete folder
+      collapse_all: Collapse all
+      close_all: Close all
+      save_all: Save all
+      save: Save
+    confirm:
+      delete_file: Are you sure you want to delete this file?
+      delete_folder: Are you sure you want to delete this folder (and all it's subfiles and folders)?
+    admin:
+      sites: 
+        contents:
+         create:
+          create_fail: 'Failed to create %{kind}'
+         upload:
+          upload_fail: Failed to upload
+         move: 
+          move_fail: Failed to move file
+          
+

data/config/routes.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+Scribo::Engine.routes.draw do
+  namespace :admin, path: Scribo.config.admin_mount_point do
+    resources :sites do
+      resources :contents, controller: 'sites/contents' do
+        member do
+          put 'rename', as: :rename
+        end
+        collection do
+          post 'upload'
+          put 'move', as: :move
+        end
+      end
+
+      member do
+        get 'export'
+      end
+      collection do
+        get 'import'
+        post 'import'
+      end
+    end
+  end
+  namespace :api do
+    resources :sites do
+      collection do
+        post 'import'
+      end
+    end
+  end
+
+  root to: 'contents#show'
+  get '(*path)', to: 'contents#show', as: 'content', constraints: ->(request) { !request.path.starts_with?('/rails') }
+end

data/db/migrate/20200123095630_initial_scribo.rb

@@ -0,0 +1,34 @@
+class InitialScribo < ActiveRecord::Migration[5.2]
+  def change
+    return if ActiveRecord::Base.connection.table_exists? 'scribo_contents'
+
+    create_table "scribo_contents", id: :uuid, default: -> { "uuid_generate_v4()" }, force: :cascade do |t|
+      t.uuid "scribo_site_id"
+      t.string "kind", default: "text"
+      t.string "path"
+      t.text "data"
+      t.jsonb "properties", default: {}
+      t.uuid "parent_id"
+      t.datetime "created_at", null: false
+      t.datetime "updated_at", null: false
+      t.integer "lft"
+      t.integer "rgt"
+      t.integer "depth"
+      t.integer "children_count"
+      t.string "full_path"
+      t.index ["parent_id"], name: "index_scribo_contents_on_parent_id"
+      t.index ["scribo_site_id", "full_path"], name: "index_scribo_contents_full_path", unique: true
+      t.index ["scribo_site_id", "path"], name: "index_scribo_contents_path"
+      t.index ["scribo_site_id"], name: "index_scribo_contents_on_scribo_site_id"
+    end
+
+    create_table "scribo_sites", id: :uuid, default: -> { "uuid_generate_v4()" }, force: :cascade do |t|
+      t.string "scribable_type"
+      t.uuid "scribable_id"
+      t.datetime "created_at", null: false
+      t.datetime "updated_at", null: false
+      t.jsonb "properties", default: {}, null: false
+      t.index ["scribable_type", "scribable_id"], name: "index_scribo_sites_on_scribable_type_and_scribable_id"
+    end
+  end
+end

data/db/migrate/20220919124119_add_ancestry_to_scribo_contents.rb

@@ -0,0 +1,13 @@
+class AddAncestryToScriboContents < ActiveRecord::Migration[6.0]
+  def change
+    add_column :scribo_contents, :ancestry, :text
+    add_index :scribo_contents, :ancestry, order: {ancestry: :text_pattern_ops}
+    add_column :scribo_contents, :ancestry_depth, :integer,  default: 0
+    add_index :scribo_contents, :ancestry_depth
+    remove_column :scribo_contents, :children_count
+    add_column :scribo_contents, :children_count, :integer,  default: 0
+    add_index :scribo_contents, :children_count
+    
+    Scribo::Content.build_ancestry_from_parent_ids!
+  end
+end

data/db/migrate/20220919124749_remove_parent_id_from_scribo_contents.rb

@@ -0,0 +1,8 @@
+class RemoveParentIdFromScriboContents < ActiveRecord::Migration[6.0]
+  def change
+    remove_column :scribo_contents, :parent_id
+    remove_column :scribo_contents, :lft
+    remove_column :scribo_contents, :rgt
+    remove_column :scribo_contents, :depth
+  end
+end

data/lib/scribo/action_controller_helpers.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Scribo
+  module ActionControllerHelpers
+    extend ActiveSupport::Concern
+
+    included do
+      attr_accessor :scribo_value_purpose, :scribo_value_layout, :scribo_value_application_assets
+
+      if respond_to? :helper_method
+        helper_method :scribo_layout_identifier, :scribo_application_assets, :scribo_purpose
+      end
+
+      def scribo_layout_identifier
+        scribo_value_for(scribo_value_layout)
+      end
+
+      def scribo_purpose
+        scribo_value_for(scribo_value_purpose)
+      end
+
+      def scribo_application_assets
+        scribo_value_for(scribo_value_application_assets)
+      end
+
+      private
+
+      def scribo_value_for(value)
+        return instance_eval(&value) if value.is_a? Proc
+        return send(value) if value.is_a? Symbol
+        value
+      end
+    end
+
+    class_methods do
+      def scribo(*args)
+        options = args.extract_options!
+
+        if options.present?
+          prepend_before_action do |controller|
+            controller.send(:scribo_value_layout=, options[:layout]) if options[:layout]
+            controller.send(:scribo_value_purpose=, options[:purpose]) if options[:purpose]
+            controller.send(:scribo_value_application_assets=, options[:assets])
+          end
+
+          layout 'scribo' if options[:layout]
+        end
+      end
+    end
+  end
+end

data/lib/scribo/action_controller_renderers.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Add scribo as a renderer
+module ActionController::Renderers
+  add :scribo do |request, options|
+    options.merge!(request: request, uri: URI.parse(request.original_url), host: request.host, path: URI.parse(request.original_url).path)
+
+    site = Scribo::SiteFindService.new(options).call
+    content = nil
+
+    unless site
+      # If we have no site, see if we have one when we add an /
+      site = Scribo::SiteFindService.new(options.merge(path: "#{options[:path]}/")).call
+      redirect_to("#{options[:path]}/") && return if site
+    end
+
+    if site && options[:path] == site.baseurl && !options[:path].ends_with?('/')
+      redirect_to("#{site.baseurl}/")
+    end
+
+    options.merge!(site: site)
+    site ||= Scribo::Site.default(request: request)
+    content ||= Scribo::ContentFindService.new(site, options).call
+
+    if content
+      self.content_type ||= Scribo::Utility.output_content_type(content)
+
+      Scribo.config.logger.info "Scribo: rendering #{content.id} last-updated #{content.updated_at} cache-key #{content.cache_key} path #{content.path} identifier #{content.identifier}"
+      if content.redirect?
+        redirect_options = Scribo::Content.redirect_options(Scribo::ContentRenderService.new(content, self, options).call)
+        redirect_to redirect_options.last, status: redirect_options.first
+      elsif stale?(etag: content.cache_key, public: true)
+        if content.kind == 'asset'
+          data = Rails.cache.fetch("#{content.cache_key}/asset", expires_in: 12.hours) { Scribo::ContentRenderService.new(content, self, options).call }
+          stream_data(data, type: content.content_type)
+        else
+          Scribo::ContentRenderService.new(content, self, options).call
+        end
+      else
+        head 304
+      end
+    else
+      render body: Scribo.config.default_404_txt, status: 404
+    end
+  end
+
+  # See: https://stackoverflow.com/a/57786143
+  def stream_data(data, options = {})
+    range_start = 0
+    file_size = data.length
+    range_end = file_size
+    status_code = '200'
+
+    if request.headers['Range']
+      status_code = '206'
+      request.headers['range'].match(/bytes=(\d+)-(\d*)/).try do |match|
+        range_start = match[1].to_i
+        range_end = match[2].to_i unless match[2] && match[2].empty?
+      end
+      response.header['Content-Range'] = "bytes #{range_start}-#{range_end}/#{file_size}"
+    end
+
+    response.header['Accept-Ranges'] = 'bytes'
+
+    send_data(data[range_start, range_end],
+              filename: options[:filename],
+              type: options[:type],
+              disposition: 'inline',
+              status: status_code)
+  end
+end

data/lib/scribo/action_view_helpers.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'app', 'drops', 'scribo', 'action_dispatch', 'request_drop.rb'))
+
+module ActionViewHelpers
+  def layout_with_scribo(layout_name, yield_content)
+    options = { request: request, uri: URI.parse(request.original_url), host: request.host, path: URI.parse(request.original_url).path }
+    site = Scribo::SiteFindService.new(options).call
+
+    application_js = content_for?(:js) && content_for(:js)
+
+    content = site.contents.new(kind: 'text', data: yield_content, properties: { layout: layout_name })
+
+    registers = { controller: controller, application_assets: scribo_application_assets, application_js: application_js }
+    Scribo::ContentRenderService.new(content, self, registers: registers).call.html_safe
+  end
+end

data/lib/scribo/active_record_helpers.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module ActiveRecordHelpers
+  extend ActiveSupport::Concern
+
+  class_methods do
+    def scribable
+      has_many :sites, as: :scribable, class_name: 'Scribo::Site'
+    end
+  end
+end

data/lib/scribo/configuration.rb

@@ -0,0 +1,97 @@
+module Scribo
+  class Configuration
+    attr_accessor :admin_authentication_module, :base_controller, :supported_mime_types, :default_404_txt,
+                  :default_humans_txt, :default_robots_txt, :default_favicon_ico, :templates
+    attr_writer :logger, :scribable_objects, :scribable_for_request, :after_site_create, :admin_mount_point, :default_site
+
+    def initialize
+      @logger = Logger.new(STDOUT)
+      @logger.level = Logger::INFO
+      @base_controller = '::ApplicationController'
+      @supported_mime_types = {
+        image: %w[image/gif image/png image/jpeg image/bmp image/webp image/svg+xml],
+        text: %w[text/plain text/html application/json application/xml],
+        style: %w[text/css],
+        script: %w[text/javascript application/javascript application/x-javascript],
+        audio: %w[audio/midi audio/mpeg audio/webm audio/ogg audio/wav],
+        video: %w[video/webm video/ogg video/mp4],
+        document: %w[application/msword application/vnd.ms-powerpoint application/vnd.ms-excel application/pdf
+                     application/zip],
+        font: %w[font/collection font/otf font/sfnt font/ttf font/woff font/woff2 application/font-ttf
+                 application/x-font-ttf application/vnd.ms-fontobject application/font-woff],
+        other: %w[application/octet-stream]
+      }
+      @default_404_txt = '404 Not Found'
+      @default_humans_txt = <<~HUMANS_TXT
+        /* TEAM */
+        Your title: Your name.
+        Site: email, link to a contact form, etc.
+        Twitter: your Twitter username.
+        Location: City, Country.
+
+                                [...]
+
+        /* THANKS */
+        Name: name or url
+
+                                [...]
+
+        /* SITE */
+        Last update: YYYY/MM/DD
+        Standards: HTML5, CSS3,..
+        Components: Modernizr, jQuery, etc.
+        Software: Software used for the development
+      HUMANS_TXT
+      @default_robots_txt = <<~ROBOTS_TXT
+        # See http://www.robotstxt.org/robotstxt.html for documentation on how to use the robots.txt file
+        #
+        # To ban all spiders from the entire site uncomment the next two lines:
+        # User-agent: *
+        # Disallow: /
+      ROBOTS_TXT
+
+      # Base64 encoded image/x-icon
+      @default_favicon_ico = 'AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEcrEvoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAsHIH/7d2Bv+3dgb/t3YG/7d2Bv0AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAt3YG/0crEv+3dgb/t3YG/7d2Bv8AAAAAt3YG/7d2Bv90Vx0DAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALd2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/3VLBEwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC3dgb/t3YG/0crEv+3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAt3YG/bd2Bv+3dgb/qGwI/7d2Bv+3dgb/t3YG/7d2Bv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAt3YG/7d2Bv+3dgb/lV8K/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/7h2B9EAAAAAAAAAAAAAAAAAAAAAAAAAALd2Bv+3dgb/t3YG/7d2Bv+JWAv/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAt3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALd2Bvi3dgb/t3YG+7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAt3YG/wAAAAC3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAt3YG/7d2Bv+3dgb/t3YG/7d2Bv+3dgb/t3YG/7d2Bv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC3dgb/t3YG/2hDA3O3dgb/t3YG/7d2Bv+3dgb/t3YG/QAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC4dgeJAAAAALd2Bv+3dgb/t3YG/7d2Bv+zcgZ3//8AAL//AADB/wAAgn8AAIA/AACAHwAAgH8AAMAPAADABwAAwAcAAOAHAADgDwAA9AMAAPwDAAD+QQAA/6EAAA=='
+
+      # This needs an array of hashes, each hash MUST include an id, thumbnail and a url:
+      # [
+      #   { id: '7becd952-ae77-43ad-9bf7-ed4f8feb59fa', thumbnail: 'https://mysite.net/template1.png', url: 'https://mysite.net/template1.zip' }
+      # ]
+      #
+      # The id can be generated using: `SecureRandom.uuid`, or you can use integers
+      @templates = []
+
+      # Default site if no site is found, this can be nil, an actual site instance or a proc which will resolve a site instance.
+      @default_site = nil
+    end
+
+    # logger [Object].
+    def logger
+      @logger.is_a?(Proc) ? instance_exec(&@logger) : @logger
+    end
+
+    def default_site(request = nil)
+      @default_site.is_a?(Proc) ? instance_exec(request, &@default_site) : @default_site
+    end
+
+    # admin_mount_point [String].
+    def admin_mount_point
+      @admin_mount_point ||= '/'
+    end
+
+    # Only used to limit what users can see when using admin
+    def scribable_objects
+      [*instance_exec(&@scribable_objects)] if @scribable_objects
+    end
+
+    # Which scribable to use for the current request, should only return one scribable
+    def scribable_for_request(request)
+      instance_exec(request, &@scribable_for_request) if @scribable_for_request
+    end
+
+    # What to do after a site create (only for new sites, not imported sites)
+    def after_site_create(site)
+      instance_exec(site, &@after_site_create) if @after_site_create
+    end
+  end
+end

data/lib/scribo/engine.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'i18n'
+
+module Scribo
+  class Engine < ::Rails::Engine
+    isolate_namespace Scribo
+
+    initializer 'scribo.config' do |_app|
+      path = File.expand_path(File.join(File.dirname(__FILE__), '.', 'liquid', '{tags,filters}', '*.rb'))
+      Dir.glob(path).each do |c|
+        require_dependency(c)
+      end
+    end
+
+    initializer :append_migrations do |app|
+      unless app.root.to_s.match? root.to_s
+        config.paths['db/migrate'].expanded.each do |expanded_path|
+          app.config.paths['db/migrate'] << expanded_path
+        end
+      end
+    end
+  end
+end

data/lib/scribo/i18n_store.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+# require 'i18n/core_ext/hash'
+
+module Scribo
+  begin
+    require 'oj'
+    class JSON
+      class << self
+        def encode(value)
+          Oj::Rails.encode(value)
+        end
+
+        def decode(value)
+          Oj.load(value)
+        end
+      end
+    end
+  rescue LoadError
+    require 'active_support/json'
+    JSON = ActiveSupport::JSON
+  end
+
+  class I18nStore
+    def initialize; end
+
+    def keys
+      return [] unless content
+
+      result = []
+      locales.each do |locale|
+        result += flat_hash(YAML.safe_load(locale.data)).keys
+      end
+      result
+    end
+
+    def [](key)
+      return unless content
+
+      result = {}
+      locales.each do |locale|
+        hash = flat_hash(YAML.safe_load(locale.data)).transform_values { |v| JSON.encode(v) }
+        result.merge! hash
+      end
+      result[key]
+    end
+
+    def []=(key, value)
+      # NOOP
+    end
+
+    def with(content)
+      with_custom_backend do
+        self.content = content
+        yield(content)
+        self.content = nil
+      end
+    end
+
+    def content
+      Thread.current[:scribo_i18n_store_content]
+    end
+
+    def content=(content)
+      Thread.current[:scribo_i18n_store_content] = content
+    end
+
+    private
+
+    def with_custom_backend
+      Thread.current[:scribo_i18n_store_old_backend] = I18n.backend
+      I18n.backend = I18n::Backend::Chain.new(custom_i18n_backend, I18n.backend)
+
+      yield
+
+      I18n.backend = Thread.current[:scribo_i18n_store_old_backend]
+    end
+
+    def locales
+      content.site.contents.locales
+    end
+
+    def flat_hash(hash)
+      hash.reduce({}) do |a, (k, v)|
+        tmp = v.is_a?(Hash) ? flat_hash(v).map { |k2, v2| ["#{k}.#{k2}", v2] }.to_h : { k => v }
+        a.merge(tmp)
+      end
+    end
+
+    # Yield our own custom backend
+    def custom_i18n_backend
+      return @custom_i18n_backend if @custom_i18n_backend
+
+      @custom_i18n_backend = I18n::Backend::KeyValue.new(Scribo.i18n_store)
+      @custom_i18n_backend.class.send(:include, I18n::Backend::Cascade)
+
+      @custom_i18n_backend
+    end
+  end
+end

data/lib/scribo/liquid/filters/jekyll_filters.rb

@@ -0,0 +1,94 @@
+module JekyllFilters
+  # Filter an array of objects
+  #
+  # input    - the object array.
+  # property - the property within each object to filter by.
+  # value    - the desired value.
+  #            Cannot be an instance of Array nor Hash since calling #to_s on them returns
+  #            their `#inspect` string object.
+  #
+  # Returns the filtered array of objects
+  def where(input, property, value)
+    return input if !property || value.is_a?(Array) || value.is_a?(Hash)
+    return input unless input.respond_to?(:select)
+
+    input    = input.values if input.is_a?(Hash)
+    input_id = input.hash
+
+    # implement a hash based on method parameters to cache the end-result
+    # for given parameters.
+    @where_filter_cache ||= {}
+    @where_filter_cache[input_id] ||= {}
+    @where_filter_cache[input_id][property] ||= {}
+
+    # stash or retrive results to return
+    @where_filter_cache[input_id][property][value] ||= input.select do |object|
+      compare_property_vs_target(item_property(object, property), value)
+    end.to_a
+  end
+
+  # `where` filter helper
+  #
+  def compare_property_vs_target(property, target)
+    case target
+    when NilClass
+      return true if property.nil?
+    when Liquid::Expression::MethodLiteral # `empty` or `blank`
+      target = target.to_s
+      return true if property == target || Array(property).join == target
+    else
+      target = target.to_s
+      if property.is_a? String
+        return true if property == target
+      else
+        Array(property).each do |prop|
+          return true if prop.to_s == target
+        end
+      end
+    end
+
+    false
+  end
+
+  def item_property(item, property)
+    # Jekyll uses :site here, but we use strings?
+    @item_property_cache ||= @context.registers['site'].filter_cache[:item_property] ||= {}
+    @item_property_cache[property] ||= {}
+    @item_property_cache[property][item] ||= begin
+      property = property.to_s
+      property = if item.respond_to?(:to_liquid)
+                   read_liquid_attribute(item.to_liquid, property)
+                 elsif item.respond_to?(:data)
+                   item.data[property]
+                 else
+                   item[property]
+                 end
+
+      parse_sort_input(property)
+    end
+  end
+
+  def read_liquid_attribute(liquid_data, property)
+    return liquid_data[property] unless property.include?('.')
+
+    property.split('.').reduce(liquid_data) do |data, key|
+      data.respond_to?(:[]) && data[key]
+    end
+  end
+
+  FLOAT_LIKE   = /\A\s*-?(?:\d+\.?\d*|\.\d+)\s*\Z/.freeze
+  INTEGER_LIKE = /\A\s*-?\d+\s*\Z/.freeze
+  private_constant :FLOAT_LIKE, :INTEGER_LIKE
+
+  # return numeric values as numbers for proper sorting
+  def parse_sort_input(property)
+    stringified = property.to_s
+    return property.to_i if INTEGER_LIKE.match?(stringified)
+    return property.to_f if FLOAT_LIKE.match?(stringified)
+
+    property
+  end
+end
+
+# TDG: Friday Sept 17th 2021 - Removed these, they bite the built-in where filter.
+# Liquid::Template.register_filter(JekyllFilters)