Resource Settings

Overview

Custom Resource Settings
Resource Settings for Non-custom Resource with Tip

To access Resource Settings:

  • Open Code Navigator
  • Select a Resource
  • Tap on the Settings button at the top-right corner of the toolbar

The information and controls shown in the Inspector will vary depending on the kind of Resource you have selected:

  • For automatically generated Resources (such as Templates, Extensions, container.xml, book.opf, book.css and XHTML Resources for Parts, Documents and Chapters etc.), you will see information and controls associated with:
    • Explanatory text describing the Resource and its purpose
    • Lock status (if applicable)
    • Tags
  • For custom Resources (i.e. Resources you have added to the Steelkilt Project), you will see information and controls associated with:
    • Identification
    • Package (book.opf)
    • Style Placeholder
    • Attributes
    • Tags

Settings for Automatically Generated Resources

Lock Icon

If you edit an automatically generated Resource, the Resource will be locked. This is to ensure that your customizations are preserved during EPUB Generation. If you want to unlock the Resource, tap on the Unlock button beneath the tip text.

Warning when unlocking Resources

When the EPUB is regenerated, any customizations you have made to the Resource will be lost.

Tags

Allows you to tag or untag a Resource.

Tags can be used in Search Tool.

Settings for Custom Resources

Identification

The section accommodates information used to identify the Resource.

SettingDescription
TitleIdentifies the Resource in the Steelkilt user interface and exports.

Use this control to rename a Resource.

Package (book.opf)

The following settings:

  • Allow you to specify the Resource’s Media Type
  • Control inclusion in the default XHTML rendition’s Package manifest
  • Control inclusion in the default XHTML rendition’s Package spine
SettingDescription
Media TypeMedia Type is an EPUB-version-specific setting that is used in the book.opf <manifest> item entry that represents the Resource.

Select from the available options. If you require a non-standard Media Type, choose Other (specified below) and enter a custom media type in the field below.
Include in ManifestThis option will be disabled for Resources without a Media Type.

Switch this option on if you want an <item> entry representing the Resource to be added to book.opf‘s <manifest> element.
Include in SpineThis option will be disabled for Resources without a Media Type or Include in Manifest switched off.

Switch this option on if you want an <itemref> entry representing the Resource to be added to book.opf‘s <spine> element.

Read the EPUB Specifications for more information on EPUB Package documents (OPFs).

Style Placeholder

This setting only applies to CSS Resources that are located in the Package/XHTML/Style folder.

Change the Resource’s file extension to .css to automatically set the Media Type to text/css and enable this option.

SettingDescription
Include in List of StylesDuring EPUB Generation, the <%=styles%> placeholder in the <HTML> Template is replaced with a link to book.css and any other CSS Resources in Package/XHTML/Style with this option switched on.

This option is switched off by default. Switch this option on to include a link to the Resource in the list of styles.

Switching this option on will also switch on Include in Manifest.

Attributes

Shows some information about the Resource.

AttributeDescription
PathThe absolute path to the Resource in the EPUB.
UTIThe Uniform Type Identifier for the Resource. For imported files, this value is provided by the operating system. It can be useful when diagnosing EPUB Content Problems.
File ExtensionThe Resource’s file extension.
SizeFor Resources that represent a single file, the file size will be displayed.

For Resources that represent folders, the size of the folder’s contents will be displayed.
ChildrenFor Resources that represent folders, the number of child Resources will be shown.

Children will be N/A for Resources that represent a single file.

Tags

Allows you to tag or untag a Resource.

Tags can be used in Search Tool.


Related Topics