jekyll-devto 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1aa5e1f448c0e19e840473d8829de5c76d9db2f9f27c9e919243086d07d2b7f9
-  data.tar.gz: 9abb009ac797c5009074a1120fca05c0fd15771a7404afa4b3f3ea44f53f4574
+  metadata.gz: 9b8f57cf2fb543865943e101591c785ab55fa902cd77ea72a8022aa71d347074
+  data.tar.gz: 1f1797416470e4cb8391503f5141a19576091d96a0488150836e49df601a8b09
 SHA512:
-  metadata.gz: 3557c4a83b0c514893f5acbce8f0ff78fecab9c2139d02a06c65bbfd5299d2324c8d2f88d83a432358a58d1ff93e7accbb941d552e0421364088d052af4d80a8
-  data.tar.gz: 25efecb7281df14f9aadb89cf25a756aba07fa99dc1f73b07b63e7ee401bb0e7f155367f91002a9efd26ed334f40433dc3e2af70005a6440e07fe4db847dba65
+  metadata.gz: 9c6e5bea0a3edeaaa4ae757b432f0b43f3f2dcbb6b9997896e35ba27292e71b71805df4bc1040fef658c8b92b41a419c16a40ca5484b8492a9f0e8d1bc3db864
+  data.tar.gz: e84f567be97bcf106a10b0145483db93c2fb19d9ab04e308bf00e71ca5ad7eeeab031a34ce7a8732a4c693c48f5e9706a08cf7116b7b0af4873d99457e0a1951

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.3.1](https://github.com/JuanVqz/jekyll-devto/compare/v0.3.0...v0.3.1) (2026-10-02)
+
+
+### Bug Fixes
+
+* **feed:** ignore front matter values of the wrong type instead of crashing ([#16](https://github.com/JuanVqz/jekyll-devto/issues/16)) ([a890385](https://github.com/JuanVqz/jekyll-devto/commit/a890385ad4427fb2875f78e723d4f750eadcfb6b))
+
+## [0.3.0](https://github.com/JuanVqz/jekyll-devto/compare/v0.2.0...v0.3.0) (2026-10-02)
+
+
+### ⚠ BREAKING CHANGES
+
+* **feed:** posts no longer get their image as the dev.to cover by default. Set devto: { cover: image } in _config.yml to keep the 0.2.0 behavior.
+
+### Features
+
+* **feed:** add a dev.to cover only when asked for ([#14](https://github.com/JuanVqz/jekyll-devto/issues/14)) ([9e9b43f](https://github.com/JuanVqz/jekyll-devto/commit/9e9b43f9422cee3ef4fd7a47aa483347bf5bfde8))
+
 ## [0.2.0](https://github.com/JuanVqz/jekyll-devto/compare/v0.1.0...v0.2.0) (2026-10-02)
 
 

data/README.md

@@ -49,16 +49,22 @@ All optional.
 devto:
   path: "/devto.xml" # where the feed is written
   limit: 20          # newest posts to include (default: all)
+  cover: image       # use each post's image as its dev.to cover (default: no cover)
 ```
 
 To keep a post off dev.to, set `devto: false` in its front matter.
 
-**Cover image.** `jekyll-devto publish` gives each post a dev.to cover: `devto_cover` from the post's front matter, or else the post's `image` (a path, a URL, or `{ path: ... }`, which is what [jekyll-og-image](https://github.com/igor-alexandrov/jekyll-og-image) and Chirpy use). A cover already set on the dev.to draft is kept.
+**Cover image.** No cover by default. Many Open Graph images, including the ones [jekyll-og-image](https://github.com/igor-alexandrov/jekyll-og-image) and Chirpy produce, already carry the post title, which dev.to shows right under the cover, and without a cover dev.to generates its own share image. To add one:
+
+- `devto_cover:` on a post sets that post's cover, and always wins. `devto_cover: true` uses the post's `image`, and `devto_cover: false` turns the cover off for that post.
+- `cover: image` under `devto:` in `_config.yml` uses each post's `image` (a path, a URL, or `{ path: ... }`) for every post, for sites whose images have no title on them.
 
 ```yaml
-devto_cover: /assets/img/devto-cover.png # optional
+devto_cover: /assets/img/devto-cover.png # optional, per post
 ```
 
+`jekyll-devto publish` adds the cover to the draft; a cover already set on the dev.to draft is kept. dev.to crops covers to 1000×420.
+
 **Tags and series.** dev.to keeps only the first four tags, as lowercase letters and digits (`tailwind-css` becomes `tailwindcss`). `devto_tags` picks them for dev.to; it is used for the import and also replaces the tags of a draft that was already imported. `devto_series` puts the post in a dev.to series, created if it does not exist; a series already set on the draft is kept.
 
 ```yaml

data/lib/jekyll/devto/feed.xml

@@ -29,17 +29,32 @@
       <category>{{ tag | xml_escape }}</category>
     {%- endfor %}
       <description>{{ post.description | default: post.excerpt | strip_html | strip_newlines | truncatewords: 60 | xml_escape }}</description>
-    {%- comment -%} The dev.to cover: devto_cover, else the post image (jekyll-og-image sets it). {%- endcomment -%}
-    {%- comment -%} Unlike content links, image paths leave baseurl out (Chirpy and jekyll-og-image add it when rendering). {%- endcomment -%}
-    {%- assign cover = post.devto_cover | default: post.image | devto_url: site_root %}
+    {%- comment -%}
+      The dev.to cover is opt-in: many Open Graph images carry the post title, which dev.to
+      already shows under the cover, and without one dev.to generates its own share image.
+      devto_cover on a post always wins (false turns it off, true uses the post image);
+      `devto: { cover: image }` in _config.yml uses each post's image. Unlike content
+      links, image paths leave baseurl out (Chirpy and jekyll-og-image add it when
+      rendering), so the cover needs it.
+    {%- endcomment -%}
+    {%- assign cover = "" %}
+    {%- if post.devto_cover == false %}
+    {%- elsif post.devto_cover == true %}
+      {%- assign cover = post.image | devto_url: site_root %}
+    {%- elsif post.devto_cover %}
+      {%- assign cover = post.devto_cover | devto_url: site_root %}
+    {%- elsif devto.cover == "image" or devto.cover == true %}
+      {%- assign cover = post.image | devto_url: site_root %}
+    {%- endif %}
     {%- if cover != "" %}
       <devto:cover>{{ cover | xml_escape }}</devto:cover>
     {%- endif %}
     {%- if devto_tags %}
       <devto:tags>{{ devto_tags | join: "," | xml_escape }}</devto:tags>
     {%- endif %}
-    {%- if post.devto_series %}
-      <devto:series>{{ post.devto_series | xml_escape }}</devto:series>
+    {%- assign devto_series = post.devto_series | devto_text %}
+    {%- if devto_series %}
+      <devto:series>{{ devto_series | xml_escape }}</devto:series>
     {%- endif %}
       <content:encoded>{{ post.content | devto_html: site_url | xml_escape }}</content:encoded>
     </item>

data/lib/jekyll/devto/html.rb

@@ -87,7 +87,12 @@ module Jekyll
       # { "path" => ... } hash; nil when there is nothing to point at.
       def absolute_url(value, base_url)
         path = value.is_a?(Hash) ? value['path'] : value
-        return if path.to_s.empty?
+        # Front matter is YAML, so this can be true, a number or a list; only a
+        # string is a path, anything else is ignored rather than crashing the build.
+        return unless path.is_a?(String)
+
+        path = path.strip
+        return if path.empty?
         return path if path.match?(%r{\Ahttps?://})
         return "#{base_url.to_s[/\A[a-z][a-z0-9+.-]*:/i] || 'https:'}#{path}" if path.start_with?('//')
 
@@ -126,11 +131,22 @@ module Jekyll
       # string ("ruby, rails" or "ruby rails", as Jekyll accepts for tags), so
       # the import and the publisher see the same tags. nil when there are none.
       def devto_list(value)
-        list = value.is_a?(Array) ? value.map(&:to_s) : value.to_s.split(/[,\s]+/)
+        list = case value
+               when Array then value.filter_map { |item| devto_text(item) }
+               when String, Numeric then value.to_s.split(/[,\s]+/)
+               else []
+               end
         list = list.map(&:strip).reject(&:empty?)
         list unless list.empty?
       end
 
+      # A front matter value as text when it is one (a string or a number);
+      # nil for true, false, lists and hashes, which mean nothing as a name.
+      def devto_text(value)
+        text = value.to_s.strip if value.is_a?(String) || value.is_a?(Numeric)
+        text unless text.to_s.empty?
+      end
+
       def devto_url(value, base_url)
         HTML.absolute_url(value, base_url).to_s
       end

data/lib/jekyll/devto/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module Devto
-    VERSION = '0.2.0'
+    VERSION = '0.3.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-devto
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Juan Vásquez