sutty-archives 2.2.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 504d81958bc2f61213d04212cd3988a17131869a0dff5e294f0782e353515f43
+  data.tar.gz: cb58a0438cdd6bbf51c33ac2bea2f33e5862498039d81d74c9bb56d94fe48c44
+SHA512:
+  metadata.gz: b25f4cc57b9b894980af8c95a65d3e6c35b5ef68de2c91c983d11a7c53300f96116592f20a364e7aae34c71aa028ac98ebcbe421324a9b43b2f5cbf851889f26
+  data.tar.gz: 4259f6adafecb055f17404b46b1ba0a2033bc68905a174bca902dfdd09151ab9eb5f293d35ad37ae190e04de6c740b71107389a43734ac31c30180d64acc6a8b

data/lib/jekyll-archives.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+require "jekyll"
+
+module Jekyll
+  module Archives
+    # Internal requires
+    autoload :Archive, "jekyll-archives/archive"
+    autoload :VERSION, "jekyll-archives/version"
+
+    class Archives < Jekyll::Generator
+      safe true
+
+      DATE_ATTRS = %w[year month day].freeze
+      # Map between the front matter attribute and names used by
+      # jekyll-archive
+      LEGACY_ATTRS = { 'tags' => 'tag', 'categories' => 'category' }.freeze
+
+      DEFAULTS = {
+        "layout"     => "archive",
+        "enabled"    => [],
+        "permalinks" => {
+          "year"     => "/:year/",
+          "month"    => "/:year/:month/",
+          "day"      => "/:year/:month/:day/",
+          "tag"      => "/tag/:name/",
+          "category" => "/category/:name/",
+          "category-tag" => "/category/:category/tag/:tag/"
+        },
+      }.freeze
+
+      def initialize(config = {})
+        archives_config = config.fetch("jekyll-archives", {})
+        if archives_config.is_a?(Hash)
+          @config = Utils.deep_merge_hashes(DEFAULTS, archives_config)
+        else
+          @config = nil
+          Jekyll.logger.warn "Archives:", "Expected a hash but got #{archives_config.inspect}"
+          Jekyll.logger.warn "", "Archives will not be generated for this site."
+        end
+        @enabled = @config && @config["enabled"]
+        @post_attr_hash = {}
+      end
+
+      def generate(site)
+        return if @config.nil?
+
+        @site = site
+        @posts = site.posts
+        @archives = []
+
+        @site.config["jekyll-archives"] = @config
+
+        read
+        @site.pages.concat(@archives)
+
+        @site.config["archives"] = @archives
+      end
+
+      # Read archive data from posts
+      def read
+        read_attrs
+        read_categories_tags
+        read_dates
+      end
+
+      # Read and group by attributes, using the legacy names when
+      # needed.
+      def read_attrs
+        attrs.each do |attr|
+          post_attr_hash(attr).each do |title, posts|
+            attr = LEGACY_ATTRS[attr] if LEGACY_ATTRS[attr]
+
+            next unless attr_title_enabled? attr, title
+
+            @archives << Archive.new(@site, title, attr, posts)
+          end
+        end
+      end
+
+      # If the permalink is a hash of value => template, check if it
+      # isn't disabled.
+      def attr_title_enabled?(attr, value)
+        permalinks = @config.dig('permalinks', attr)
+
+        if permalinks.is_a?(Hash)
+          !!permalinks.dig(value)
+        else
+          true
+        end
+      end
+
+      def read_categories_tags
+        if enabled? "categories-tags"
+          @site.categories.each do |category, posts|
+            posts.map { |post| post.data['tags'] }.flatten.uniq.compact.each do |tag|
+              category_tag_posts = posts.select do |post|
+                post.data['categories'].include?(category) &&
+                  post.data['tags'].include?(tag)
+              end
+
+              @archives << Archive.new(@site, { category: category, tag: tag }, "category-tag", category_tag_posts)
+            end
+          end
+        end
+      end
+
+      def read_dates
+        years.each do |year, y_posts|
+          append_enabled_date_type({ :year => year }, "year", y_posts)
+          months(y_posts).each do |month, m_posts|
+            append_enabled_date_type({ :year => year, :month => month }, "month", m_posts)
+            days(m_posts).each do |day, d_posts|
+              append_enabled_date_type({ :year => year, :month => month, :day => day }, "day", d_posts)
+            end
+          end
+        end
+      end
+
+      # Return the front matter attributes to archive by, using the
+      # legacy names unless specified and leaving out the date
+      # attributes.
+      def attrs
+        return LEGACY_ATTRS.keys unless @enabled.is_a? Array
+
+        @attrs ||= @enabled - DATE_ATTRS
+      end
+
+      # Checks if archive type is enabled in config
+      def enabled?(archive)
+        @enabled == true || @enabled == "all" || (@enabled.is_a?(Array) && @enabled.include?(archive))
+      end
+
+      # Custom `post_attr_hash` method for years
+      def years
+        date_attr_hash(@posts.docs, "%Y")
+      end
+
+      # Custom `post_attr_hash` method for months
+      def months(year_posts)
+        date_attr_hash(year_posts, "%m")
+      end
+
+      # Custom `post_attr_hash` method for days
+      def days(month_posts)
+        date_attr_hash(month_posts, "%d")
+      end
+
+      private
+
+      # Initialize a new Archive page and append to base array if the associated date `type`
+      # has been enabled by configuration.
+      #
+      # meta  - A Hash of the year / month / day as applicable for date.
+      # type  - The type of date archive.
+      # posts - The array of posts that belong in the date archive.
+      def append_enabled_date_type(meta, type, posts)
+        @archives << Archive.new(@site, meta, type, posts) if enabled?(type)
+      end
+
+      # Custom `post_attr_hash` for date type archives.
+      #
+      # posts - Array of posts to be considered for archiving.
+      # id    - String used to format post date via `Time.strptime` e.g. %Y, %m, etc.
+      def date_attr_hash(posts, id)
+        hash = Hash.new { |hsh, key| hsh[key] = [] }
+        posts.each { |post| hash[post.date.strftime(id)] << post }
+        hash.each_value { |posts| posts.sort!.reverse! }
+        hash
+      end
+
+      # Custom `post_attr_hash` to group by any attribute
+      def post_attr_hash(post_attr)
+        @post_attr_hash[post_attr] ||= begin
+          hash = Hash.new { |h, key| h[key] = [] }
+          @site.posts.docs.each do |p|
+            d = p.data[post_attr]
+
+            next if d.nil?
+
+            if d.respond_to? :each
+              d.each { |t| hash[t] << p }
+            else
+              hash[d.to_s] << p
+            end
+          end
+          hash.each_value { |posts| posts.sort!.reverse! }
+          hash
+        end
+      end
+    end
+  end
+end

data/lib/jekyll-archives/archive.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Archives
+    class Archive < Jekyll::Page
+      attr_accessor :posts, :type, :slug
+
+      # Attributes for Liquid templates
+      ATTRIBUTES_FOR_LIQUID = %w(
+        posts
+        type
+        title
+        date
+        name
+        path
+        url
+        permalink
+        slug
+        category
+        tag
+      ).freeze
+
+      # Initialize a new Archive page
+      #
+      # site  - The Site object.
+      # title - The name of the tag/category or a Hash of the year/month/day in case of date.
+      #           e.g. { :year => 2014, :month => 08 } or "my-category" or "my-tag".
+      # type  - The type of archive. Can be one of "year", "month", "day", "category", or "tag"
+      # posts - The array of posts that belong in this archive.
+      def initialize(site, title, type, posts)
+        @site   = site
+        @posts  = posts
+        @type   = type
+        @title  = title
+        @config = site.config["jekyll-archives"]
+        @slug   = slugify_string_title
+
+        # Use ".html" for file extension and url for path
+        @ext  = File.extname(relative_path)
+        @path = relative_path
+        @name = File.basename(relative_path, @ext)
+
+        @data = {
+          "layout" => layout,
+        }
+        @content = ""
+      end
+
+      # The template of the permalink.
+      #
+      # Returns the template String.
+      def template
+        t = @config.dig("permalinks", type)
+        t = t.is_a?(Hash) ? t[title] : t
+
+        t || "/#{type}/:name/"
+      end
+
+      # The layout to use for rendering
+      #
+      # Returns the layout as a String
+      def layout
+        @config.dig("layouts", type) || @config["layout"]
+      end
+
+      # Returns a hash of URL placeholder names (as symbols) mapping to the
+      # desired placeholder replacements. For details see "url.rb".
+      def url_placeholders
+        if @title.is_a? Hash
+          placeholders = @title.merge(:type => @type)
+
+          if @type == 'category-tag'
+            %i[category tag].each do |k|
+              placeholders[k] = Utils.slugify(@title[k], mode: @config.dig('slug'))
+            end
+          end
+
+          placeholders
+        else
+          { :name => @slug, :type => @type }
+        end
+      end
+
+      # The generated relative url of this page. e.g. /about.html.
+      #
+      # Returns the String url.
+      def url
+        @url ||= URL.new(
+          :template     => template,
+          :placeholders => url_placeholders,
+          :permalink    => nil
+        ).to_s
+      rescue ArgumentError
+        raise ArgumentError, "Template \"#{template}\" provided is invalid."
+      end
+
+      def permalink
+        data&.is_a?(Hash) && data["permalink"]
+      end
+
+      # Produce a title object suitable for Liquid based on type of archive.
+      #
+      # Returns a String (for tag and category archives) and nil for
+      # date-based archives.
+      def title
+        if @title.is_a? String
+          @title
+        elsif @type == 'category-tag'
+          @title.values.join(@config.fetch('separator', ' / '))
+        end
+      end
+
+      # Produce a date object if a date-based archive
+      #
+      # Returns a Date.
+      def date
+        return unless date?
+
+        @date ||= begin
+          args = @title.values.map(&:to_i)
+          Date.new(*args)
+        end
+      end
+
+      def category
+        @title[:category] if @title.is_a? Hash
+      end
+
+      def tag
+        @title[:tag] if @title.is_a? Hash
+      end
+
+      # Obtain the write path relative to the destination directory
+      #
+      # Returns the destination relative path String.
+      def relative_path
+        @relative_path ||= begin
+          path = URL.unescape_path(url).gsub(%r!^/!, "")
+          path = File.join(path, "index.html") if url.end_with?("/")
+          path
+        end
+      end
+
+      # Returns the object as a debug String.
+      def inspect
+        "#<Jekyll:Archive @type=#{@type} @title=#{@title} @data=#{@data.inspect}>"
+      end
+
+      def date?
+        %w[year month day].include? @type
+      end
+
+      private
+
+      # Generate slug if @title attribute is a string.
+      #
+      # Note: mode other than those expected by Jekyll returns the given string after
+      # downcasing it.
+      def slugify_string_title
+        return unless title.is_a?(String)
+
+        mode = @config["slug_mode"] || @config["slug"]
+
+        Utils.slugify(title, :mode => mode)
+      end
+    end
+  end
+end

data/lib/jekyll-archives/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Archives
+    VERSION = "2.2.2"
+  end
+end

data/lib/sutty-archives.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'jekyll-archives'

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification
+name: sutty-archives
+version: !ruby/object:Gem::Version
+  version: 2.2.2
+platform: ruby
+authors:
+- Alfred Xing
+- f
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-07-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Automatically generate post archives by dates, and any front matter attribute.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/jekyll-archives.rb
+- lib/jekyll-archives/archive.rb
+- lib/jekyll-archives/version.rb
+- lib/sutty-archives.rb
+homepage: https://0xacab.org/sutty/jekyll/sutty-archives
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key:
+specification_version: 4
+summary: Post archives for Jekyll.  Fork of jekyll-archives.
+test_files: []