Search Tool

Overview

Steelkilt provides powerful search tools to help you find:

  • Text and code
  • Documents and Chapters with keywords
  • Documents, Chapters and Resources with tags

Replace is available for text-based searches.

Actions

Use the action control to:

  • Choose find or replace
  • Choose what you will find or replace
  • Choose how you will find or replace

For some selections, case-sensitive options will be available:

  • Ignore case
  • Match case

The table below lists all the possible search actions.

ActionCase sensitive Description
Find > text > containingYFinds text that contains the specified characters.
Replace > text > containingYReplaces the matching portion of text that contains the specified characters.
Find > text > matchingYFinds text that matches a wildcard pattern.

Examples:

ca* will match any word the begins with ca.

ca? will only match three-letter works beginning with ca.
Replace > text > matchingYReplaces the matching portion of text that matches the specified wildcard pattern.

Matches in the same way as Find > text > matching.
Find > regular expressionYFinds text that matches a regular expression.

Read http://userguide.icu-project.org/strings/regexp for regular expression operators and usage.
Replace > regular expressionYReplaces the matching portion of text that matches the specified regular expression.

Read http://userguide.icu-project.org/strings/regexp for regular expression operators and usage.
Find > keywords > containingNFinds Documents and Chapters with keywords that contain the specified text.
Find > keywords > matchingNFinds Documents and Chapters with keywords that match the specified wildcard pattern.

Matches in the same way as Find > text > matching.
Find > keywords > beginning withNFinds Documents and Chapters with keywords that begin with the specified text.
Find > keywords > ending withNFinds Documents and Chapters with keywords that end with the specified text.
Find > tagsNFinds Documents, Chapters and Resources with the specified tag(s).

This action is dependent on Scope (see below).

Scope

Use the scope control to:

  • Choose between searching text or code
  • Limit your searches to specific Books and Parts when searching text
  • Limit your searches to specific Resource types when searching code

The options that are available for scope depend on:

  • The number of Books in your Steelkilt Project
  • The existence of Parts in any Book

The table below lists the possible scope combinations.

ScopeDescription
Text > EverythingSearches text in single-Book projects.
Text > All BooksSearches text in multiple-Book projects.
Text > A BookSearches text in the specified Book within a multiple-Book project.
Text > A Book > EverythingSearches text in the specified Book within a multiple-Book project, without limiting the search to any Part.
Text > A Book > A PartSearches text in a specified Book within a multiple-Book project, limiting the search to a specific Part.
Code > EverythingSearches the content of all text-based Resources in a single-Book project.
Code > TemplatesSearches the content of all Templates in a single-Book project.
Code > XMLSearches the content of all XML-based Resources in a single-Book project.

XML-based Resources include: OPF files and any file with an .xml extension.
Code > XHTMLSearches the content of all XHTML-based Resources in a single-Book project.

XHTML-based Resources include: any file with an .xhtml, .html and .htm extensions.
Code > CSSSearches the content of all CSS-based Resources in a single-Book project.

CSS-based Resources include: any file with a .css extension.
Code > All Books > Everything etc.Searches the content of Resources in a multiple-Book project.

Searches can be narrowed to Templates, XML, XHTML and CSS (see above).
Code > A Book > Everything etc.Searches the content of Resources in a specific Book within a multiple-Book project.

Searches can be narrowed to Templates, XML, XHTML and CSS (see above).