jekyll-agent-markdown 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 747268dbb22f5d319ed8f760fa97ff9503eb12b632a44c8ef74bcef8694d821d
-  data.tar.gz: 57e5b25acc73b618d1d74f3e11f8e20f44393af1f976bfd17669e2f6d52b226a
+  metadata.gz: 81a9e3ec622a528158f77eab0ea51648c8229b3a4faceb84deb7c648a6a7ae65
+  data.tar.gz: 95a3a69bf269b5399c50209d89bfd0ff24e137e9aba82955b5f82be3c5fbc4ab
 SHA512:
-  metadata.gz: 02e6fa6d6a722bee4b94052f2a2d42ea0d5de18599f4380da778c1e42390a7b54e346d68e3830b7cb0bbb35c0634031ae4fac1c2d8374c074947191f38248cb6
-  data.tar.gz: 715edcbd124b53fca22dedfbf96e115fc4ed1373797ef27ded43868c551f5ec61aecabc1f8057612a842f237d9a544c20e228ecd9ec33a3899d0c308854fb11c
+  metadata.gz: 4eeba03b01f2ffec891e0ab206f659135f5bb892591cd1dbff6ec141ef4db1f6f315baba491b617127614ba5ed167384661303fd2e85d90d50fb63c18de81545
+  data.tar.gz: 48d40c90d4677d033e803469b95521459192386db5fa83fb653446d2ad8190fa1d926ce9d1b77ae81004e01a41c113807b5f64a0350bca0c598ab04f74066bba

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.3.1] - 2026-08-20
+
+- Include the site author in each exported article's metadata footer on the same line as published and updated dates.
+
+## [0.3.0] - 2026-08-20
+
+- Include the site author's name in `llms.txt` by default, with an `include_author` opt-out.
+
 ## [0.2.0] - 2026-08-20
 
 - Add configurable `llms.txt` ordering by normalized published date, defaulting to newest first and placing missing or invalid dates last.

data/README.md

@@ -28,10 +28,13 @@ agent_markdown:
   posts: true
   llms_txt: true
   sort: desc
+  include_author: true
   include_dates: true
 ```
 
-`posts`, `llms_txt`, and `include_dates` accept `true`, `false`, or one of the false-style strings `"false"`, `"no"`, and `"off"` (case-insensitively). `sort` accepts `asc` or `desc` and defaults to `desc`, ordering the `llms.txt` article list by normalized published date. Posts with a missing, incomplete, or invalid published date are listed last in their existing order. Unknown keys and other values stop the build with a configuration error instead of being silently ignored. An explicit per-post `agent_markdown` value follows the boolean-setting rules, so a mistyped opt-out cannot publish raw source by accident.
+`posts`, `llms_txt`, `include_author`, and `include_dates` accept `true`, `false`, or one of the false-style strings `"false"`, `"no"`, and `"off"` (case-insensitively). `sort` accepts `asc` or `desc` and defaults to `desc`, ordering the `llms.txt` article list by normalized published date. Posts with a missing, incomplete, or invalid published date are listed last in their existing order. Unknown keys and other values stop the build with a configuration error instead of being silently ignored. An explicit per-post `agent_markdown` value follows the boolean-setting rules, so a mistyped opt-out cannot publish raw source by accident.
+
+By default, `llms.txt` and each exported article footer include the blog author's name from either a scalar Jekyll setting (`author: Jane Doe`) or a mapping (`author: { name: Jane Doe }`). If no author name is configured, the entry is omitted. Set `include_author: false` under `agent_markdown` to omit author metadata from both outputs.
 
 Set `url` to your site's absolute HTTP(S) URL; the `llms.txt` index uses it to generate absolute article links:
 
@@ -56,14 +59,14 @@ Markdown sibling paths are deterministic:
 
 Extensions are matched case-insensitively, and percent-encoded aliases are compared by their final decoded destination. Destination ownership also treats case-only and Unicode-normalization aliases as equivalent on every platform, keeping builds portable across filesystems. File-versus-directory conflicts are reserved as well. Before adding an export, the plugin checks every page, static file, and writable collection document already known to Jekyll. The existing destination owner wins; later post exports are skipped with a warning and omitted from `llms.txt`. A committed `llms.txt` wins in the same way.
 
-The generated file preserves the post's original Markdown body as its initial content, with no front matter, HTML conversion, or Liquid rendering. Liquid tags and directives such as `{{ site.title }}` are published literally. By default, the plugin appends the post's published `date` and optional `last_modified_at` value as a small footer:
+The generated file preserves the post's original Markdown body as its initial content, with no front matter, HTML conversion, or Liquid rendering. Liquid tags and directives such as `{{ site.title }}` are published literally. By default, the plugin appends the post's published `date`, optional `last_modified_at` value, and site author as a small footer:
 
 ```text
 ---
-Published at: 2026-01-01 | Updated at: 2026-02-03
+Published at: 2026-01-01 | Updated at: 2026-02-03 | Author: Jane Doe
 ```
 
-Each available date is formatted as `YYYY-MM-DD`. String values must contain an explicit year, month, and day; missing, incomplete, and invalid values and their labels are omitted. An empty post contains only the metadata line, without a leading `---` that could be mistaken for front matter. Set `include_dates: false` to omit date metadata from both Markdown exports and `llms.txt`, leaving the body-only export shape used before date metadata was introduced.
+Each available date is formatted as `YYYY-MM-DD`. String values must contain an explicit year, month, and day; missing, incomplete, and invalid values and their labels are omitted. An empty post contains only the metadata line, without a leading `---` that could be mistaken for front matter. `include_dates: false` omits dates from Markdown exports and `llms.txt` article links while leaving an author-only footer when an author is configured. `include_author: false` leaves a date-only footer. Set both options to `false` for a body-only export.
 
 Exclude one post with front matter:
 
@@ -88,6 +91,8 @@ The generated `/llms.txt` is a compact index, for example:
 
 > A short description
 
+Author: Example Author
+
 ## Articles
 
 > Posts only. Pages and collections are not included.

data/lib/jekyll/agent_markdown/author_metadata.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module AgentMarkdown
+    class AuthorMetadata
+      def initialize(config)
+        @config = config
+      end
+
+      def to_s
+        author_name = name
+        author_name.empty? ? "" : "Author: #{author_name}"
+      end
+
+      private
+
+      attr_reader :config
+
+      def name
+        author = config["author"]
+        author = author["name"] || author[:name] if author.is_a?(Hash)
+        author ? author.to_s.gsub(/\s+/, " ").strip : ""
+      end
+    end
+  end
+end

data/lib/jekyll/agent_markdown/configuration.rb

@@ -6,7 +6,7 @@ require "uri"
 module Jekyll
   module AgentMarkdown
     class Configuration
-      ALLOWED_SETTINGS = %w[include_dates llms_txt posts sort].freeze
+      ALLOWED_SETTINGS = %w[include_author include_dates llms_txt posts sort].freeze
       FALSE_STRINGS = %w[false no off].freeze
       SORT_ORDERS = %w[asc desc].freeze
 

data/lib/jekyll/agent_markdown/date_metadata.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "date"
+require_relative "metadata_footer"
 
 module Jekyll
   module AgentMarkdown
@@ -21,10 +22,7 @@ module Jekyll
       end
 
       def append_to(content)
-        return content if to_s.empty?
-        return "#{self}\n" if content.empty?
-
-        "#{content}#{separator_for(content)}---\n#{self}\n"
+        MetadataFooter.new([to_s]).append_to(content)
       end
 
       def published_date = parsed_date(@data["date"])
@@ -36,10 +34,6 @@ module Jekyll
         "#{label}: #{date}" if date
       end
 
-      def separator_for(content)
-        content.end_with?("\n") ? "\n" : "\n\n"
-      end
-
       def formatted_date(value)
         parsed_date(value)&.strftime(DATE_FORMAT)
       end

data/lib/jekyll/agent_markdown/generator.rb

@@ -1,10 +1,13 @@
 # frozen_string_literal: true
 
 require "jekyll"
+require_relative "author_metadata"
 require_relative "configuration"
 require_relative "date_metadata"
 require_relative "destination_claims"
+require_relative "llms_headings"
 require_relative "markdown_sibling_path"
+require_relative "metadata_footer"
 require_relative "raw_markdown_file"
 
 module Jekyll
@@ -46,7 +49,7 @@ module Jekyll
         setting_name = "agent_markdown in #{post.relative_path}"
         return unless Configuration.enabled_value?(setting, name: setting_name)
 
-        file = RawMarkdownFile.new(site, MarkdownSiblingPath.for(post.url), post_content(post, settings))
+        file = RawMarkdownFile.new(site, MarkdownSiblingPath.for(post.url), post_content(site, post, settings))
         url = file.url
         return collision_warning(post, url) unless claim_destination?(destination_claims, site, file)
 
@@ -91,22 +94,10 @@ module Jekyll
       end
 
       def llms_txt(site, posts, settings)
-        sections = [llms_headings(site), article_links(site, posts, settings)]
+        sections = [LlmsHeadings.new(site, settings).to_s, article_links(site, posts, settings)]
         "#{sections.reject(&:empty?).join("\n\n")}\n"
       end
 
-      def llms_headings(site)
-        title = one_line(site.config.fetch("title", ""))
-        headings = ["# #{title}".rstrip]
-        description = one_line(site.config["description"])
-        headings << "> #{description}" unless description.empty?
-        headings << "## Articles"
-        headings << "> Posts only. Pages and collections are not included."
-        headings.join("\n\n")
-      end
-
-      def one_line(value) = value ? value.to_s.gsub(/\s+/, " ").strip : ""
-
       def article_links(site, posts, settings)
         site_url = site.config["url"].sub(%r{/+\z}, "")
         sorted_posts(posts, settings).map { |post| article_link(site_url, post, settings) }.join("\n")
@@ -127,10 +118,11 @@ module Jekyll
         [link, date_metadata(post).to_s].reject(&:empty?).join(" | ")
       end
 
-      def post_content(post, settings)
-        return post.content unless Configuration.enabled?(settings, "include_dates")
-
-        date_metadata(post).append_to(post.content)
+      def post_content(site, post, settings)
+        entries = []
+        entries << date_metadata(post).to_s if Configuration.enabled?(settings, "include_dates")
+        entries << AuthorMetadata.new(site.config).to_s if Configuration.enabled?(settings, "include_author")
+        MetadataFooter.new(entries).append_to(post.content)
       end
 
       def date_metadata(post) = DateMetadata.new(post.data)

data/lib/jekyll/agent_markdown/llms_headings.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative "author_metadata"
+require_relative "configuration"
+
+module Jekyll
+  module AgentMarkdown
+    class LlmsHeadings
+      def initialize(site, settings)
+        @site = site
+        @settings = settings
+      end
+
+      def to_s
+        [title_heading, description_heading, author_heading, "## Articles", articles_description]
+          .compact.join("\n\n")
+      end
+
+      private
+
+      attr_reader :site, :settings
+
+      def title_heading = "# #{one_line(site.config.fetch("title", ""))}".rstrip
+
+      def description_heading
+        description = one_line(site.config["description"])
+        "> #{description}" unless description.empty?
+      end
+
+      def author_heading
+        return unless Configuration.enabled?(settings, "include_author")
+
+        metadata = AuthorMetadata.new(site.config).to_s
+        metadata unless metadata.empty?
+      end
+
+      def articles_description = "> Posts only. Pages and collections are not included."
+
+      def one_line(value) = value ? value.to_s.gsub(/\s+/, " ").strip : ""
+    end
+  end
+end

data/lib/jekyll/agent_markdown/metadata_footer.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module AgentMarkdown
+    class MetadataFooter
+      def initialize(entries)
+        @text = entries.compact.reject(&:empty?).join(" | ")
+      end
+
+      def append_to(content)
+        return content if text.empty?
+        return "#{text}\n" if content.empty?
+
+        "#{content}#{separator_for(content)}---\n#{text}\n"
+      end
+
+      private
+
+      attr_reader :text
+
+      def separator_for(content)
+        content.end_with?("\n") ? "\n" : "\n\n"
+      end
+    end
+  end
+end

data/lib/jekyll/agent_markdown/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module AgentMarkdown
-    VERSION = "0.2.0"
+    VERSION = "0.3.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-agent-markdown
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Lucian Ghinda
@@ -41,11 +41,14 @@ files:
 - LICENSE.txt
 - README.md
 - lib/jekyll-agent-markdown.rb
+- lib/jekyll/agent_markdown/author_metadata.rb
 - lib/jekyll/agent_markdown/configuration.rb
 - lib/jekyll/agent_markdown/date_metadata.rb
 - lib/jekyll/agent_markdown/destination_claims.rb
 - lib/jekyll/agent_markdown/generator.rb
+- lib/jekyll/agent_markdown/llms_headings.rb
 - lib/jekyll/agent_markdown/markdown_sibling_path.rb
+- lib/jekyll/agent_markdown/metadata_footer.rb
 - lib/jekyll/agent_markdown/raw_markdown_file.rb
 - lib/jekyll/agent_markdown/version.rb
 homepage: https://github.com/lucianghinda/jekyll-agent-markdown