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 Author and 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 caret 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's 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. In case 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 of 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.