jekyll-archives-mlc 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 055ab3532b6c54da1c34b367a73fd9ccf3a59e58fbcdb70ff48ee56a5ad8c0b9
+  data.tar.gz: eaecc7fffc0e06fcf4e9bf482fcc3f61eec8492072a9b8986c82990211d08501
+SHA512:
+  metadata.gz: 05a8f551dd1ed2823b4e5516909721a8c27e717368ea1c1026324d101cd3796c01e52deacf4fd008c660d6cd76a9d5ef982aa0775fed82d1fec1130359ea04a8
+  data.tar.gz: d9146445d67977d6e05d7690c8eb265935c702ed2ece85037b50d6f52ae76d5bac5b6b91b9452b726041f8b2a5e120b860194cafd7c530116ae77bb1c01cdd87

data/lib/jekyll-archives/archive.rb

@@ -0,0 +1,136 @@
+# 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
+      ).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
+        @config.dig("permalinks", type)
+      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
+          @title.merge(:type => @type)
+        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
+        @title if @title.is_a? String
+      end
+
+      # Produce a date object if a date-based archive
+      #
+      # Returns a Date.
+      def date
+        return unless @title.is_a?(Hash)
+
+        @date ||= begin
+          args = @title.values.map(&:to_i)
+          Date.new(*args)
+        end
+      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
+
+      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)
+
+        Utils.slugify(title, :mode => @config["slug_mode"])
+      end
+    end
+  end
+end

data/lib/jekyll-archives/version.rb

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

data/lib/jekyll-archives.rb

@@ -0,0 +1,140 @@
+# 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
+
+      DEFAULTS = {
+        "layout"     => "archive",
+        "enabled"    => [],
+        "permalinks" => {
+          "year"     => "/:year/",
+          "month"    => "/:year/:month/",
+          "day"      => "/:year/:month/:day/",
+          "tag"      => "/tag/:name/",
+          "category" => "/category/:name/",
+        },
+      }.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"]
+      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_tags
+        read_categories
+        read_dates
+      end
+
+      def read_tags
+        if enabled? "tags"
+          tags.each do |title, posts|
+            @archives << Archive.new(@site, title, "tag", posts)
+          end
+        end
+      end
+
+      def read_categories
+        if enabled? "categories"
+          categories.each do |title, posts|
+            @archives << Archive.new(@site, title, "category", posts)
+          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
+
+      # Checks if archive type is enabled in config
+      def enabled?(archive)
+        @enabled == true || @enabled == "all" || (@enabled.is_a?(Array) && @enabled.include?(archive))
+      end
+
+      def tags
+        @site.tags
+      end
+
+      def categories
+        @site.categories
+      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
+    end
+  end
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-archives-mlc
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alfred Xing
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-09-16 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, tags, and categories.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/jekyll-archives.rb
+- lib/jekyll-archives/archive.rb
+- lib/jekyll-archives/version.rb
+homepage: https://github.com/bijianing/jekyll-archives-mlc
+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.1.6
+signing_key: 
+specification_version: 4
+summary: Post archives for Jekyll.
+test_files: []