<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" id="xiphos-31-advanced-search" type="topic" xml:lang="it">

  <info>
    <desc>Per ricerche complesse nella finestra Ricerca avanzata.</desc>

    <link type="guide" xref="index#search-function"/>

    <revision pkgversion="4.1.0" date="2018-04-24" status="draft"/>
    <revision pkgversion="4.1.0" date="2018-05-28" status="candidate"/>

    <title type="link" role="trail"/>
    <title type="text">Xiphos</title>

    <credit type="author" its:translate="no">
      <name>Andy Piper</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Pierre Benz</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Dr Peter von Kaehne</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Karl Kleinpaste</name>
    </credit>
    <credit type="author" its:translate="no">
      <name>Matthew Talbert</name>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

  </info>

  <!-- xiphos-advanced-search -->

  <title>Ricerche avanzate</title>

  <p>Ricerche più complesse potrebbero richiedere l'uso delle funzioni di ricerca avanzata, che si trovano in <guiseq><gui>Modifica</gui><gui>Ricerca avanzata</gui></guiseq>.</p>

  <media style="image" mime="image/png" src="figures/search_search.png"/>

  <p>In <gui>Ricerca avanzata</gui> è possibile costruire query molto più complesse, che comprendono intervalli di ricerca personalizzati, elenchi personalizzati di moduli su cui effettuare la ricerca, corrispondenza con espressioni regolari (vedere la sezione successiva) e ricerche basate su attributi, come quelle che si trovano nelle note a piè di pagina o nei dizionari ebraici e greci di Strong.</p>

  <p>La ricerca predefinita utilizza la ricerca veloce “lucene”. Si tratta di una ricerca ottimizzata che richiede un indice precostituito; si veda la pagina di manutenzione del <gui>Gestore di moduli</gui> per la creazione dell'indice. In assenza di un indice, si ricorrerà alla più lenta ricerca semplice di più parole, che può essere selezionata deliberatamente qui. Una ricerca sul web fornirà diversi riferimenti alla sintassi necessaria per utilizzare la potenza della ricerca ottimizzata di Lucene. Seguono alcuni esempi:</p>

  <p>Ricerche semplici: basta digitare le parole che si desidera cercare. Per trovare solo i versetti che includono tutte le parole, anteporre alla parola il prefisso “+”. Così, nella KJV, si può trovare il Salmo 23 cercando “+Signore +pastore +voglia”. Per cercare un'intera frase, circondare l'intera frase con le virgolette, come “mi fa sdraiare” (notare che le virgolette non sono necessarie in tutti gli altri esempi).</p>

  <p>Single Letter Wildcard: to search for "veil" or "vail", use this syntax
  "v?il". The "?" represents a single character	that could be anything. A more
  complex example returns both spellings for Isaiah used in the KJV. "?saia?"
  will return results for "Isaiah" and "Esaias".</p>

  <p>Multiple Letter Wildcard: to search for "prophet" or "prophesy" or
  "prophecy" or "prophesied", use this syntax "prophe*".</p>

  <p>AND syntax: in the advanced search to return results for all of the search
  terms, you must put "AND" in between the terms. To continue our example, if we
  wish to search for any occurrence of Isaiah or Esaias that also mention either
  prophet, or prophecy, or prophesy, we can do a search like this: "?saia? AND
  prophe*".</p>

  <p>By default, two standard search ranges are defined, for Old and New
  Testament; you may wish to define others for e.g. "Gospels" or "Paul's
  Epistles". One custom module list containing only the first Bible found will
  be present. If desired, new searches can be performed across only the current
  results of the previous search.  Any modules may be searched, including
  general books and even dictionaries, in any combination.</p>

  <p>Note the tooltip in the screenshot above, for Attributes search. This
  qualifier is used to perform searches on attributes that are carried with
  verses, instead of verse content proper, such as footnote content or Strong's
  Hebrew and Greek references. If this button is selected, specific attribute
  qualifiers must be made in the Attribute Search tab, at the right end of the
  tab set. Strong's references are identified with a leading "H" or "G" and the
  numeric Strong's identifier. Thus, a search of KJV for Strong's Greek #140,
  using "G140", will return the single result of Matthew 12:18.</p>

  <p>If you have indexed your modules, there is a much faster way to search for
  Strong's references. Enter your search preceded by "lemma:", so to search for
  Strong's Greek #140, enter "lemma:G140". You must have selected <gui>Optimized
  ("Lucene")</gui> for this to work.</p>

  <p>Explanations of search syntax are available when either Optimized or
  Attribute search is selected.</p>

  <p>The "Find" button also stops an in-progress search, as its tooltip
  indicates.</p>

  <p>Results will show in the <gui>Results</gui> tab. If you wish to show
  Strongs, Morphology, or Footnote tags, make those selections on the
  <gui>Attributes Search</gui> tab. Clicking once on the result will show the
  result in the <gui>Advanced Search</gui> previewer. Hovering over Strongs,
  Morphology, Footnote, or Cross-reference tags will show the results in the
  main previewer. Double-clicking a result will cause the current tab to
  navigate to that result. This applies to search results in general books and
  commentaries as well, but note that the respective tab must be visible.</p>

  <note style="warning">
    <p>Changes to some of the settings (e.g. scope of search, searched modules,
    etc.) in Advanced Search will affect the simple search via the side pane but
    not vice versa.</p>
  </note>

</page>
