<page id="xiphos-50-preferences-general-settings" type="topic" xmlns="http://projectmallard.org/1.0/"
       xmlns:its="http://www.w3.org/2005/11/its">

  <info>
    <desc>Locale, General Preferences and StudyPad directory.</desc>

    <link type="guide" xref="index#preferences"/>

    <revision pkgversion="4.1.0" date="2018-04-24" status="draft"/>
    <revision pkgversion="4.1.0" date="2018-05-29" status="candidate"/>
    <revision pkgversion="4.5.0" date="2026-08-10" status="draft"/>

    <title type='link' role="trail"></title>
    <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 href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

  </info>

  <!-- General Settings -->

  <title>General Settings</title>

  <media style="image" mime="image/png"
  	 src="figures/preferences_general-misc.png" />

  <p>If you wish <app>Xiphos</app> to display its interface in a language
  other than the default, you may select one here.  A restart will be
  required, so that the locale can be initialized.</p>

  <p>If you enable <gui>Default Dictionary</gui>, then that named dictionary
  (chosen on the <gui>Special</gui> tab, see
  <link xref="xiphos-53-preferences-modules#xiphos-modules-special"/>) module
  will always be used when double-clicking a word anywhere in <app>Xiphos</app>.</p>

  <p>Certain dictionary-style modules are <gui>Daily Devotionals</gui> whose
  keys are numerically in the form "Month.Day".  If you have such a module
  installed and it has been selected as your preferred devotional (also on the
  <gui>Special</gui> tab), then you can ask that <app>Xiphos</app> display
  today's selection during startup, and it also populates the
  <link xref="xiphos-11-interface#xiphos-devotional">Devotional tab</link>.</p>

  <p>If you enable <gui>Resize images</gui>, <app>Xiphos</app> will
  automatically resize image content in commentaries, general books, and
  dictionaries so as to fit the subwindow which contains them.</p>

  <p><gui>Highlight current verse</gui>, if enabled, will cause <app>Xiphos
  </app> to substitute mere current verse colorization with a high-contrast
  alternate color scheme on the current verse.  The colors used may be chosen
  from the color selector pane (see below).</p>

  <p><gui>Highlight user annotations</gui> uses inverted highlight color
  choices when marking user-annotated verses.</p>

  <p>By default, <gui>Cross-references</gui> go into the Previewer.  Selecting
  this checkbox puts them into the verse list instead.</p>

  <p>Verse number display can be offset in several ways provided by the
  checkboxes.</p>

   <!-- TODO: confirm exact menu wording/label for the whole-book rendering
    toggle against source (added by commit 943842c4, #1350, fix #612). -->
    <section id="xiphos-bible-whole-book">
      <title>Viewing A Whole Book</title>
      <p>Normally the <gui>Bible Text Pane</gui> shows one chapter at a time.
      For continuous reading, or for searching visually through a book  enable
      <gui>Display Whole Bible books</gui>, which renders every chapter of the current
      book in the pane at once. Unselect the option again to return to normal chapter-at-a-time display.</p>
    </section>

</page>
