Add file for 1.6 branch.
[Evergreen-DocBook.git] / opac / searchtips.xml
diff --git a/opac/searchtips.xml b/opac/searchtips.xml
new file mode 100644 (file)
index 0000000..533a58f
--- /dev/null
@@ -0,0 +1,159 @@
+<?xml version='1.0' encoding='UTF-8'?>\r
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"\r
+           xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="catalogue-search-tips">\r
+       <title>Search Tips</title>\r
+        <para>You do not need to enter authors last name first, nor do you need an exact title or\r
+         subject heading. Evergreen is also forgiving about plurals and alternate verb endings, so\r
+         if you enter <emphasis>dogs</emphasis>, Evergreen will also find items with\r
+            <emphasis>dog</emphasis>.</para>\r
+       <itemizedlist>\r
+         <listitem>\r
+            <para>Do not use an AND operator to join search terms. </para>\r
+            <itemizedlist>\r
+               <listitem>\r
+                  <para>An AND operator is automatically used to join all search terms. So, a search<indexterm><primary>boolean</primary><secondary>AND operator</secondary></indexterm>\r
+                     for <emphasis>golden compass </emphasis>will search for entries that contain\r
+                     both <emphasis>golden </emphasis><emphasis role="bold">and\r
+                        </emphasis><emphasis>compass</emphasis>.</para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>o Boolean operators such as <emphasis>and, or, not </emphasis>are not\r
+                     considered special and are searched for like any other word. So, a search for\r
+                        <emphasis>golden and compass </emphasis>will not return the title\r
+                        <emphasis>golden compass</emphasis>. Putting it another way, there are no\r
+                        <emphasis>stop </emphasis>words that are automatically ignored by the search\r
+                     engine. So, a title search for <emphasis>the and or not </emphasis>of (and in\r
+                     any order) yields a list of titles with those words. </para><indexterm><primary>boolean</primary></indexterm>\r
+               </listitem>\r
+            </itemizedlist>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <itemizedlist>\r
+         <listitem>\r
+            <para>Don’t worry about white space, exact punctuation, or capitalization.</para>\r
+            <orderedlist inheritnum="ignore" continuation="restarts">\r
+               <listitem>\r
+                  <para>White spaces before or after a word are ignored. So, search for\r
+                        <emphasis>golden compass</emphasis> gives the same results as a search for\r
+                        <emphasis>golden compass</emphasis>.</para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>A double dash or a colon between words is reduced to a blank space. So, a\r
+                     title search for <emphasis>golden:compass </emphasis> or <emphasis>golden --\r
+                        compass </emphasis>is equivalent to <emphasis>golden\r
+                     compass</emphasis>.</para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>Punctuation marks occurring within a word are removed; the exception is _.\r
+                     So, a title search for <emphasis>gol_den com_pass </emphasis>gives no result.\r
+                  </para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>Diacritical marks, &amp;, or | located anywhere in the search term are\r
+                     removed. Words or letters linked together by . (dot) are joined together\r
+                     without the dot. So, a search for <emphasis>go|l|den &amp; comp.ass\r
+                     </emphasis>is equivalent to <emphasis>golden compass</emphasis>. </para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para> Upper and lower case letters are equivalent. So, <emphasis>Golden\r
+                        Compass</emphasis> is the same as <emphasis>golden\r
+                     compass</emphasis>.</para>\r
+               </listitem>\r
+            </orderedlist>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <itemizedlist>\r
+         <listitem>\r
+            <para>Enter your search words in any order. So, a search for <emphasis>compass\r
+                  golden</emphasis> gives the same results as a search for <emphasis>golden\r
+                  compass</emphasis>. Adding more search words gives fewer and more specific\r
+               results. </para>\r
+\r
+            <itemizedlist>\r
+               <listitem>\r
+                  <para>This is also true for author searches. Both <emphasis>David Suzuki\r
+                     </emphasis>and <emphasis>Suzuki, David</emphasis> will return results for the\r
+                     same author.</para>\r
+               </listitem>\r
+            </itemizedlist>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <itemizedlist>\r
+         <listitem>\r
+            <para>Use specific search terms. Evergreen will search for the words you specify, not\r
+               the meanings, so choose search terms that are likely to appear in an item\r
+               description. For example, the search <emphasis>luxury hotels </emphasis>will produce\r
+               more relevant results than <emphasis>nice places to stay</emphasis>.</para>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <itemizedlist>\r
+         <listitem>\r
+            <para>Search for an exact phrase using double-quotes. For example <emphasis>“golden\r
+                  compass”</emphasis>. </para>\r
+            <itemizedlist>\r
+               <listitem>\r
+                  <para>The order of words is important for an exact phrase search.\r
+                        <emphasis>“golden compass”</emphasis> is different than <emphasis>“compass\r
+                        golden”</emphasis>. </para>\r
+               </listitem>\r
+\r
+               <listitem>\r
+                  <para>White space, punctuation and capitalization are removed from exact phrases\r
+                     as described above. So a phrase retains its search terms and its relative\r
+                     order, but not special characters and not case. </para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>Two phrases are joined by and, so a search for <emphasis>“golden compass”\r
+                        “dark materials” </emphasis>is equivalent to <emphasis>“golden compass”\r
+                           <emphasis role="bold">and</emphasis> “dark materials”</emphasis>. </para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>To prevent <link linkend="catalogue-search-methodology-stemming"\r
+                        >stemming</link> , use double quotes around a single word or a phrase. So, a\r
+                     search for <emphasis>parenting</emphasis> will also return results for\r
+                        <emphasis>parental</emphasis> but a search for\r
+                        <emphasis>“parenting”</emphasis> will not. </para>\r
+               </listitem>\r
+            </itemizedlist>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <itemizedlist>\r
+         <listitem>\r
+            <para>Do not use wildcards. Truncation using wildcards is not supported in Evergreen.\r
+               So, searching for <emphasis>comp*</emphasis> will not return results for\r
+                  <emphasis>compass</emphasis>. </para>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <itemizedlist>\r
+         <listitem>\r
+            <para>Exclude a term from the search, using <emphasis>-</emphasis> (minus) or !\r
+               (exclamation point). For example, <emphasis>vacations –britain</emphasis> or\r
+                  <emphasis>vacations !britain</emphasis> will search for materials on vacations\r
+               that do not make reference to Britain. </para>\r
+            <itemizedlist>\r
+               <listitem>\r
+                  <para>Two excluded words are joined by <emphasis>and</emphasis>. So, a search for\r
+                        <emphasis>!harry !potter</emphasis> is equivalent to\r
+                        <emphasis>!harry</emphasis>\r
+                     <emphasis role="bold">and</emphasis>\r
+                     <emphasis>!potter</emphasis>. </para>\r
+               </listitem>\r
+               <listitem>\r
+                  <para>A + (plus) leading a term has no role and is removed. So,\r
+                        <emphasis>+golden</emphasis>\r
+                     <emphasis>+compass</emphasis> is equivalent to <emphasis>golden\r
+                        compass</emphasis>.</para>\r
+               </listitem>\r
+            </itemizedlist>\r
+         </listitem>\r
+      </itemizedlist>\r
+      <para>You can form more complex searches using the Advanced Search features.</para>\r
+      <simplesect xml:id="catalogue-search-tips-improving-a-search-with-few-results">\r
+         <title>Improving a Search With Few Results</title>\r
+         <para>If few hits were returned for your search is displayed, you may see some suggestions\r
+            for expanding or altering your search at the bottom of the s earch results list. These\r
+            alternate search terms are words that are similar to your search terms in spelling or\r
+            sound. Selecting one of the links performs a search with the new search terms.</para>\r
+      </simplesect>\r
+</chapter>\r
+\r