<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="nl" lang="nl">
    <head>
        <title>Verrijkt Koninkrijk » Zoeken » Help</title>
        <link rel="stylesheet" href="search.css" type="text/css"/>
    </head>
    <body>
        <h1>Verrijkt Koninkrijk » Zoeken » Help</h1>
        <p>
            <em>
          This page provides help with the user interface. We also provide
          <a href="http://www.loedejongdigitaal.nl/doc/index.html">technical documentation</a>
          (in English).
        </em>
        </p>
        <p>
        Met de <a href=".">Zoekmachine</a> kan de volledige tekst van
        <em>Het Koninkrijk der Nederlanden in de Tweede Wereldoorlog</em>
        van dr. Loe de Jong doorzocht worden op trefwoorden.
      </p>
        <a name="queries"/>
        <h2>Zoekopdrachten</h2>
        <p>
        In het vak "zoekopdracht" kunnen trefwoorden opgegeven worden.
        De meest basale zoekopdracht bestaat uit één woord.
      </p>
        <p>
        Er zijn diverse mogelijkheden om op meerdere woorden te zoeken.
        Een simpele spatie tussen twee woorden geeft een "OR"-zoekopdracht,
        bijv. <code>onderduik verzet</code> zoekt op beide trefwoorden
        en geeft alle documenten terug waarin minstens een van beide voorkomt
        (<a href="./?q=onderduik+verzet">voorbeeld</a>).
        Moeten beide woorden voorkomen in elk resultaat, gebruik dan het woord
        <code>AND</code>, dus <code>
                <a href="./?q=onderduik+AND+verzet">onderduik AND verzet</a>
            </code>
        Dit betekent dat beide termen samen in een paragraaf of alinea moeten voorkomen
        (afhankelijk van de optie Fijnmazigheid).
        Het aantal treffers van de tweede zoekopdracht zal gewoonlijk lager zijn
        dan die van de eerste.
      </p>
        <p>
        Gebruik aanhalingstekens om op een frase van meerdere woorden te zoeken:
        <code>
                <a href="./?q=&#34;gewone+mensen&#34;">"gewone mensen"</a>
            </code>
        vindt alle voorkomens van <em>gewone</em>, direct gevolgd door <em>mensen</em>.
      </p>
        <p>
        Zoeken op varianten gebeurt met een sterretje:
        <code>
                <a href="./?q=fascis*">fascis*</a>
            </code> vindt <em>fascisme</em>, <em>fascistisch</em>, enz.
      </p>
        <p>
        De volledige toegestane syntaxis voor uitgebreide zoekopdrachten
        staat beschreven in de documentatie van het zoekmachinepakket
        <a href="http://lucene.apache.org/core/old_versioned_docs/versions/2_9_1/queryparsersyntax.html">Lucene</a>.
      </p>
        <a name="granularity"/>
        <div style="float: right;">
            <img src="facets.png" border="1px" width="400px" style="margin: 10px;" alt="Screenshot" title="Facets"/>
        </div>
        <h2>Fijnmazigheid, Ook zoeken in, facets</h2>
        <p>
            <em>Het Koninkrijk</em> is verdeeld in 29 boekdelen,
        die bestaan uit hoofdstukken, paragrafen en uiteindelijk alinea's.
        Met de optie Fijnmazigheid kan het niveau van zoeken langs deze as
        bepaald worden.
        Standaard wordt alleen gezocht in de lopende tekst van de "hoofddelen"
        van De Jongs werk.
        De optie "ook zoeken in" voegt hieraan desgewenst appendices,
        De Jongs verantwoording en de correcties (errata) toe.
      </p>
        <p>
        Het zoeken in specifieke boeken en hoofdstukken is mogelijk
        door ná een zoekopdracht te hebben gegeven, deze te verfijnen
        met behulp van de <em>faceted search interface</em>
        (zie afbeelding hiernaast, waarin met een <em>phrase query</em>
        een beruchte frase wordt gezocht).
        Door op "Hele collectie" te klikken wordt de zoekopdracht weer
        op alle boekdelen uitgevoerd.
      </p>
        <a name="sorting"/>
        <h2>Volgorde</h2>
        <p>
        Resultaten kunnen op twee manieren geordend worden.
        <ul>
                <li>
                    <strong>Boekvolgorde</strong>, d.i. de volgorde waarin passages
            in het oorspronkelijke werk stonden, of
          </li>
                <li>
                    <strong>relevantie</strong>, zoals automatisch bepaald door de
            <a href="http://lucene.apache.org/core/old_versioned_docs/versions/2_9_1/api/core/org/apache/lucene/search/Similarity.html">scoreformule van Lucene</a>.
          </li>
            </ul>
        N.B.: bij het zoeken op meer dan één term tegelijk zonder <code>AND</code>
        is relevantie sterk aangeraden als sorteercriterium,
        aangezien het de passages met meer dan één overeenkomst met de zoektermen
        bovenaan zal zetten
        (bijv. een passage met zowel <em>onderduik</em> als <em>verzet</em>
        zal meer relevant worden geacht dan één waarin een van beide termen voorkomt).
      </p>
        <h2>Uitvoer</h2>
        <p>
        Uitvoer is mogelijk in vier verschillende <em>formats</em>:
        reguliere HTML voor dagelijks gebruik, en tabellen in drie mogelijke bestandsindelingen.
        CSV is geschikt voor verdere verwerking in bijv. Excel of SPSS.
        HTML-tabellen zijn geschikt om in één keer een overzicht van alle treffers van een zoekopdracht te zien.
        Het bouwen en (in de browser) laden van dergelijke tabellen kan langzaam zijn.
      </p>
    </body>
</html>