Image defined in frontmatter is current shown on the post listing and at the top of the post. Top of post is wide and possibly distorts the image. Some images might be suitable for both views, but adding heroImage option will allow specifying.
If not set, image gets used to for heroImage
If image not set, but heroImage set, don't show image on post listing page but do show hero image on post page
As above but image explicitly null - override post fallback image settings, and don't show an image on post listing page.
For fallback images, automatic rules for -hero equivalents of an image if being used as fallback.
i.e. a post doesn't have any images set. But python tag would cause python.png to be fallback. If python-hero.png (or any extension?) exists, use that for hero image.
Unless a post's heroImage is an explicit null to prevent image showing on post page at all.
Image defined in frontmatter is current shown on the post listing and at the top of the post. Top of post is wide and possibly distorts the image. Some images might be suitable for both views, but adding
heroImageoption will allow specifying.If not set,
imagegets used to forheroImageIf
imagenot set, butheroImageset, don't show image on post listing page but do show hero image on post pageAs above but
imageexplicitlynull- override post fallback image settings, and don't show an image on post listing page.For fallback images, automatic rules for
-heroequivalents of an image if being used as fallback.i.e. a post doesn't have any images set. But
pythontag would causepython.pngto be fallback. Ifpython-hero.png(or any extension?) exists, use that for hero image.Unless a post's
heroImageis an explicitnullto prevent image showing on post page at all.