The Open/Find Resource view is designed to offer advanced search
capabilities either by using a simple text search or by using the Apache Lucene - Query Parser Syntax. To open this
view, go to . The view is presented in the left side of the default Oxygen XML Editor
layout, next to the Project and DITA Maps
Manager views.
Figure: The Open/Find Resource View
You can use this view to find a file in the current
Oxygen XML Editor project
or in one of the DITA maps opened in the DITA Maps Manager view
by typing only a few letters of the file name of a document or a fragment of the content
you are searching for. The Open/Find Resource view also supports searching in document edits
(comments, insertions, deletions, and highlighted content).
Note: Full support for searching in document edits is available
only in the Enterprise edition of Oxygen XML Editor. The Professional edition offers
support to search through a maximum of 10 edits.
Search results are presented instantly, after you finish typing the content you are searching
for. The matching fragments of text are highlighted in the results list displayed in the view.
When you open one of the documents from the results list, the matching fragments of text are
highlighted in the editing area. To remove the highlighting from your document close the Results view. To display
the search history, position the cursor in the search field and press Ctrl Down Arrow (Command Down Arrow
on OS X) or Ctrl Up Arrow (Command Up Arrow on OS
X) on your keyboard. Pressing only
the Down Arrow key moves the selection
to the list of results.
A contextual menu available on each search result
provides actions applicable to the document that contains it. These actions allow you to:
- Open the document in one of Oxygen XML Editor internal editors.
- Open the document in an external system application.
- Identify the document in the system file explorer.
- Copy the file's location.
The content of the resources used to search in is parsed from an index. The indexing is
performed both automatically and on request.
Note: Automatic indexing is performed when you
modify, add, or remove resources in the currently indexed project. If the index was never
initialized, the index in not updated on project changes.
Note: To improve
performance, the indexing process skips the following set of common English words (the
so-called
stop words):
a, an, and, are, as, at, be, but, by, for, if, in,
into, is, it, no, not, of, on, or, such, that, the, their, then, there, these, they, this,
to, was, will, with. This means that if you are searching for any of these words,
Open/Find Resource view will not be able to match any of them.
However, you can configure the list of stop words in the Open/Find Resources Preferences Page.
Note: Searches are case insensitive. For example, if you search for
car you get the same results as when you search for Car.
Note: Suffix searches are supported, both for searching in the
content of your resources and in their name. For this, you can use wildcards. If you search
in content for *ing you will find documents
that contain the word presenting. If you search in file
paths for */samples/*.gif you will find all the gif
images from the samples directory.
Note: You can drag
a resource from the
Open/Find Resource view and drop it in a DocBook,
DITA, TEI or XHTML document to create a link to that resource.
The
Open/Find Resource view offers the following options:
- Settings - Displays settings for the view:
- Clear Index - Clears the index.
- Show description - Presents the search results in a more
compact form, displaying only the title and the location of the resources.
- Options - Opens the
Open/Find Resource preferences page.
- In file
paths - Select this option to search for resources by their name or
by its path (or a fragment of its path).
- In
content - Select this option to search through the content of your
resources.
- In
reviews - Select this option to search through the comments,
insertions, and deletion in your resources.
- Reindex - Reindexes your resources.