Epub Collector
The Epub collector works on content that is either an Epub file or a zip file containing an Epub and a PDF file. It handles any arbitrary sub-folder structure containing config files.
The collector uses meta data from the Epub, which is stored under ops/package.opf:
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://www.idpf.org/2007/opf" version="2.0" unique-identifier="1234567890">
<metadata xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:opf="http://www.idpf.org/2007/opf">
<dc:title>Example Paper</dc:title>
<dc:creator>...</dc:creator>
<dc:publisher>...</dc:publisher><dc:rights/>
<dc:identifier id="1234567890">1234567890</dc:identifier>
<dc:language>en</dc:language>
<dc:date opf:event="publication">2025-10-02</dc:date>
</metadata>From the metadata it uses dc:title and dc:date.
By default the title of the publication is matched with the Purple publication name. If that doesn't match, you can use the configuration options below to make it match. The date is used to map the publication date. If the issue is published the evening before the actual publication date, this can also be controlled by configuration. By default the name of the issue is also derived from the date (German date format), but the name pattern as well as all other meta data can be set in a config.properties file having the following configuration options (amongst all other Transformer Configurationtransformer configuration options options):
publication=... (Static publication name in Purple for all content)
publication.XYZ=... (Mapping publication XYZ to a Purple publication name)
namePattern=... (Name pattern for the issues)
iOSProductIdPattern=... (iOS product name pattern for the issues)
androidProductIdPattern=... (Android product name pattern for the issues)
webProductIdPattern=... (Web product name pattern for the issues)
issueNumberPattern=... (Issue number product name pattern for the issues)
issueAliasPattern=... (Issue alias product pattern for the issues)Each pattern is a value that may contain the following variables:
Variable | Example | Description |
|---|---|---|
{d|<date pattern>|<language} | English date formatted issue name: namePattern={d|dd/MM/yyyy|en} German date formatted issue name: namePattern={d|dd.MM.yyyy|de} | Date pattern (full pattern doc) |
{0} | iOSProductIdPattern={0}.{1} | Publication title from Epub |
{1} | androidProductIdPattern=com.mydomain.{1} | Publication date fro |