Org2blogでアイキャッチ画像(投稿サムネイル, featured image, post thumbnail)を指定するオプションを追加しました。次のように書けます。

#+TITLE: Org2blogでアイキャッチ画像を設定する
#+POST_THUMBNAIL: ./some-featured-image.jpg

• https://github.com/misohena/org2blog/commit/ffbb7146f3a571db7841aac89f41bb3e93c578ca
• https://github.com/misohena/org2blog/commit/f3e9385d11d1d6711033da71bf31e4e58cd8ea53 (2019-03-20最新版に追従)
• https://github.com/misohena/org2blog/commit/d1687b9f4ff629598bd53e5114fb0d6c11cb7c38 (2019-10-20最新版に追従＆ファイルが無いときの処理を追加)

ファイル名が変わっていたらアップロードして再設定します。オプションを空文字列にすればアイキャッチ画像は投稿から取り外されます。ただし、APIからメディアを削除する方法が分からなかったので変わる前の画像はメディアライブラリに残り続けますのでご注意を。

ソースコード全体としては https://github.com/misohena/org2blog の image-fix ブランチで提供しています。

このBlogは Org2blog + WordPress で書かれているわけなんですが、画像を張るときにちょっと気になることがあります。

それは画像のサイズを個別に指定する標準的な方法が無いこと。 org2blog/wp-image-thumbnails と org2blog/wp-image-thumbnail-size という設定があってそれを使えば全体でサイズを指定出来るのですが、一つの文書の中でこの画像はどうでもいいので小さくしたい、この画像は重要なので大きくしたい、といった個別に指定する方法が用意されていません。

最終的にHTMLでエクスポートされるので、画像(img要素)に対してstyleやwidth属性を設定すれば無理矢理大きさを変えられます。

#+ATTR_HTML: :width 240px
[[file:./a.png]]

しかしこの場合、あくまで表示時に縮小することになるため不必要に大きな画像をダウンロードすることになります。WordPress側ではアップロード時にいくつかの解像度差分を自動的に生成してくれているのに勿体ない話です。

というわけで、作ったのが次のパッチ。

• https://github.com/misohena/org2blog/commit/244fdc04ec0d470ce4434c21b4c6476840d25632
• https://github.com/misohena/org2blog/commit/5adca9e1215cf2d0c7738e86444c95817b1ad855 (2019-03-20最新版に追従)
• (2019-10-20最新版に追従＆二つのパッチを統合)

imgのwidth=を見て適切なサイズの画像を選ぶようにしてみました。

ただ、実はこれだけでは不十分で、同じ画像をサイズを変えて何度も使いたい場合にうまくいきません。org2blogは内部で一つのファイル名に対して一つのサムネイルサイズを前提にしているため、最初に指定した画像リンクのサイズが以降使われてしまいます。

それを解決してみたのが次のパッチ(一つ目のパッチを前提にしています)。

• https://github.com/misohena/org2blog/commit/fb74f87429883ed04aa00781e4e21c8e4a873ded
• https://github.com/misohena/org2blog/commit/38eef7a290bef8b6d2195cdd4a21df9182f77040 (2019-03-20最新版に追従)
• (2019-10-20最新版に追従＆二つのパッチを統合)

これによって同じ文書の中であっても次のような指定が可能になります。

# mediumサイズが使われる
#+ATTR_HTML: :width 200px
[[file:./a.png]]

# largeサイズが使われる
#+ATTR_HTML: :width 640px
[[file:./a.png]]

# org2blog/wp-image-thumbnail-sizeで指定したサイズが使われる
[[file:./a.png]]

ソースコード全体としては https://github.com/misohena/org2blog の image-fix ブランチで提供しています。

https://github.com/misohena/org2blog/commits/image-fix