jekyll-devto 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1aa5e1f448c0e19e840473d8829de5c76d9db2f9f27c9e919243086d07d2b7f9
-  data.tar.gz: 9abb009ac797c5009074a1120fca05c0fd15771a7404afa4b3f3ea44f53f4574
+  metadata.gz: e5d68c73dff2c64c76de9bd3e8fc0d9e130d89cc9abc0f49473b69ce4d55a2e3
+  data.tar.gz: 791dfd16298f0b7d0ca0126594419a812fc3a84aa3da46e0c8da7690a6a45c0a
 SHA512:
-  metadata.gz: 3557c4a83b0c514893f5acbce8f0ff78fecab9c2139d02a06c65bbfd5299d2324c8d2f88d83a432358a58d1ff93e7accbb941d552e0421364088d052af4d80a8
-  data.tar.gz: 25efecb7281df14f9aadb89cf25a756aba07fa99dc1f73b07b63e7ee401bb0e7f155367f91002a9efd26ed334f40433dc3e2af70005a6440e07fe4db847dba65
+  metadata.gz: 38c78047e58a1557a7327d3b95104342bf5920ce365dfb3ea3c8665227ab83297c0c9bed6dd0e30ea1a499e5af28d8b7b7fcc24374c5e234384dec4116c722c2
+  data.tar.gz: 92cc3df16600b846a8a08868033f54e051e7415d747671a0e88e730c95f7e220e942eb14b3be61700e181a08a220db23ec9ea4836140b1cc07220c674231d3d4

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [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,9 +29,23 @@
       <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 %}

data/lib/jekyll/devto/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module Devto
-    VERSION = '0.2.0'
+    VERSION = '0.3.0'
   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.0
 platform: ruby
 authors:
 - Juan Vásquez