Book Settings

Overview

The Book Settings panel in Steelkilt is designed to collect and store information relevant to:

  • Your target EPUB version
  • How your EPUB will be identified and described
  • EPUB formatting

Note

If you don’t plan on publishing an EPUB version of your Book, then you can ignore all the settings except for Title (which is needed to identify your book in the Steelkilt interface).

Identification and Description

This section accommodates that most popular elements of an EPUB’s metadata.

SettingRequired/optionalDescription
TitleRequiredIdentifies the book in the Steelkilt user interface and non-EPUB exports, and represents the <dc:title> child element of OPF <metadata>.

Book titles must be unique in the Project.
IdentifierRequired for EPUBRepresents the <dc:identifier> child element of OPF <metadata>.
CreatorOptionalIdentifies the author in non-EPUB exports and represents the <dc:creator> child element of OPF <metadata.
PublishedOptionalRepresents the <dc:date> child element of OPF <metadata.
LanguageRequired for EPUBRepresents the <dc:language> child element of OPF <metadata>.
DescriptionOptionalRepresents the <dc:description> child element of OPF <metadata>.
PublisherOptionalRepresents the <dc:publisher> child element of OPF <metadata>.
Cover ImageOptionalAn image for use in:

  • EPUB cover (a manifest item)
  • Book’s title page (title.xhtml)

Lock Icon

Changes to most settings will be automatically written to the OPF file that represents the XHTML rendition of your EPUB (book.opf). If you edit book.opf, the Book Settings will be disabled and the padlock icon on the top right will lock.

Click on the padlock icon to review book.opf.

Additional Attributes

Your selected EPUB Version Setting (see below) will determine:

  • Which attributes are available
  • How the attributes and values configured in Book Settings will be translated into XML code in book.opf

To add an attribute:

  • Click the plus icon (➕) beneath the Additional Attributes table
  • Choose an attribute from the popup menu containing the attributes associated with your EPUB Version
  • Choose/enter a value for the selected attribute

Where an attribute has a finite set of values that is published in an EPUB specification, a popup menu containing the available options will be available. Otherwise, you must type your own value.

EPUB Version 3.0.1 Attributes

AttributeEPUB equivalent
Title – Normalized Form (for Sorting)Value of <meta> that refines <dc:title> with an ‘file-as‘ property set.
Title – Base Text Directiondir attribute of <dc:title>.
Title – Alternative ScriptValue of <meta> that refines <dc:title> with an ‘alternate-script‘ property set.
Title – Alternative Script Languagexml:lang attribute of <meta> that refines <dc:title> with an ‘alternate-script‘ property set.

(Will be ignored unless Title – Alternative Script is present)
Title – XML Languagexml:lang attribute of <dc:title>.
Identifier – Schemescheme attribute of <meta> that refines <dc:identifier> with an ‘identifier-type‘ property set.

(Must be paired with Identifier – Type)
Identifier – TypeValue of <meta> that refines <dc:identifier> with an ‘identifier-type‘ property set.

(Must be paired with Identifier – Scheme)
Creator – Normalized Form (for Sorting)Value of <meta> that refines <dc:creator> with an ‘file-as‘ property set.
Creator – Base Text Directiondir attribute of <dc:creator>.
Creator – RoleValue of <meta> that refines <dc:creator> with an ‘role‘ property set.

When no Creator – Role Scheme attribute is set, Steelkilt will assume that the Creator – Role Scheme is ‘marc:relators‘ and allow you to pick a role from that scheme.
Creator – Role Schemescheme attribute of <meta> that refines <dc:creator> with an ‘role‘ property set.

If you set this attribute to anything other than ‘marc:relators‘, you will have to manually enter a Creator – Role code for your chosen scheme.
Creator – Alternative ScriptValue of <meta> that refines <dc:creator> with an ‘alternate-script‘ property set.
Creator – Alternative Script Languagexml:lang attribute of <meta> that refines <dc:creator> with an ‘alternate-script‘ property set.

(Will be ignored unless Creator – Alternative Script is present)
Creator – XML Languagexml:lang attribute of <dc:creator>.
Description – Base Text Directiondir attribute of <dc:description>.
Description – XML Languagexml:lang attribute of <dc:description>.
Publisher – Normalized Form (for Sorting)Value of <meta> that refines <dc:publisher> with an ‘file-as‘ property set.
Publisher – Base Text Directiondir attribute of <dc:publisher>
Publisher – Alternative ScriptValue of <meta> that refines <dc:publisher> with an ‘alternate-script‘ property set.
Publisher – Alternative Script Languagexml:lang attribute of <meta> that refines <dc:publisher> with an ‘alternate-script‘ property set.

(Will be ignored unless Publisher – Alternative Script is present)
Publisher – XML Languagexml:lang attribute of <dc:publisher>.
Contributor<dc:contributor>
Contributor – RoleValue of <meta> that refines <dc:contributor> with an ‘role‘ property set.

When no Contributor – Role Scheme attribute is set, Steelkilt will assume that the Contributor – Role Scheme is ‘marc:relators‘ and allow you to pick a role from that scheme.
Contributor – Role Schemescheme attribute of <meta> that refines <dc:contributor> with an ‘role‘ property set.

If you set this attribute to anything other than ‘marc:relators‘, you will have to manually enter a Contributor – Role code for your chosen scheme.
Contributor – Normalized Form (for Sorting)Value of <meta> that refines <dc:contributor> with an ‘file-as‘ property set.
Contributor – Base Text Directiondir attribute of <dc:contributor>
Contributor – Alternative ScriptValue of <meta> that refines <dc:contributor> with an ‘alternate-script‘ property set.
Contributor – Alternative Script Languagexml:lang attribute of <meta> that refines <dc:contributor> with an ‘alternate-script‘ property set.

(Will be ignored unless Contributor – Alternative Script is present)
Contributor – XML Languagexml:lang attribute of <dc:contributor>
Subject<dc:subject>
Subject – Base Text Directiondir attribute of <dc:subject>
Subject – XML Languagexml:lang attribute of <dc:subject>
Coverage<dc:coverage>
Coverage – Base Text Directiondir attribute of <dc:coverage>
Coverage – XML Languagexml:lang attribute of <dc:coverage>
Type<dc:type>
Format<dc:format>
Source<dc:source>
Source – Schemescheme attribute of <meta> that refines <dc:source> with an ‘identifier-type‘ property set.

(Must be paired with Source – Identifier Type and Source – Of Pagination)
Source – Identifier TypeValue of <meta> that refines <dc:source> with an ‘identifier-type‘ property set.

(Must be paired with Source – Scheme and Source – Of Pagination)
Source – Of PaginationValue of <meta> that refines <dc:source> with an ‘source-of‘ property set.

(Must be paired with Source – Scheme and Source – Identifier Type)
Relation<dc:relation>
Relation – Base Text Directiondir attribute of <dc:relation>.
Relation – XML Languagexml:lang attribute of <dc:relation>.
Rights<dc:rights>
Rights – Base Text Directiondir attribute of <dc:rights>.
Rights – XML Languagexml:lang attribute of <dc:rights>.

For more information, read:

EPUB Publications 3.0.1

EPUB Version 3.1 Attributes

AttributeEPUB equivalent
Title – Normalized Form (for Sorting)opf:file-as attribute of <dc:title>.
Title – Base Text Directiondir attribute of <dc:title>.
Title – Alternative Representationopf:alt-rep attribute of <dc:title>.
Title – Alternative Representation Languageopf:alt-rep-lang attribute of <dc:title>.

(Will be ignored unless Title – Alternative Representation is present)
Title – XML Languagexml:lang attribute of <dc:title>.
Identifier – Schemeopf:scheme attribute of <dc:identifier>.
Creator – Normalized Form (for Sorting)opf:file-as attribute of <dc:creator>.
Creator – Base Text Directiondir attribute of <dc:creator>.
Creator – Roleopf:role attribute of <dc:creator>.

Must be a role from the ‘marc:relators‘ scheme.
Creator – Alternative Representationopf:alt-rep attribute of <dc:creator>.
Creator – Alternative Representation Languageopf:alt-rep-lang attribute of <dc:creator>.

(Will be ignored unless Creator – Alternative Representation is present)
Creator – XML Languagexml:lang attribute of <dc:creator>.
Description – Base Text Directiondir attribute of <dc:description>.
Description – XML Languagexml:lang attribute of <dc:description>.
Publisher – Normalized Form (for Sorting)opf:file-as attribute of <dc:publisher>.
Publisher – Base Text Directiondir attribute of <dc:publisher>.
Publisher – Alternative Representationopf:alt-rep attribute of <dc:publisher>.
Publisher – Alternative Representation Languageopf:alt-rep-lang attribute of <dc:publisher>.

(Will be ignored unless Publisher – Alternative Representation is present)
Publisher – XML Languagexml:lang attribute of <dc:publisher>.
Contributor<dc:contributor>
Contributor – Normalized Form (for Sorting)opf:file-as attribute of <dc:contributor>.
Contributor – Base Text Directiondir attribute of <dc:contributor>.
Contributor – Roleopf:role attribute of <dc:contributor>.

Must be a role from the ‘marc:relators‘ scheme.
Contributor – Alternative Representationopf:alt-rep attribute of <dc:contributor>.
Contributor – Alternative Representation Languageopf:alt-rep-lang attribute of <dc:contributor>.

(Will be ignored unless Contributor – Alternative Representation is present)
Contributor – XML Languagexml:lang attribute of <dc:contributor>.
Subject<dc:subject>
Subject – Base Text Directiondir attribute of <dc:subject>.
Subject – XML Languagexml:lang attribute of <dc:subject>.
Subject – Authorityopf:authority attribute of <dc:subject>.
Subject – Termopf:term attribute of <dc:subject>.

(Will be ignored unless Subject – Authority is present)
Coverage<dc:coverage>
Coverage – Base Text Directiondir attribute of <dc:coverage>.
Coverage – XML Languagexml:lang attribute of <dc:coverage>.
Type<dc:type>
Format<dc:format>
Source<dc:source>
Source – Schemeopf:scheme attribute of <dc:source>.
Relation<dc:relation>
Relation – Base Text Directiondir attribute of <dc:relation>.
Relation – XML Languagexml:lang attribute of <dc:relation>.
Rights<dc:rights>
Rights – Base Text Directiondir attribute of <dc:rights>.
Rights – XML Languagexml:lang attribute of <dc:rights>.

For more information, read:

EPUB Packages 3.1

EPUB Version 3.2 Attributes

The attributes available for EPUB Version 3.2 at the same as those for EPUB Version 3.0.1, plus the following:

AttributeEPUB equivalent
Subject – TermValue of <meta> that refines <dc:subject> with an ‘term‘ property set.

(Must be paired with Subject and Subject – Authority)
Subject – AuthorityValue of <meta> that refines <dc:subject> with an ‘authority‘ property set.

(Must be paired with Subject and Subject – Term)

For more information, read:

EPUB Packages 3.2

Note on Complex Attribute Arrangements

Book Settings can accommodate only one instance of each DCMES element (such as <dc:identifier>, <dc:creator>, <dc:contributor> etc.)

If you need to have more than one instance of any DCMES element (or find that Book Settings does not provide you with enough flexibility), then consider the following strategy:

  • Use Book Settings to the extent possible
  • Supplement the attributes configured in Book Settings with the available Extensions.

Avoid direct edits to book.opf. Doing so will prevent it from being included in Steelkilt’s automatic EPUB Generation.

Compilation

SettingDescription
EPUB VersionThe target EPUB version for EPUB compilation and export.

Choose from:

  • 3.0.1 (default)
  • 3.1
  • 3.2

Changing this setting will affect:

  • The range of available attributes (see above) in Book Settings
  • The content of the automatically generated resources that will make up your EPUB
FormattingSee Formatting for details

Warning

Changing EPUB versions will delete any attribute/value pairs that are not compatible with the new EPUB Version.