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

To access Book Settings:

  • Open Project Navigator
  • Tap on the Book Settings button in the toolbar at the bottom of Project Navigator

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>.
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 Status

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 associated with the Lock Status setting (under the Compilation Section) will lock.

Tap on the padlock icon open the Lock Status page. Tap on View Resource to review book.opf.

Other 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

Tap an attribute to change its value.

Where an attribute has a finite set of values that is published in an EPUB specification, a list 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.
Creator – Role SchemeNot editable in iOS/iPadOS.

Role Scheme is assumed to be ‘marc:relators‘.
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.
Contributor – Role SchemeNot editable in iOS/iPadOS.

Role Scheme is assumed to be ‘marc:relators‘.
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>.
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 – 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.