trifle-docs 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f51e6c6b892eaca5b790d652ccb970146c9e98b624cf3353c84af3ffb95ed4c
-  data.tar.gz: f5058c9fa39c81a635db554fabffaab5535f57a76a078138319df0e72732cd49
+  metadata.gz: 2f5639f53f19ef35690cc1f68d2866cb05c8edc61f4c31cbe77f75c27083d27d
+  data.tar.gz: 197207ceb689bc6e539c37dc7443a9a513f4eb135436d0a04df58d7cfbab074b
 SHA512:
-  metadata.gz: 48ce9ec16b882be46f90825f0e12bb13c783fa16e5b22f5eae27551418a5e58d112a321496fdf46810474c68de5f8933661931a696b6378bc836ffd7a8e74192
-  data.tar.gz: 9721a213e1f2cef167e0adf4ed18025b0740ba6594e26f6f0f326e4e6412631f5957447f503cd2ca45c4ce4e2df5efb497a15a8aaf2943a29b246a2c373869a8
+  metadata.gz: 4647c880321bb90b15779068c670ce28961002f638ab447ed76dfb8ea2d49d8fe312edc3402d588c7399e1d5b7a73b53288c557a6a1ff4d02589af57b8684fe1
+  data.tar.gz: 312f3d0a696d060f7f871dee17946215fd8eb500783771f4d6fe962f4b533b5766e396b05b133aba83a52e28ce426d08348c30842b482e05412bfbd219c379e8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    trifle-docs (0.7.0)
+    trifle-docs (0.7.1)
       redcarpet
       rouge
       sinatra

data/lib/trifle/docs/app.rb

@@ -32,7 +32,7 @@ module Trifle
         content = Trifle::Docs::Helper::Llms.homepage_markdown
         halt(404, 'Not Found') if content.nil?
 
-        content_type 'text/markdown'
+        content_type 'text/plain'
         content
       end
 
@@ -43,7 +43,7 @@ module Trifle
         content = Trifle::Docs::Helper::Llms.full_markdown
         halt(404, 'Not Found') if content.nil? || content.strip.empty?
 
-        content_type 'text/markdown'
+        content_type 'text/plain'
         content
       end
 
@@ -77,6 +77,7 @@ module Trifle
         meta = Trifle::Docs.meta(url: url)
         halt(404, 'Not Found') if meta.nil?
 
+        set_vary_header unless meta['type'] == 'file'
         return render_markdown(meta, url) if render_markdown?(meta, request, params)
         return send_file(meta['path']) if meta['type'] == 'file'
 
@@ -84,7 +85,7 @@ module Trifle
       end
 
       def render_markdown(meta, url)
-        content_type 'text/markdown'
+        content_type markdown_content_type(request)
         Trifle::Docs::Helper::MarkdownLayout.render(
           meta: meta,
           raw_content: Trifle::Docs.raw_content(url: url),
@@ -110,6 +111,25 @@ module Trifle
         content
       end
 
+      def markdown_content_type(request)
+        return 'text/plain' if Trifle::Docs::Helper::AiDetection.ai_scraper?(request.user_agent)
+
+        'text/markdown'
+      end
+
+      def set_vary_header
+        headers['Vary'] = append_vary(headers['Vary'], 'User-Agent')
+        headers['Vary'] = append_vary(headers['Vary'], 'Accept')
+      end
+
+      def append_vary(existing, value)
+        values = existing.to_s.split(',').map(&:strip).reject(&:empty?)
+        return value if values.empty?
+        return existing if values.any? { |entry| entry.casecmp(value).zero? }
+
+        (values + [value]).join(', ')
+      end
+
       private :handle_request
     end
   end

data/lib/trifle/docs/engine.rb

@@ -37,7 +37,7 @@ if Object.const_defined?('Rails')
           return render_not_found if content.nil?
           return render_not_found if !allow_empty && content.strip.empty?
 
-          render plain: content, content_type: 'text/markdown'
+          render plain: content, content_type: 'text/plain'
         end
 
         def render_sitemap(url)
@@ -73,7 +73,7 @@ if Object.const_defined?('Rails')
             meta: meta,
             raw_content: Trifle::Docs.raw_content(url: url, config: configuration),
             sitemap: Trifle::Docs.sitemap(config: configuration)
-          ), content_type: 'text/markdown'
+          ), content_type: markdown_content_type
         end
 
         def fetch_meta(url)
@@ -81,6 +81,7 @@ if Object.const_defined?('Rails')
         end
 
         def render_for_meta(meta, url, wants_md, request)
+          set_vary_header unless file_meta?(meta)
           return render_markdown(url: url, meta: meta) if render_markdown?(meta, wants_md, request)
           return render_file(meta: meta) if file_meta?(meta)
 
@@ -110,6 +111,25 @@ if Object.const_defined?('Rails')
 
           request.headers['Accept'].to_s.include?('text/markdown')
         end
+
+        def markdown_content_type
+          return 'text/plain' if Trifle::Docs::Helper::AiDetection.ai_scraper?(request.user_agent)
+
+          'text/markdown'
+        end
+
+        def set_vary_header
+          response.headers['Vary'] = append_vary(response.headers['Vary'], 'User-Agent')
+          response.headers['Vary'] = append_vary(response.headers['Vary'], 'Accept')
+        end
+
+        def append_vary(existing, value)
+          values = existing.to_s.split(',').map(&:strip).reject(&:empty?)
+          return value if values.empty?
+          return existing if values.any? { |entry| entry.casecmp(value).zero? }
+
+          (values + [value]).join(', ')
+        end
       end
 
       class PageController < ActionController::Base

data/lib/trifle/docs/version.rb

@@ -2,6 +2,6 @@
 
 module Trifle
   module Docs
-    VERSION = '0.7.0'
+    VERSION = '0.7.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trifle-docs
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Jozef Vaclavik
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-27 00:00:00.000000000 Z
+date: 2026-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler