summaryrefslogtreecommitdiff
path: root/docs/handbook/en/html/hdbk-op-search.html
blob: d2d1af81658e3108136e39337084174f3eb4b00a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Searching in works</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><meta name="keywords" content="Qt4, bibletime, sword, crosswire, help dialog"><link rel="home" href="index.html" title="The BibleTime handbook"><link rel="up" href="hdbk-op.html" title="Chapter�3.�Program operation"><link rel="prev" href="hdbk-op-parts.html" title="Parts of the BibleTime application window"><link rel="next" href="hdbk-op-bookshelfmanager.html" title="The Bookshelf Manager"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Searching in works</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="hdbk-op-parts.html">Prev</a></td><th width="60%" align="center">Chapter�3.�Program operation</th><td width="20%" align="right"><a accesskey="n" href="hdbk-op-bookshelfmanager.html">Next</a></td></tr></table><hr></div><div class="sect1" title="Searching in works"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="hdbk-op-search"></a>Searching in works</h2></div></div></div><div class="sect2" title="Searching text in an open read window"><div class="titlepage"><div><div><h3 class="title"><a name="hdbk-op-search-intext"></a>Searching text in an open read window</h3></div></div></div><p>You can look for a word or phrase in the open read window
      (e.g. the chapter of a bible that you're reading) just like you
      are used to from other programs. This function can be reached
      either by clicking with the 
      <span class="mousebutton">right</span> mouse button and selecting 
      <span class="guimenuitem">Find...</span>, or by using the shortcut  
      <span class="keycap"><strong>CtrlF</strong></span>. Read on to learn how you can
      search in entire works.</p></div><div class="sect2" title="Accessing the search dialog"><div class="titlepage"><div><div><h3 class="title"><a name="hdbk-op-search-access"></a>Accessing the search dialog</h3></div></div></div><p>You can search in a work by clicking with the 
      <span class="mousebutton">right</span> mouse button on its symbol in the
      
      <span class="guimenu">Bookshelf</span> and selecting 
      <span class="guimenuitem">Search in work(s)</span>. By holding
      Shift or Ctrl and clicking on other work's names you
      can select more than one. Then follow the same procedure to open
      the search dialog. You will be searching in all of these works at
      the same time.</p><p>You can also access the search dialog by clicking on 
      <span class="guimenu">Search</span> from the main menu, and selecting the appropriate
      entry.</p><p>A third possibility to start searches is to click on the
      search symbol in an open read window.</p></div><div class="sect2" title="Search configuration"><div class="titlepage"><div><div><h3 class="title"><a name="hdbk-op-search-config"></a>Search configuration</h3></div></div></div><div class="screenshot"><div class="mediaobject"><img src="ss_searchopts.png"></div></div><div class="sect3" title="Selecting works"><div class="titlepage"><div><div><h4 class="title"><a name="hdbk-op-search-config-works"></a>Selecting works</h4></div></div></div><p>At the top of the options tab you will find 
        <span class="guibutton">Choose</span>(works). If you would like to
        search in multiple works, click on this button and you will be
        offered a menu where you can select the works you want to
        search in.</p></div><div class="sect3" title="Using Search Scopes"><div class="titlepage"><div><div><h4 class="title"><a name="hd-op-search-config-scope"></a>Using Search Scopes</h4></div></div></div><p>You can narrow the scope of your search to certain parts
        of the Bible by selecting one of the predefined scopes from the
        list in 
        <span class="guimenu">Search scope</span>. You can define your own search
        ranges by clicking the 
        <span class="guibutton">Setup ranges</span> button.</p></div><div class="sect3" title="Basic Search Syntax Introduction"><div class="titlepage"><div><div><h4 class="title"><a name="hd-op-search-config-syntax"></a>Basic Search Syntax Introduction</h4></div></div></div><p>Enter the search phrase separated by spaces.  By default the
	  search function will return results that match all the
	  words.  If you want to find any of the words entered, select
	  the <span class="guimenu">Some words</span> button.  If you want to
	  perform a more complex search, select the 
	  <span class="guimenu">Free</span> button.  You can see examples of
	  searches by clicking on <span class="guimenu">full syntax</span>.
	  </p><p>You can use wildcards: '*' matches any number of
	  characters, while '?' will match any single character. The use of
	  brackets allows you to group your search terms, e.g. '(Jesus OR
	  spirit) AND God'.</p><p>To search text other than the main text, enter the text
	  type followed by ':', and then the search term.  Refer to the
	  table below for examples.</p><p>Available text types: 
        </p><div class="table"><a name="hd-op-search-config-syntax-table"></a><p class="title"><b>Table�3.1.�Search Types</b></p><div class="table-contents"><table summary="Search Types" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Prefix</th><th>Meaning</th><th>Example</th></tr></thead><tbody><tr><td>heading:</td><td>searches headings</td><td>heading:Jesus</td></tr><tr><td>footnote:</td><td>searches footnotes</td><td>footnote:Moses</td></tr><tr><td>strong:</td><td>searches Strong's Numbers</td><td>strong:G535</td></tr><tr><td>morph:</td><td>searches morphology codes</td><td>morph:N-GSM</td></tr></tbody></table></div></div><p><br class="table-break"></p><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>You can right click on an installed work and select
	    <span class="guimenu">About</span> to find which of the above search
	    criteria may work for you.  Not all works have the
	    built in features for performing this type of search.</p></div><p><span class="application">BibleTime</span> uses the Lucene search engine to perform your
	  searches. It has many advanced features, and you can read more
	  about it here: 
	  <a class="ulink" href="http://lucene.apache.org/java/docs/index.html" target="_top">
	  http://lucene.apache.org/java/docs/index.html</a>.</p></div></div><div class="sect2" title="Search results"><div class="titlepage"><div><div><h3 class="title"><a name="hdbk-op-search-results"></a>Search results</h3></div></div></div><p>Here you can see how many instances of the search string
      were found, sorted by works. Clicking on a work with the 
      <span class="mousebutton">right</span> mouse button allows you to copy,
      save, or print all verses that were found in a certain work at
      once. This also works when you click on one or more of the
      references to copy, save or print them. Clicking on a particular
      reference opens that verse up in context in the preview window
      below.</p><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>Drag a reference and drop it on a work symbol on the
        Bookshelf to open the work at that verse in a new read
        window.</p></div><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>Drag a reference and drop it on an open read window, and
        it will jump to that verse.</p></div><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>Select references and drag them to the Bookshelf to
        create bookmarks.</p></div><div class="sect3" title="Search result analysis"><div class="titlepage"><div><div><h4 class="title"><a name="hdbk-op-search-analysis"></a>Search result analysis</h4></div></div></div><p>Click on 
        <span class="guibutton">Search analysis</span> to open the search
        analysis display. This gives a simple graphic analysis of the
        number of instances the search string was found in each book of
        the Bible, and you can also save the analysis.</p><div class="screenshot"><div class="mediaobject"><img src="ss_searchanal.png"></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="hdbk-op-parts.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="hdbk-op.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="hdbk-op-bookshelfmanager.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Parts of the <span class="application">BibleTime</span> application window�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�The 
    <span class="guimenuitem">Bookshelf Manager</span></td></tr></table></div></body></html>