README.md 2.6 KB

Pelican JPEG Reader.

Original author: Mitchell Currie

Requirements:
  • Python3
  • Pelican
  • Pillow library (PIL for python3)
  • Exiv2 binary accessible by $PATH

To avoid undesired creation of content, the specific extension must be jpeg_article, i.e. "myPhoto.jpeg_article", it's a regular JPEG image, but this avoids your other JPEG images getting picked up. It can work for pages or blogs, and determines based on whether it's content/blog or content/pages (or whatever you use for content).

Most relevant EXIF/IPTC flags from Exiv2 that are used

Page/Article Field Exiv2 Key Description
title Exif.Image.ImageDescription Defaults to 'Untitled'
author Exif.Image.Artist Default to Unknown. Currently Scalar
date Exif.Photo.DateTimeOriginal Undefined behaviour if not present as required
slug Iptc.Application2.Headline Defaults to title's value
body Exif.Photo.UserComment This goes under image in page/article, blank default
summary Iptc.Application2.Caption Used for article index, defaults to first 140 characters of the body
category Iptc.Application2.SuppCategory Specifies the category of page/article if USE_FOLDER_AS_CATEGORY not set
template Iptc.Application2.ObjectName If specified will set the template metadata property to tell pelican where to look
tags Iptc.Application2.Keywords For each entry found with this key, a tag is created with the value of the entry
metadata['exiv2'] Everything All exiv2 fields from the image are shoved into the metadata dictionary of the item, under exiv2 key for template usage

Pelican Settings Added or Honoured:

Key in pelicanconf.py Description
PATH Content Path
OUTPUT_PATH Output Path
USE_FOLDER_AS_CATEGORY Category from folder name If enabled, takes the category from the name of the folder the file is in. Otherwise the category will attempt to be read from Iptc.Application2.SuppCategory
SITEURL Site Url The optional absolute Url for the site, defaults to '' usually.
PAGE_URL Page Url The format string to specify where page html files are saved to
PAGE_SAVE_AS Page Save Path The format string to specify where page html files are physically written to disk
ARTICLE_URL ** Article Url** The format string to specify where page html files are saved to
ARTICLE_SAVE_AS Article Save Path The format string to specify where page html files are physically written to disk