← Back to branch summary

~ubuntu-branches/ubuntu/raring/xiphos/raring

« back to all changes in this revision

Viewing changes to help/fa/xiphos.xml

  • Committer: Bazaar Package Importer
  • Author(s): Dmitrijs Ledkovs, Jonathan Marsden, Dmitrijs Ledkovs
  • Date: 2010-11-25 21:26:48 UTC
  • mfrom: (2.1.1 experimental)
  • Revision ID: james.westby@ubuntu.com-20101125212648-mc64wvs0nw3xp7bx
Tags: 3.1.4-1
[ Jonathan Marsden ]
* New upstream release 3.1.4
* Removed debian/patch/* since the one patch was included upstream.
* Bumped Standards-Version to 3.9.1 (no changes required).
* debian/README.Debian: Corrected spelling and reworded for clarity.
* debian/control: Add Jonathan Marsden back into Uploaders.

[ Dmitrijs Ledkovs ]
* Added local options dpkg-source to unapply patches and fail on
  upstream source changes (ignoring false positives).
* Added bzr-builddeb hook to generate source-format before build. If you
  are not using bzr-builddeb, you must run "./debian/rules clean" before
  building.
* patches/xul-2.0.patch: bump UPPER_RANGE to allow running against xul20.

Show diffs side-by-side

added added

removed removed

Lines of Context:
help/fa/xiphos.xml
1
 
<?xml version="1.0" encoding="utf-8"?>
2
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3
 
<!ENTITY introduction SYSTEM "introduction.xml">
4
 
<!ENTITY start SYSTEM "start.xml">
5
 
<!ENTITY interface SYSTEM "interface.xml">
6
 
<!ENTITY preferences SYSTEM "preferences.xml">
7
 
<!ENTITY modules SYSTEM "modules.xml">
8
 
<!ENTITY search SYSTEM "search.xml">
9
 
<!ENTITY studypad SYSTEM "studypad.xml">
10
 
<!ENTITY personal SYSTEM "personal.xml">
11
 
<!ENTITY journals SYSTEM "journals.xml">
12
 
<!ENTITY legal SYSTEM "legal.xml">
13
 
<!ENTITY onlinehelp SYSTEM "onlinehelp.xml">
14
 
<!ENTITY originallanguage SYSTEM "originallanguage.xml">
15
 
<!ENTITY appversion "3.1.3">
16
 
<!ENTITY manrevision "3.1.3">
17
 
<!ENTITY date "11 May 2009">
18
 
<!ENTITY app "<application>Xiphos</application>">
19
 
<!ENTITY appname "Xiphos">
20
 
<!ENTITY xiphos "the Xiphos Team">
21
 
<!-- Information about the entities
22
 
       The legal.xml file contains legal information, there is no need to edit the file.
23
 
       Use the appversion entity to specify the version of the application.
24
 
       Use the manrevision entity to specify the revision number of this manual.
25
 
       Use the date entity to specify the release date of this manual.
26
 
       Use the app entity to specify the name of the application. -->]>
27
 
<!--
28
 
This is a GNOME documentation template, designed by the GNOME
29
 
Documentation Project Team. Please use it for writing GNOME
30
 
documentation, making obvious changes. In particular, all the words
31
 
written in UPPERCASE (with the exception of GNOME) should be
32
 
replaced. As for "legalnotice", please leave the reference
33
 
unchanged.
34
 
 
35
 
Remember that this is a guide, rather than a perfect model to follow
36
 
slavishly. Make your manual logical and readable.  And don't forget
37
 
to remove these comments in your final documentation!  ;-)
38
 
-->
39
 
<!--
40
 
    (Do not remove this comment block.)
41
 
Maintained by the GNOME Documentation Project
42
 
http://developer.gnome.org/projects/gdp
43
 
Template version: 2.0 beta
44
 
Template last modified Apr 11, 2002
45
 
-->
46
 
<!-- =============Document Header ============================= -->
47
 
<article id="index" lang="fa">
48
 
<!-- please do not change the id; for translations, change lang to -->
49
 
<!-- appropriate code -->
50
 
  <articleinfo>
51
 
    <title><application>Xiphos</application> راهنما</title>
52
 
    <abstract role="description">
53
 
      <para>زیفوس برنامه‏ای است که به منظور کمک رسانی در مطالعۀ کتاب‏مقدس تهیه شده است.</para>
54
 
    </abstract>
55
 
    <copyright>
56
 
      <year>2003</year>
57
 
      <year>2009</year>
58
 
      <holder>تیم زیفوس</holder>
59
 
    </copyright>
60
 
 
61
 
    <!-- translators: uncomment this:
62
 
 
63
 
    <copyright>
64
 
      <year>2006</year>
65
 
      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
66
 
    </copyright>
67
 
 
68
 
    -->
69
 
    <!-- An address can be added to the publisher information.  If a role is
70
 
    not specified, the publisher/author is the same for all versions of the
71
 
    document.  -->
72
 
    <publisher role="maintainer">
73
 
      <publishername>تیم زیفوس</publishername>
74
 
    </publisher>
75
 
 
76
 
     <legalnotice>
77
 
       <title>پیشنهادات و نظرات شما</title>
78
 
        <para>
79
 
        For more information on <application>Xiphos</application>, please visit
80
 
        the project website at <ulink type="http" url="http://xiphos.org">http://xiphos.org</ulink>.
81
 
        </para>
82
 
 
83
 
         <para>To report a bug or make a suggestion regarding the Xiphos
84
 
           application or this manual, Use
85
 
           the <ulink url="http://sourceforge.net/tracker/?group_id=5528">
86
 
           Tracker on SourceForge</ulink> or the mailing
87
 
           lists <email>gnomesword-developers@lists.sourceforge.net</email>
88
 
         </para>
89
 
    </legalnotice>
90
 
    
91
 
       <legalnotice id="legalnotice">
92
 
         <para>
93
 
           Permission is granted to copy, distribute and/or modify this
94
 
           document under the terms of the GNU General Public License
95
 
           (GPL), Version 2 or any later version published
96
 
           by the Free Software Foundation. You can find
97
 
           a copy of the GPL at this <ulink type="help" url="ghelp:gpl">link</ulink> or in the file COPYING
98
 
           distributed with this manual.
99
 
          </para>
100
 
 
101
 
         <para>
102
 
           DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
103
 
           UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
104
 
           WITH THE FURTHER UNDERSTANDING THAT:
105
 
 
106
 
           <orderedlist>
107
 
                 <listitem>
108
 
                   <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
109
 
                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
110
 
                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
111
 
                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
112
 
                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
113
 
                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
114
 
                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
115
 
                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
116
 
                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
117
 
                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
118
 
                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
119
 
                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
120
 
                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
121
 
                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
122
 
                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
123
 
                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
124
 
                     EXCEPT UNDER THIS DISCLAIMER; AND
125
 
                   </para>
126
 
                 </listitem>
127
 
                 <listitem>
128
 
                   <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
129
 
                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
130
 
                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
131
 
                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
132
 
                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
133
 
                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
134
 
                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
135
 
                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
136
 
                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
137
 
                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
138
 
                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
139
 
                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
140
 
                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
141
 
                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
142
 
                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
143
 
                        THE POSSIBILITY OF SUCH DAMAGES.
144
 
                   </para>
145
 
                 </listitem>
146
 
           </orderedlist>
147
 
         </para>
148
 
   </legalnotice>
149
 
 
150
 
    <!-- This file  contains link to license for the documentation (GNU FDL), and
151
 
    other legal stuff such as "NO WARRANTY" statement. Please do not change
152
 
    any of this. -->
153
 
 
154
 
    <authorgroup>
155
 
      <author>
156
 
        <firstname>اندی</firstname>
157
 
        <surname>پایپر</surname>
158
 
      </author>
159
 
      <author>
160
 
        <firstname>پیر</firstname>
161
 
        <surname>بنز</surname>
162
 
      </author>
163
 
      <author>
164
 
        <firstname>دکتر پیتر</firstname>
165
 
        <surname>فن کاهن</surname>
166
 
      </author>
167
 
      <author>
168
 
        <firstname>کارل</firstname>
169
 
        <surname>کلاین‏پیست</surname>
170
 
      </author>
171
 
      <author>
172
 
        <firstname>متیو</firstname>
173
 
        <surname>تالبرت</surname>
174
 
      </author>
175
 
      <othercredit role="translator">
176
 
        <firstname>Dominique</firstname>
177
 
        <surname>Corbex</surname>
178
 
        <affiliation>
179
 
          <orgname>Xiphos Development team</orgname>
180
 
        </affiliation>
181
 
        <contrib>French translation</contrib>
182
 
      </othercredit>
183
 
 
184
 
 
185
 
      <!-- This is appropriate place for other contributors: translators,
186
 
      maintainers,  etc. Commented out by default.
187
 
 
188
 
      <othercredit role="translator">
189
 
        <firstname>Latin</firstname>
190
 
        <surname>Translator 1</surname>
191
 
        <affiliation>
192
 
          <orgname>Latin Translation Team</orgname>
193
 
          <address> <email>translator@gnome.org</email> </address>
194
 
        </affiliation>
195
 
        <contrib>Latin translation</contrib>
196
 
      </othercredit>
197
 
      -->
198
 
    </authorgroup>
199
 
 
200
 
 
201
 
    <!-- According to GNU FDL, revision history is mandatory if you are -->
202
 
    <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
203
 
    <!-- Remember to remove the &manrevision; entity from the revision entries other
204
 
    -->
205
 
    <!-- than the current revision. -->
206
 
    <!-- The revision numbering system for GNOME manuals is as follows: -->
207
 
    <!-- * the revision number consists of two components -->
208
 
    <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
209
 
    <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
210
 
    <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
211
 
    <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
212
 
    <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
213
 
    <!-- to V3.0, and so on. -->
214
 
 
215
 
    <releaseinfo>This manual describes version 3.1.3 of Xiphos.
216
 
    </releaseinfo>
217
 
     <revhistory> 
218
 
        <revision> 
219
 
          <revnumber>Xiphos Manual V3.1.3</revnumber> 
220
 
          <date>August 2009</date> 
221
 
          <revdescription> 
222
 
             <para role="author">تیم زیفوس</para>
223
 
             <para role="publisher">تیم زیفوس</para>
224
 
          </revdescription> 
225
 
        </revision>
226
 
     </revhistory> 
227
 
 
228
 
    <keywordset>
229
 
      <keyword>گنوم</keyword>
230
 
      <keyword>زیفوس</keyword>
231
 
      <keyword>سورد</keyword>
232
 
      <keyword>کراس وایر</keyword>
233
 
      <keyword>هلپ دایالوگ</keyword>
234
 
    </keywordset>
235
 
 
236
 
  </articleinfo>
237
 
 
238
 
  <indexterm zone="index">
239
 
    <primary>زیفوس</primary>
240
 
  </indexterm>
241
 
 
242
 
 
243
 
  <!-- ============= Document Body ============================= -->
244
 
 
245
 
  <!-- Please note: the headers of the included files (introduction.xml,
246
 
  start.xml and so on) must be into this main help file. If they are not,
247
 
  the table of contents is not displayed by yelp.
248
 
  -->
249
 
 
250
 
  <!-- ============= Introduction ============================== -->
251
 
  <!-- Use the Introduction section to give a brief overview of what
252
 
  the application is and what it does. -->
253
 
  <sect1 id="xiphos-introduction">
254
 
    <title>مقدمه</title>
255
 
    <!-- ============= Introduction ============================== -->
256
 
<!-- Use the Introduction section to give a brief overview of what
257
 
     the application is and what it does. -->
258
 
 
259
 
    <para><application>زیفوس</application> ابزاری برای مطالعۀ کتاب‏مقدّس است که بر پایۀ "SWORD Project" کتابخانه‏های جی‏ان‏او‏ام‏ای بنا شده است. برنامۀ <application>زیفوس</application> را می‏توانید برای موارد زیر بکار ببرید:</para>
260
 
    <itemizedlist>
261
 
       <listitem>
262
 
          <para>مشاهدۀ آیات مورد علاقه</para>
263
 
       </listitem>
264
 
       <listitem>
265
 
          <para>یادداشتهای موعظه و یادداشتهای شخصی خود را در مورد آیات مورد نظر می‏توانید تایپ کنید</para>
266
 
       </listitem>
267
 
       <listitem>
268
 
           <para>بصورت اتوماتیک پانویس‏های کتاب‏مقدس و سایر کتب مرجع را دنبال کنید </para>
269
 
       </listitem>
270
 
       <listitem>
271
 
           <para>ترجمه‏های گوناگون را بصورت موازی مقایسه کنید</para>
272
 
       </listitem>
273
 
       <listitem>
274
 
           <para>با بهره برداری از متون عبری و یونانی روی زبان‏های اصلی کتاب‏مقدس کارهای مطالعاتی و تحقیقاتی انجام دهید</para>
275
 
        </listitem>
276
 
      </itemizedlist>
277
 
      <para><application>زیفوس</application> این را هدف خود قرار داده است که یک محیط کاری ساده در اختیار کاربران قرار دهد، در عین حال با در اختیار قرار دادن ابزاری بسیار قوی به کاربر اجازه دهد که کارهای مطالعاتی-تحقیقاتی خود را بر روی کتاب‏مقدّس انجام دهد.</para>
278
 
 
279
 
      <!-- ==== Figure ==== -->
280
 
      <figure id="sword-logo">
281
 
      <title>علامت انحصاری پروژۀ شمشیر</title>  
282
 
      <screenshot>
283
 
        <mediaobject> 
284
 
            <imageobject>
285
 
              <imagedata fileref="figures/sword3.png" format="PNG"/>
286
 
            </imageobject>
287
 
            <!-- EPS versions of the figures are not required at the moment. -->
288
 
            <!-- 
289
 
                    <imageobject>
290
 
                <imagedata fileref="figures/sword3.eps" format="EPS"/>
291
 
                    </imageobject>
292
 
            -->
293
 
            <textobject> 
294
 
              <phrase>علامت انحصاری پروژۀ شمشیر</phrase> 
295
 
            </textobject> 
296
 
        </mediaobject> 
297
 
      </screenshot>
298
 
      </figure>
299
 
 
300
 
      <para>"پروژۀ شمشیر" بر مبنای <ulink type="http" url="http://www.crosswire.org">http://www.crosswire.org</ulink> است. سایر برنامه‏هایی که تحت همان علامت هستند، شامل <application>پروژۀ شمشیر برای ویندوز</application> (aka <application>BibleCS</application> or <application>WinSword</application>), <application>مک‏سورد</application> برای کامپیوترهای مک‏اینتاش, <application>بایبل دسکتاپ</application>, که یک برنامۀ جاوا است, و <application>بایبل تایم</application>, که یک برنامۀ دیگر قابل اجرا تحت لینوکس است، می‏باشند.</para>
301
 
 
302
 
      <para>
303
 
      <figure id="main-screenshot">
304
 
      <title>زیفوس در حال اجرا می‏باشد</title>
305
 
      <screenshot> 
306
 
          <mediaobject> 
307
 
            <imageobject><imagedata fileref="figures/interface.png" format="PNG"/> 
308
 
            </imageobject>
309
 
            <!-- EPS versions of the figures are not required at the moment. -->
310
 
            <!-- 
311
 
                    <imageobject>
312
 
                <imagedata fileref="figures/interface.eps" format="EPS"/>
313
 
                    </imageobject>
314
 
            -->
315
 
            <textobject> 
316
 
              <phrase>زیفوس در حال اجرا می‏باشد</phrase> 
317
 
            </textobject> 
318
 
          </mediaobject> 
319
 
         </screenshot>
320
 
       </figure>
321
 
       </para>
322
 
 
323
 
       <!-- Where important notices are kept regarding Xiphos  -->
324
 
       <warning>
325
 
         <para><application>زیفوس</application> در حال حاضر تحت گسترش است، به همین دلیل ممکن است در بخشی از برنامه مشکلاتی به چشمتان بخورد، که در اینصورت لطفاً آن مورد را از لینک زیر به ما اطلاع دهید <ulink type="http" url="http://sourceforge.net/projects/xiphos"> وب‏سایت پروژه</ulink>، یا ایمیل <email>xiphos-developers@lists.sourceforge.net</email>. از هرگونه راهنمایی و کمک شما پیشاپیش سپاسگزاریم</para>
326
 
       </warning>
327
 
 
328
 
 
329
 
  </sect1>
330
 
 
331
 
  <!-- =========== Getting Started ============================== -->
332
 
  <!-- Use the Getting Started section to describe the steps required
333
 
  to start the application and to describe the user interface components
334
 
  of the application. If there is other information that it is important
335
 
  for readers to know before they start using the application, you should
336
 
  also include this information here.
337
 
  If the information about how to get started is very short, you can
338
 
  include it in the Introduction and omit this section. -->
339
 
  <sect1 id="familiar">
340
 
    <title>شروع به استفاده از زیفوس</title>
341
 
    
342
 
<!-- ============= Getting Started with Xiphos  ============-->
343
 
        <sect2 id="xiphos-getting-started">
344
 
                <title>زیفوس در حال بارگذاری</title>
345
 
                        <para>شما می‏توانید برنامۀ <application>زیفوس</application> را به یکی از روش‏های زیر اجرا نمایید:</para>
346
 
                        <variablelist>
347
 
                                <varlistentry>
348
 
                                        <term>فهرست برنامه‏ها</term>
349
 
                                        <listitem>
350
 
                                                <para>گزینۀ  <menuchoice><guisubmenu>لوازم را برگزینید</guisubmenu><guimenuitem> و سپس به راهنمای زیفوس کتاب‏مقدس بروید</guimenuitem></menuchoice>.</para>
351
 
                                </listitem>
352
 
                        </varlistentry>
353
 
                        <varlistentry>
354
 
                                <term>خط فرمان</term>
355
 
                                <listitem>
356
 
                                        <para>عبارت <command>زیفوس</command>,  را وارد نموده، سپس کلید <keycap>اینتر</keycap>را بزنید.</para>
357
 
                                </listitem>
358
 
                        </varlistentry>
359
 
                        <varlistentry>
360
 
                                <term>پنجره‏ها</term>
361
 
                                <listitem>
362
 
                                        <para>گزینۀ <menuchoice><guisubmenu>تمام برنامه‏ها</guisubmenu><guisubmenu>زیفوس </guisubmenu><guimenuitem>زیفوس</guimenuitem></menuchoice>را برگزیند.</para>
363
 
                                </listitem>
364
 
                        </varlistentry>
365
 
 
366
 
                        </variablelist>
367
 
    </sect2>
368
 
<!--Starting Xiphos for the First Time  -->
369
 
        <sect2 id="xiphos-first-start">
370
 
                <title>شروع برنامۀ زیفوس برای اولین مرتبه</title>
371
 
                <para>هنگامی که<application>برنامۀ زیفوس</application> را برای اولین مرتبه باز می‏کنید،<application>زیفوس</application> یک‏سری گزینه‏های قراردادی ایجاد می‏کند. همچنین، چنانچه در گذشته برنامۀ دیگری از سری سورد اجرا شده باشد، ولی با این وجود هیچ مدول کتاب‏مقدس نصب نشده باشد، در آنصورت <application>زیفوس</application> از شما اجازه خواهد خواست تا برنامۀ مدیر مدول را اجرا نماید که به کمک آن شما می‏توانید یک مدول کتاب‏مقدس را به زبانی که بیشتر آنرا ترجیح می‏دهید، نصب کنید.</para>
372
 
                <figure id="xiphos-start-question">
373
 
                        <title>پرسش‏های مرتبط با دانلود کردن زیفوس</title>
374
 
                        <screenshot> 
375
 
          <mediaobject> 
376
 
            <imageobject><imagedata fileref="figures/first_start.png" format="PNG"/> 
377
 
            </imageobject>
378
 
            <!-- EPS versions of the figures are not required at the moment. -->
379
 
            <!-- 
380
 
                    <imageobject>
381
 
                <imagedata fileref="figures/first_start.eps" format="EPS"/>
382
 
                    </imageobject>
383
 
            -->
384
 
            <textobject> 
385
 
              <phrase>پرسش‏های مرتبط با دانلود کردن زیفوس</phrase> 
386
 
            </textobject> 
387
 
          </mediaobject> 
388
 
        
389
 
                        </screenshot>
390
 
 
391
 
                </figure>
392
 
                <para><application>زیفوس</application> در ابتدای اجرای آن یک محیط کاری دارای یک برگه باز می‏کند، که در آن آیۀ رومیان 8: 28 به چشم می‏خورد. کاربر در این محیط کاری، می‏تواند در  بخش <menuchoice><guimenuitem>ویرایش</guimenuitem><guimenuitem>فرمان ترجیحات</guimenuitem></menuchoice> را برگزیند و بدینوسیله تغییرات دلخواه را در قسمت‏هایی که بصورت اتوماتیک ایجاد شده‏اند، بدهد.</para>
393
 
         </sect2>
394
 
<!-- Xiphos on first time use -->
395
 
         <sect2 id="xiphos-when-you-start">
396
 
         <title>بارگذاری زیفوس</title>
397
 
                <para>هر زمان که برنامۀ <application>زیفوس</application>را باز کنید، محیط کاری زیر را مشاهده خواهید کرد:</para>
398
 
                <figure id="xiphos-start-interface">
399
 
                        <title>محیط کاری زیفوس</title>
400
 
                        <screenshot> 
401
 
          <mediaobject> 
402
 
            <imageobject><imagedata fileref="figures/interface.png" format="PNG"/> 
403
 
            </imageobject>
404
 
            <!-- EPS versions of the figures are not required at the moment. -->
405
 
            <!-- 
406
 
                    <imageobject>
407
 
                <imagedata fileref="figures/interface.eps" format="EPS"/>
408
 
                    </imageobject>
409
 
            -->
410
 
            <textobject> 
411
 
              <phrase>محیط کاری زیفوس</phrase> 
412
 
            </textobject> 
413
 
          </mediaobject> 
414
 
        
415
 
                        </screenshot>
416
 
 
417
 
                </figure>
418
 
                <para>محیط کاری <application>زیفوس</application>دارای عناصر زیر می‏باشد.</para>
419
 
                <variablelist>
420
 
                        <varlistentry>
421
 
                                <term>خط فرمان</term>
422
 
                                <listitem>
423
 
                                        <para>خط فرمان دارای چند فرمان است که کاربرد<application>زیفوس</application>را گسترش می‏بخشد. این فرامین شامل محلی برای یادداشت‏های مطالعه و نیز توابع جستجوی پیشرفته می‏باشد. فرامی همچنین به شما کمک می‏کنند تا بتوانید استفاده از برنامۀ <application>زیفوس </application>را بسیار شخصی و به دلخواه خود بنمایید.</para>
424
 
                                </listitem>
425
 
                        </varlistentry>
426
 
                <varlistentry>
427
 
                                <term>ستون ابزار</term>
428
 
                                        <listitem>
429
 
                                                <para>ستون<interface>ابزار</interface>شامل کلیدهایی است که به شما کمک می‏کند تا به سرعت و سهولت بتوانید از کتاب‏مقدس استفاده نمایید.</para>
430
 
                                        </listitem>
431
 
                                </varlistentry>
432
 
                <varlistentry>
433
 
                                        <term>ستون جانبی</term>
434
 
                                        <listitem>
435
 
                                                <para>ستون<interface>جانبی</interface>دستیابی به چندین کاربرد اساسی را ممکن می‏سازذ. این ستون شامل تمام علائم و نیز لیست کتابهایی است که نصب کرده‏اید. این ابزار همچنین برای جستجوهای ساده نیز قابل استفاده است.</para>
436
 
                                </listitem>
437
 
                        </varlistentry>
438
 
                        <varlistentry>
439
 
                                <term>چارچوب متن کتاب‏مقدس</term>
440
 
                                <listitem>
441
 
                                        <para>چارچوب<interface>متن کتاب‏مقدس</interface>متن کتاب‏مقدسی را که باز دارید نشان می‏دهد.</para>
442
 
                            </listitem>
443
 
                         </varlistentry>
444
 
                        <varlistentry>
445
 
                                <term>پیش‏نگر</term>
446
 
                                <listitem>
447
 
                                        <para>فرمان <interface>پیش‏نگر</interface>گزینه‏های مدول متن کتاب‏مقدس را نشان می‏دهد. این شامل اعداد مرتبط با کشف‏الآیات استرانگ، پانویس‏ها و نیز علائم زبان‏شناسی می‏باشند. این فرمان در زیر چاچوب متن کتاب‏مقدس قرار دارد.</para>
448
 
                                </listitem>
449
 
                         </varlistentry>
450
 
                         <varlistentry>
451
 
                                <term>چارچوب تفاسیر</term>
452
 
                                <listitem>
453
 
                                        <para>فرمان<interface>چارچوب تفسیر</interface>کتابهای تفسیری را که در مرتبط با متن کتاب‏مقدس در حال استفاده است، نشان می‏دهد.</para>
454
 
                                </listitem>
455
 
                         </varlistentry>
456
 
                         <varlistentry>
457
 
                                <term>چارچوب کتاب</term>
458
 
                                <listitem>
459
 
                                        <para>فرمان <interface>چارچوب کتاب</interface>کتابهای عمومی را که از طریق سورد در اختیار کاربر قرار دارند، نشان می‏دهد. این شامل مدول‏هایی از قبیل کتابهایی چون: "قوانین کالوین", "ژوزفوس: سری کامل نوشتجات " و غیره. این چارچوب را می‏توان از طریق فرمان مشاهدۀ مرور کتاب که در زیر فرمان چارچوب تفسیر است مورد استفاده قرار داد.</para>
460
 
                                </listitem>
461
 
                         </varlistentry>
462
 
                         <varlistentry>
463
 
                                <term>چارچوب فرهنگ واژه‏ها/کتاب</term>
464
 
                                <listitem>
465
 
                                        <para>گزینه <interface>دیکشنری</interface> تعریف واژه های برگزیده شده را نشان می دهد در در بخش <interface>متن کتاب مقدس</interface>. نشان می دهد این گزینه پس از گزینه تفسیر قرار دارد.</para>
466
 
                                </listitem>
467
 
                     </varlistentry>
468
 
                         </variablelist>
469
 
                     <para>هنگامی که شما در محیط‏های کاری گوناگون روی ماوس رایت‏کلیک بکنید، یک صفحۀ جدید در آن محیط کاری باز خواهد شد، که به شما گزینه‏های بیشتری خواهد داد، شامل کنترل‏های صفحۀ نمایش و خدمات چاپ.</para>
470
 
        </sect2>
471
 
 
472
 
 
473
 
  </sect1>
474
 
 
475
 
  <!-- Interface -->
476
 
  <sect1 id="interface">
477
 
    <title>محیط کاری</title>
478
 
    <!-- ============= Interface ============================== -->
479
 
        
480
 
 <!-- ============= Menubar  ============-->
481
 
        <sect2 id="menubar">
482
 
                <title>خط فرمان</title>
483
 
                <para>در بخش بالایی برنامۀ<application>زیفوس</application>خط فرمان قرار دارد.تقریباً تمامی کاربردها توسط انتخاب منوی درست اجرا می‏شوند. این کابردها بسته به نوع کاری که انجام می‏دهند گروه‏بندی شده‏اند. بعنوان نمونه، گروه فرامین کاربردی مرتبط با فایل، زیر فرمان<guisubmenu>پرونده</guisubmenu>دسته‏بندی شده‏اند.</para>
484
 
                <figure id="menubar_figure">
485
 
                        <title>خط فرمان</title>
486
 
                        <screenshot> 
487
 
                          <mediaobject> 
488
 
                            <imageobject><imagedata fileref="figures/interface_menubar.png" format="PNG"/> 
489
 
                            </imageobject>
490
 
                        <!-- EPS versions of the figures are not required at the moment. -->
491
 
                        <!-- 
492
 
                    <imageobject>
493
 
                        <imagedata fileref="figures/interface_menubar.eps" format="EPS"/>
494
 
                    </imageobject>
495
 
                    -->
496
 
            <textobject> 
497
 
              <phrase>خط فرمان زیفوس</phrase> 
498
 
            </textobject> 
499
 
          </mediaobject> 
500
 
        
501
 
                        </screenshot>
502
 
                </figure>
503
 
        </sect2>
504
 
        
505
 
<!-- ============= Toolbars  ============-->
506
 
        <sect2 id="toolbars">
507
 
                <title>ستون‏فرمان</title>
508
 
                <para>The function of the Toolbar is to provide control over the Bible and Commentary Panes. Activation of the Toolbar option is done by moving the mouse cursor over the desired toolbar button and selecting it. A tooltip will appear if the mouse cursor is held stationary over a toolbar button, describing the function of the button.کاربرد ستون ابزار اینست که کنترل‏های مربویط به چارچوب‏های کتاب‏مقدس و تفسیر را فراهم نماید. با حرکت دادن نشانگر ماوس بر روی دکمۀ ابزار مورد نظرتان و انتخاب آن، این گزینه فعال خواهد شد. اگر نشانگر ماوس را برای چند لحظه بر روی ابزار نگاه دارید، یک راهنمای کوچک باز خواهد شد که کاربرد آن کلید را توضیح خواهد داد. </para>
509
 
                <figure id="toolbar_figure">
510
 
                        <title>ابزار</title>
511
 
                        <screenshot> 
512
 
          <mediaobject> 
513
 
            <imageobject>
514
 
                <imagedata fileref="figures/interface_toolbar.png" format="PNG"/> 
515
 
            </imageobject>
516
 
            <!-- EPS versions of the figures are not required at the moment. -->
517
 
            <!-- 
518
 
                    <imageobject>
519
 
                <imagedata fileref="figures/interface_toolbar.eps" format="EPS"/>
520
 
                    </imageobject>
521
 
            -->
522
 
            <textobject> 
523
 
              <phrase>ابزار</phrase> 
524
 
            </textobject> 
525
 
          </mediaobject> 
526
 
        </screenshot>
527
 
                </figure>       
528
 
                <para>گزینۀ <interface>ابزار</interface>شامل کاربردهای زیر است:</para>
529
 
                <itemizedlist>
530
 
                        <listitem>
531
 
                                <para>تاریخچه مرور انتخاب و لیست</para>
532
 
                        </listitem>
533
 
                        <listitem>
534
 
                                <para>انتخاب بخشی از کتاب‏مقدس</para>
535
 
                        </listitem>
536
 
                        <listitem>
537
 
                                <para>انتخاب فصلی از کتاب‏مقدس</para>
538
 
                        </listitem>
539
 
                        <listitem>
540
 
                                <para>انتخاب آیه‏ای از کتاب‏مقدس</para>
541
 
                        </listitem>
542
 
                        <listitem>
543
 
                                <para>خلاصۀ بخش بخصوصی از کتاب‏مقدس</para>
544
 
                        </listitem>
545
 
                </itemizedlist>
546
 
                
547
 
                <sect3>
548
 
                        <title>انتخاب کردن تاریخچۀ پیشین/پسین</title>
549
 
                        <para>حرکت بین قسمت برگزیده شدۀ فعلی و پیشین.</para>
550
 
                </sect3>
551
 
                        
552
 
                <sect3 id="xiphos-toolbar-book">
553
 
                        <title>انتخاب بخشی از کتاب‏مقدس</title>
554
 
                        <para>این فرمان یک کتاب از کتاب‏مقدس را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>نشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
555
 
                </sect3>
556
 
                        
557
 
                <sect3 id="xiphos-toolbar-chapter">
558
 
                        <title>انتخاب فصلی از کتاب‏مقدس</title>
559
 
                        <para>این فرمان فصلی از کتاب‏مقدس را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>نشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
560
 
                </sect3>
561
 
                        
562
 
                <sect3 id="xiphos-toolbar-verse">
563
 
                        <title>انتخاب آیه‏ای از کتاب‏مقدس</title>
564
 
                        <para>این فرمان یک آیه از کتاب‏مقدس را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>نشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
565
 
                </sect3>
566
 
                
567
 
                <sect3 id="xiphos-toolbar-summary">
568
 
                        <title>خلاصۀ بخش بخصوصی از کتاب‏مقدس</title>
569
 
                        <para>Allows manual editing of passages which are displayed in the <interface>Bible Text Pane</interface> and <interface>Commentary Pane</interface>. Changes take effect once Enter is typed.این فرمان، اجازه می‏دهد که شما قسمتهایی  را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>ویرایش کنید. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
570
 
                        <warning>
571
 
                                <para>لطفا اطمینان حاصل کنید که کتاب، فصل، و یا آیه‏ای که آنرا ویرایش کرده‏اید به درستی نامگذاری شده است، در غیر اینصورت اطلاعات اشتباه نمایش داده خواهد شد.</para>
572
 
                        </warning>
573
 
                </sect3>
574
 
        </sect2>
575
 
   
576
 
<!-- ============= Sidebar  ============-->  
577
 
        <sect2 id="xiphos-sidebar">
578
 
                <title>ابزار جانبی</title>
579
 
                <figure id="sidebar_figure">
580
 
                        <title>ستون جانبی</title>
581
 
                        <screenshot> 
582
 
          <mediaobject> 
583
 
            <imageobject>
584
 
                <imagedata fileref="figures/interface_sidepane.png" format="PNG"/> 
585
 
            </imageobject>
586
 
            <!-- EPS versions of the figures are not required at the moment. -->
587
 
            <!-- 
588
 
                    <imageobject>
589
 
                <imagedata fileref="figures/interface_sidepane.eps" format="EPS"/>
590
 
                    </imageobject>
591
 
            -->
592
 
            <textobject> 
593
 
              <phrase>ابزار جانبی</phrase> 
594
 
            </textobject> 
595
 
          </mediaobject> 
596
 
           </screenshot>
597
 
 
598
 
                </figure>
599
 
                <para>
600
 
                On the left hand side of <application>Xiphos</application> there is the Sidebar. Here the
601
 
                user can switch between the different Sword modules, view bookmarks, do simple searches and view verse lists.
602
 
                To switch between all Sidebar functions, buttons have been placed at the top of the Sidebar.
603
 
                </para>
604
 
                <figure id="shortcut_figure">
605
 
                        <title>میان‏بر به ابزار جانبی</title>
606
 
                        <screenshot> 
607
 
          <mediaobject> 
608
 
            <imageobject>
609
 
                <imagedata fileref="figures/interface_shortcut.png" format="PNG"/> 
610
 
            </imageobject>
611
 
            <!-- EPS versions of the figures are not required at the moment. -->
612
 
            <!-- 
613
 
                    <imageobject>
614
 
                <imagedata fileref="figures/interface_shortcut.eps" format="EPS"/>
615
 
                    </imageobject>
616
 
            -->
617
 
            <textobject> 
618
 
              <phrase>میان‏بر به ابزار جانبی</phrase> 
619
 
            </textobject> 
620
 
          </mediaobject> 
621
 
                        </screenshot>
622
 
                </figure>
623
 
        </sect2>
624
 
<!-- ============= Bible Text Pane  ============--> 
625
 
        <sect2 id="xiphos-bible">
626
 
                <title>چارچوب متن کتاب‏مقدس</title>
627
 
                <figure id="textpane_figure">
628
 
                        <title>چارچوب متن کتاب‏مقدس</title>
629
 
                        <screenshot> 
630
 
          <mediaobject> 
631
 
            <imageobject>
632
 
                <imagedata fileref="figures/interface_biblepane.png" format="PNG"/> 
633
 
            </imageobject>
634
 
            <!-- EPS versions of the figures are not required at the moment. -->
635
 
            <!-- 
636
 
                    <imageobject>
637
 
                <imagedata fileref="figures/interface_biblepane.eps" format="EPS"/>
638
 
                    </imageobject>
639
 
            -->
640
 
            <textobject> 
641
 
              <phrase>چارچوب متن کتاب‏مقدس</phrase> 
642
 
            </textobject> 
643
 
          </mediaobject> 
644
 
        
645
 
                        </screenshot>
646
 
                </figure>
647
 
                <para>در سمت راست ستون شورت‏کات‏ها، چارچوب متن کتاب‏مقدس قرار دارد. تمام ترجمه‏های گوناگونی که شما دارید در این قسمت نشان داده می‏شوند. هنگامی که برنامۀ <application>زیفوس</application>را باز می‏کنید، بصورت اتوماتیک یا کتاب‏مقدس استاندارد شما و یا آخرین کتاب‏مقدسی که باز کرده بودید، بر روی این صفحه باز خواهد شد. </para>
648
 
                
649
 
                <sect3 id="xiphos-bible-open">
650
 
                        <title>باز کردن ترجمۀ خاصی از کتاب‏مقدس</title>
651
 
                        <para>به منظور تعویض ترجمۀ فعلی کتاب‏مقدس به یکی دیگر از ترجمه‏ها:</para>
652
 
                        <itemizedlist>
653
 
                                <listitem>
654
 
                                        <para>بر روی <interface>چارچوب متن کتاب‏مقدس</interface>رایت‏کلیک کنید. از صفحۀ فهرستی که باز شد، گزینۀ <menuchoice><guimenuitem>پرونده</guimenuitem><guimenuitem>بازکردن مدول</guimenuitem></menuchoice>را برگزینید و سپس ترجمه‏ای را دوست دارید، استفاده کنید، باز نمایید.</para>
655
 
                                </listitem>
656
 
                                <listitem>
657
 
                                        <para>زیر عنوان<guibutton> مدول‏ها،</guibutton>در بخش <interface>ستون جانبی</interface>،گزینۀ<menuchoice><guimenuitem>متون کتابمقدس</guimenuitem><guimenuitem>،زبان مورد علاقه</guimenuitem></menuchoice>، و ترجمۀ خاصی را که دوست دارید، می‏توانید انتخاب کنید.</para>
658
 
                                </listitem>
659
 
                        </itemizedlist>
660
 
                </sect3>
661
 
                
662
 
                <sect3 id="xiphos-bible-parallel">
663
 
                        <title>استفاده از کاربرد موازی</title>
664
 
                        <para>
665
 
                        A nice function in <application>Xiphos</application> is the ability to view your specified bible text in five parallel
666
 
                        translations of your choice. The Parallel View mode can be accessed by selecting <guimenuitem>Parallel View</guimenuitem> just
667
 
                        below the <interface>Bible Text Pane</interface>, next to the <guimenuitem>Standard View</guimenuitem> tab. Please note that you
668
 
                        can only view one verse at a time. You can change the verse by selecting another verse, chapter, or book at the toolbar. Also note
669
 
                        that modules that are Old Testament or New Testament only (eg Westminster Leningrad Codex and Byzantine Majority Text ) will not be able
670
 
                        to display books, chapters, or verses that they don't have.  
671
 
                        </para>
672
 
                <figure id="parallel_figure">
673
 
                        <title>چارچوب متن کتاب‏مقدس- نگرش موازی</title>
674
 
                        <screenshot> 
675
 
          <mediaobject> 
676
 
            <imageobject><imagedata fileref="figures/interface_parallel.png" format="PNG"/>
677
 
            </imageobject>
678
 
            <!-- EPS versions of the figures are not required at the moment. -->
679
 
            <!-- 
680
 
                    <imageobject>
681
 
                <imagedata fileref="figures/interface_parallel.eps" format="EPS"/>
682
 
                    </imageobject>
683
 
            -->
684
 
            <textobject> 
685
 
              <phrase>چارچوب متن کتاب‏مقدس- نگرش موازی</phrase> 
686
 
            </textobject> 
687
 
          </mediaobject> 
688
 
        
689
 
                        </screenshot>
690
 
                </figure>
691
 
                        <para>
692
 
                        Additionally, a separate Parallel View window can be selected from the right click menu with <guimenuitem>Detach/Attach</guimenuitem>.
693
 
                        Your Bible pane will return to its normal single text view, and the new Parallel View window will show the complete
694
 
                        chapter, in all 5 translations.
695
 
                        </para>
696
 
                <figure id="parallel_figure_separate">
697
 
                        <title>نگرش موازی - پنجره‏ای دیگر</title>
698
 
                        <screenshot> 
699
 
          <mediaobject> 
700
 
            <imageobject><imagedata fileref="figures/interface_parallel-separate.png" format="PNG"/> 
701
 
            </imageobject>
702
 
            <!-- EPS versions of the figures are not required at the moment. -->
703
 
            <!-- 
704
 
                    <imageobject>
705
 
                <imagedata fileref="figures/interface_parallel-separate.eps" format="EPS"/>
706
 
                    </imageobject>
707
 
            -->
708
 
            <textobject> 
709
 
              <phrase>نگرش موازی - پنجره‏ای دیگر</phrase> 
710
 
            </textobject> 
711
 
          </mediaobject> 
712
 
        
713
 
                        </screenshot>
714
 
                </figure>
715
 
                </sect3>
716
 
                
717
 
                <sect3 id="xiphos-bible-open-separate">
718
 
                        <title>ترجمۀ دیگری از کتاب‏مقدس را باز می‏کند</title>
719
 
                        <para>به منظور مشاهدۀ یک ترجمۀ دیگری از کتاب‏مقدس از ترجمه‏های موجود در <application>محیط کاری</application>زیفوس:</para>
720
 
                        <itemizedlist>
721
 
                                <listitem>
722
 
                                        <para>
723
 
                                        Under the <guibutton>Modules</guibutton> option in the <interface>Sidebar</interface>,choose <menuchoice>
724
 
                                        <guimenuitem>Biblical Texts</guimenuitem><guimenuitem>language choice</guimenuitem></menuchoice>.
725
 
                                        Then right-click on a translation and choose the <guimenuitem>Open in dialog</guimenuitem>
726
 
                                        option.
727
 
                                        </para>
728
 
                                </listitem>
729
 
                        </itemizedlist>
730
 
                </sect3>
731
 
                
732
 
                <sect3 id="xiphos-bible-about">
733
 
                        <title>Finding Out About The Current Translation</title>
734
 
                        <para>
735
 
                        To find out about the Bible translation currently being displayed:
736
 
                        </para>
737
 
                        <itemizedlist>
738
 
                                <listitem>
739
 
                                        <para>
740
 
                                        right-click in the <interface>Bible Text pane</interface>. In the popup menu choose
741
 
                                        <guimenuitem>About </guimenuitem> module name.
742
 
                                        </para>
743
 
                                </listitem>
744
 
                                <listitem>
745
 
                                        <para>تحت <guibutton>مدول‏های</guibutton>موجود در<interface>ستون جانبی،</interface>گزینۀ<menuchoice><guimenuitem>متون کتاب‏مقدس</guimenuitem><guimenuitem>گزینۀ زبان‏ها</guimenuitem></menuchoice>را برگزینید. سپس روی یک ترجمه کلیک سمت راست ماوس را فشار دهید و در این قسمت گزینۀ<guimenuitem>در بارۀ</guimenuitem>را برگزینید.</para>
746
 
                                </listitem>
747
 
                        </itemizedlist>
748
 
                </sect3>
749
 
                
750
 
                <sect3 id="xiphos-bible-options">
751
 
                        <title>گزینه‏های مدول</title>
752
 
                        <para>
753
 
                        Most Bible translations have additional options which the user can select.
754
 
                        </para>
755
 
                        <itemizedlist>
756
 
                                <listitem>
757
 
                                        <para>کلمات عیسی مسیح به رنگ قرمز</para>
758
 
                                </listitem>
759
 
                                <listitem>
760
 
                                        <para>شماره‏های کشف‏الآیات استرانگ</para>
761
 
                                </listitem>
762
 
                                <listitem>
763
 
                                        <para>علائم واژه‏شناسی</para>
764
 
                                </listitem>
765
 
                                <listitem>      
766
 
                                        <para>پانویس‏ها</para>
767
 
                                </listitem>
768
 
                                <listitem>      
769
 
                                        <para>ارجاعات به کتاب‏مقدس</para>
770
 
                                </listitem>
771
 
                                <listitem>      
772
 
                                        <para>سر تیترها</para>
773
 
                                </listitem>
774
 
                                <listitem>      
775
 
                                        <para>محتویات تصویر</para>
776
 
                                </listitem>
777
 
                        </itemizedlist>
778
 
                        <note>
779
 
                                <para>
780
 
                                Translations in other languages such as Greek or Hebrew have specific options which deal only with the specific language.
781
 
                                </para>
782
 
                        </note>
783
 
                        <para>به منظور دستیابی به این گزینه‏ها:</para>
784
 
                        <itemizedlist>
785
 
                                <listitem>
786
 
                                        <para>روی ماوس رایت کلیک کنید،<interface>چارچوب متن کتابمقدس باز خواهد شد.</interface>در منویی که باز خواهد شد (مانند نمونۀ زیر)،<guibutton>گزینۀ مدول</guibutton>را انتخاب و کاربرد مورد نظر را علامت گذاری کنید.</para>
787
 
                                </listitem>
788
 
                        </itemizedlist>
789
 
                        <figure id="module_options">
790
 
                                <title>گزینه‏های مدول</title>
791
 
                                <screenshot> 
792
 
          <mediaobject> 
793
 
            <imageobject><imagedata fileref="figures/interface_biblepane-options.png" format="PNG"/> 
794
 
            </imageobject>
795
 
            <!-- EPS versions of the figures are not required at the moment. -->
796
 
            <!-- 
797
 
                    <imageobject>
798
 
                <imagedata fileref="figures/interface_biblepane-options.eps" format="EPS"/>
799
 
                    </imageobject>
800
 
            -->
801
 
            <textobject> 
802
 
              <phrase>گزینه‏های مدول</phrase> 
803
 
            </textobject> 
804
 
          </mediaobject> 
805
 
        
806
 
                                </screenshot>
807
 
                        </figure>
808
 
                </sect3>
809
 
                
810
 
                <sect3 id="xiphos-view-options">
811
 
                        <title>گزینه‏های مرور</title>
812
 
                        <para>
813
 
                        There are several additional modes that can be selected from the menubar's <guimenuitem>View</guimenuitem> pulldown.
814
 
                        </para>
815
 
                        <figure id="view_options">
816
 
                                <title>گزینه‏های مرور</title>
817
 
                                <screenshot> 
818
 
          <mediaobject> 
819
 
            <imageobject><imagedata fileref="figures/interface_menubar-view.png" format="PNG"/> 
820
 
            </imageobject>
821
 
            <!-- EPS versions of the figures are not required at the moment. -->
822
 
            <!-- 
823
 
                    <imageobject>
824
 
                <imagedata fileref="figures/interface_menubar-view.eps" format="EPS"/>
825
 
                    </imageobject>
826
 
            -->
827
 
            <textobject> 
828
 
              <phrase>گزینه‏های مرور</phrase> 
829
 
            </textobject> 
830
 
          </mediaobject> 
831
 
        
832
 
                                </screenshot>
833
 
 
834
 
                        </figure>
835
 
                        <para>
836
 
                        The first 4 checkboxes control whether each named subwindow is displayed.  The viewable state of the subwindows is remembered on a
837
 
                        per-tab basis.  This makes it possible, for example, to have a tab dedicated to a maps module alone (in a dictionary module, having
838
 
                        alphabetically-listed places), by turning off the display of Bible, Previewer, and Commentary for that tab.
839
 
                        </para>
840
 
                        <para>
841
 
                        The remaining checkboxes control these other display features:
842
 
                        </para>
843
 
                        <itemizedlist>
844
 
                                <listitem>      
845
 
                                        <para>
846
 
                                        Verse Style - Toggles between Bible text display in separate verses, or in paragraphs instead.
847
 
                                        This is set on a per-module basis.
848
 
                                        </para>
849
 
                                </listitem>
850
 
                                <listitem>      
851
 
                                        <para>
852
 
                                        Link Tabs - When more than one tab is open, each one's verse is navigated separately in the disabled
853
 
                                        case.  If tab linking is enabled, then all tabs navigate together, keeping all translations on the
854
 
                                        same verse.
855
 
                                        </para>
856
 
                                </listitem>
857
 
                                <listitem>      
858
 
                                        <para>
859
 
                                        Read Aloud - If you enable this, then <application>Xiphos</application> will funnel all selected verses
860
 
                                        through the <application>festival</application> text-to-speech system.  <application>Festival</application> is
861
 
                                        a widely-available TTS, often installed by default in Linux distributions. Reading aloud is not currently
862
 
                                        supported on Windows.
863
 
                                        </para>
864
 
                                        <para>
865
 
                                        Also, mouse-selected text may be read aloud from Bibles, commentaries, and general books, using the
866
 
                                        right-click menu, regardless of whether Read Aloud is selected.
867
 
                                        </para>
868
 
 
869
 
                                </listitem>
870
 
                                <listitem>      
871
 
                                        <para>
872
 
                                        Show Verse Numbers - Normally enabled, this toggle can be disabled to prevent display of verse
873
 
                                        numbers within the text.
874
 
                                        </para>
875
 
                                </listitem>
876
 
                                <listitem>      
877
 
                                        <para>
878
 
                                        Highlight Current Verse - Initially disabled, this toggle replaces mere alternate colorization of
879
 
                                        the current verse with a substitute high-contrast highlight.  The colors used may be selected from
880
 
                                        the Preferences dialog.
881
 
                                        </para>
882
 
                                </listitem>
883
 
                        </itemizedlist>
884
 
                </sect3>
885
 
                
886
 
                <sect3 id="xiphos-user-annotation">
887
 
                        <title>User Annotation</title>
888
 
                        <para>
889
 
                        Many users wish to make personal annotations on individual verses, without the need to put a full "personal commentary" module
890
 
                        to use.  <application>Xiphos</application> provides this in the right-click context menu in the Bible pane.
891
 
                        This brings up a dialog showing the current verse reference and offering a text box into which to enter a brief personal note.
892
 
                        Once the user closes the dialog with "Mark," the verse will be displayed in reverse-highlight (default, blue on yellow) and a
893
 
                        marker <guibutton>*u</guibutton> will be inserted at the verse's beginning.  This is metaphorically similar for users who mark
894
 
                        verses in paper Bibles with a yellow highlighter and write personal notes in the margins.
895
 
                        </para>
896
 
                        <para>
897
 
                        Selecting an already-annotated verse will (in the usual case) bring up the existing content for re-editing.  An
898
 
                        already-annotated verse can be unmarked; the verse will cease to show in reverse-highlight.
899
 
                        </para>
900
 
                        <para>
901
 
                        If the user deletes the module name from the reference at the top of the dialog, then the annotation will apply to any Bible
902
 
                        module at the selected verse.  However, in this case, re-selecting the annotated verse will not initialize with the existing
903
 
                        content, because the dialog is created based on the specific module reference.
904
 
                        </para>
905
 
                </sect3>
906
 
                
907
 
                <sect3 id="xiphos-geography-support">
908
 
                        <title>Geography Support</title>
909
 
                        <para>
910
 
                        A connection to browsing BibleMap.org is available by mouse-selecting a place name in any text.  Use the right-click context
911
 
                        menu to select <menuchoice><guimenuitem>Lookup Selection</guimenuitem><guimenuitem>Browse in
912
 
                        BibleMap.org</guimenuitem></menuchoice>.  A web browser will be brought up to show the selected name's geography via
913
 
                        BibleMap, which provides Biblical detail overlaid on a Google Maps interface.
914
 
                        </para>
915
 
                        <para>
916
 
                        </para>
917
 
                </sect3>
918
 
                
919
 
                <sect3 id="xiphos-bible-dictionary">
920
 
                        <title>Specific Word Meanings</title>
921
 
                        <para>
922
 
                        In order to check the meaning of a specific word, double-click on the word you wish to lookup. The word should then highlight itself and the
923
 
                        explanation should be displayed, if available, in the <interface>Dictionary Pane</interface>. 
924
 
                        </para>
925
 
                </sect3>
926
 
                
927
 
                <sect3 id="xiphos-bible-find">
928
 
                        <title>Finding A Specific Word</title>
929
 
                        <para>
930
 
                        To find a specific word within a passage:
931
 
                        </para>
932
 
                        <itemizedlist>
933
 
                                <listitem>
934
 
                                        <para>
935
 
                                        right-click in the <interface>Bible Text Pane</interface>. In the popup menu, choose <guibutton>Edit</guibutton>-&gt;
936
 
                                        <guibutton>Find</guibutton>. A separate dialog will appear, which provides text searches. Fill out
937
 
                                        dialog and click the <guibutton>Find</guibutton> and <guibutton>Find Next</guibutton> buttons.
938
 
                                        </para> 
939
 
                                </listitem>
940
 
                        </itemizedlist>
941
 
                </sect3>
942
 
        </sect2>
943
 
<!-- ============= Previewer    ================ -->
944
 
        <sect2 id="xiphos-viewer">
945
 
                <title>پیش‏نگر</title>
946
 
                <figure id="viewer_figure">
947
 
                        <title>PreViewer</title>
948
 
                        <screenshot> 
949
 
          <mediaobject> 
950
 
            <imageobject><imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
951
 
            </imageobject>
952
 
            <!-- EPS versions of the figures are not required at the moment. -->
953
 
            <!-- 
954
 
                    <imageobject>
955
 
                <imagedata fileref="figures/interface_viewer.eps" format="EPS"/>
956
 
                    </imageobject>
957
 
            -->
958
 
            <textobject> 
959
 
              <phrase>پیش‏نگر</phrase> 
960
 
            </textobject> 
961
 
          </mediaobject> 
962
 
        
963
 
                        </screenshot>
964
 
                </figure>
965
 
                <para>
966
 
                The Previewer is where the user sees Strong's numbers, morphological tags, footnotes, and cross-references that the
967
 
                <interface>Bible Text Pane</interface> provides.
968
 
                </para>
969
 
                <para>
970
 
                Footnote content is displayed in the Previewer when you hover over the indicator <guibutton>*n</guibutton> in the Bible text;
971
 
                it remains visible until your mouse moves over another indicator, Strong's number, etc. Sometimes you may want the text to
972
 
                remain anchored until you can move the mouse to the previewer to click on a link or to read large footnotes. To anchor the text so
973
 
                that you can scroll it in the Previewer, middle-click the indicator (or hold down the <guibutton>Shift key</guibutton>)
974
 
                and move to the Previewer.
975
 
                </para>
976
 
                <para>
977
 
                Cross-reference indicators <guibutton>*x</guibutton> work much the same way.  Clicking the
978
 
                indicator will send the set of references to the <guibutton>Verse List</guibutton> in the
979
 
                <interface>Sidebar</interface>, where you can click them individually for reading in the Previewer.
980
 
                </para>
981
 
                <para>
982
 
                Any verses shown in reverse-highlight have personal annotation associated with them, and such verses will include
983
 
                <guibutton>*u</guibutton> at the beginning of the verse.  Hovering on this marker will show the annotation in the previewer, just as
984
 
                for publisher's footnotes.
985
 
                </para>
986
 
                <para>
987
 
                If a devotional has been set via the Preferences dialog, then the day's devotional reference will also appear in the
988
 
                previewer, either on program startup or when the user requests it via the <guimenuitem>View</guimenuitem> menu.
989
 
                </para>
990
 
        </sect2>        
991
 
<!-- ============= Commentary Pane  ============--> 
992
 
        <sect2 id="xiphos-commentaries">
993
 
                <title>The Commentary Pane</title>
994
 
                <figure id="commentary_figure">
995
 
                        <title>The Commentary Pane</title>
996
 
                        <screenshot> 
997
 
          <mediaobject> 
998
 
            <imageobject><imagedata fileref="figures/interface_commentarypane.png" format="PNG"/>
999
 
            </imageobject>
1000
 
            <!-- EPS versions of the figures are not required at the moment. -->
1001
 
            <!-- 
1002
 
                    <imageobject>
1003
 
                <imagedata fileref="figures/interface_commentarypane.eps" format="EPS"/>
1004
 
                    </imageobject>
1005
 
            -->
1006
 
            <textobject> 
1007
 
              <phrase>چارچوب تفاسیر</phrase> 
1008
 
            </textobject> 
1009
 
          </mediaobject> 
1010
 
        
1011
 
                        </screenshot>
1012
 
                </figure>
1013
 
                <para>
1014
 
                The <interface>Commentary pane</interface> is where the commentary modules are displayed. This provides easy
1015
 
                reading, reference, and access to different commentaries currently installed. The passage viewed by the 
1016
 
                <interface>Commentary pane</interface> is directly controlled by the current passage viewed in the <interface>Bible
1017
 
                Text pane</interface>, so in order to change to a different passage commentary, select the desired passage
1018
 
                on the <interface>Toolbar</interface>.
1019
 
                </para>
1020
 
                <para>
1021
 
                If there are images that are part of a commentary, general book, or dictionary/lexicon, they may be clicked to invoke a
1022
 
                viewer on that single image, in order to get a better view.  This is particularly useful if image resizing has been enabled
1023
 
                with the result that images are made very small in the subwindow.
1024
 
                </para>
1025
 
                <note>
1026
 
                        <para>
1027
 
                        By changing to passage settings on the <interface>Toolbar</interface>, the contents in the 
1028
 
                        <interface>Bible Text pane</interface> and the <interface>Commentary Pane</interface> will be changed.  
1029
 
                        </para>
1030
 
                </note>
1031
 
                
1032
 
                <sect3 id="xiphos-commentary-about">
1033
 
                        <title>Finding Out About The Commentary Module</title>
1034
 
                        <para>
1035
 
                        To find out about the commentary currently being displayed:
1036
 
                        </para>
1037
 
                        <itemizedlist>
1038
 
                                <listitem>
1039
 
                                        <para>
1040
 
                                        right-click in the <interface>Commentary Pane</interface>. In the popup menu choose
1041
 
                                        <guimenuitem>About </guimenuitem> module name.
1042
 
                                        </para>
1043
 
                                </listitem>
1044
 
                        </itemizedlist>
1045
 
                </sect3>
1046
 
 
1047
 
                <sect3 id="xiphos-commentary-headings">
1048
 
                        <title>Commentary Headings.</title>
1049
 
                        <para>
1050
 
                        Many commentaries have additional headings which enable introductory information about the book and chapter currently
1051
 
                        being displayed in the <interface>Bible Text pane</interface>. In order to view them:
1052
 
                        </para>
1053
 
                        <itemizedlist>
1054
 
                                <listitem>
1055
 
                                        <para>
1056
 
                                        right-click in the <interface>Commentary Pane</interface>. In the popup menu choose
1057
 
                                        <guimenuitem>Display Book Heading</guimenuitem> or <guimenuitem>Display Chapter Heading</guimenuitem>.
1058
 
                                        </para>
1059
 
                                </listitem>
1060
 
                        </itemizedlist>
1061
 
                </sect3>
1062
 
        </sect2>
1063
 
 
1064
 
        <sect2 id="xiphos-dictionary">
1065
 
                <title>Dictionary Pane</title>
1066
 
                <figure id="dict_figure">
1067
 
                        <title>The Dictionary Pane</title>
1068
 
                        <screenshot> 
1069
 
          <mediaobject> 
1070
 
            <imageobject><imagedata fileref="figures/interface_dictionary.png" format="PNG"/> 
1071
 
            </imageobject>
1072
 
            <!-- EPS versions of the figures are not required at the moment. -->
1073
 
            <!-- 
1074
 
                    <imageobject>
1075
 
                <imagedata fileref="figures/image.eps" format="EPS"/>
1076
 
                    </imageobject>
1077
 
            -->
1078
 
            <textobject> 
1079
 
              <phrase>The Dictionary Pane</phrase> 
1080
 
            </textobject> 
1081
 
          </mediaobject> 
1082
 
        
1083
 
                        </screenshot>
1084
 
                </figure>
1085
 
 
1086
 
                <para>
1087
 
                The Dictionary Pane's content is driven by its up/down selectors, typing in its navbar text, or double-clicks in the Bible, Commentary, or Book Panes.
1088
 
                </para>
1089
 
        </sect2>
1090
 
 
1091
 
        <sect2 id="xiphos-shortcut">
1092
 
                <title>Keyboard Shortcuts</title>
1093
 
                <para>
1094
 
                Several keyboard shortcuts exist in <application>Xiphos</application>:
1095
 
                </para>
1096
 
                <itemizedlist>
1097
 
                       <listitem>
1098
 
                                <para>
1099
 
                                        <guibutton>F1</guibutton>: opens this manual.
1100
 
                                </para>
1101
 
                        </listitem>
1102
 
                        <listitem>
1103
 
                                <para>
1104
 
                                        <guibutton>F2</guibutton>: opens the <guibutton>Preferences</guibutton> dialog.
1105
 
                                </para>
1106
 
                        </listitem>
1107
 
                        <listitem>
1108
 
                                <para>
1109
 
                                        <guibutton>F3</guibutton>: opens <guibutton>Advanced Search</guibutton>.
1110
 
                                </para>
1111
 
                        </listitem>
1112
 
                        <listitem>
1113
 
                                <para>
1114
 
                                        <guibutton>F4</guibutton>: opens the <guibutton>Module Manager</guibutton>.
1115
 
                                </para>
1116
 
                        </listitem>
1117
 
                        <listitem>
1118
 
                                <para>
1119
 
                                        <guibutton>Ctrl-L</guibutton> focuses and selects the main verse navbar text.  You can then immediately type
1120
 
                                        in new verse selection text.  Be aware that, as is the case with most Sword applications,
1121
 
                                        <application>Xiphos</application> understands many abbreviations: "G" is adequate to specify Genesis,
1122
 
                                        for example, and any book name by itself implies 1:1.
1123
 
                                </para>
1124
 
                        </listitem>
1125
 
                        <listitem>
1126
 
                                <para>
1127
 
                                        <guibutton>Ctrl-F</guibutton> opens the "Find" dialog.  The subwindow to which it applies depends on which
1128
 
                                        of them are visible: The Bible is first preference, then the commentary or general book, then the
1129
 
                                        dictionary.  So a tab can be dedicated to just a genbook, and Ctrl-F will perform "Find" within that pane.
1130
 
                                </para>
1131
 
                        </listitem>
1132
 
                        <listitem>
1133
 
                                <para>
1134
 
                                        <guibutton>Alt-C</guibutton> brings the Commentary View forward when previously obscured by the Book View.
1135
 
                                </para>
1136
 
                        </listitem>
1137
 
                        <listitem>
1138
 
                                <para>
1139
 
                                        <guibutton>Alt-G</guibutton> is the opposite of Alt-C, focusing on the general book.
1140
 
                                </para>
1141
 
                        </listitem>
1142
 
                        <listitem>
1143
 
                                <para>
1144
 
                                        <guibutton>Alt-B</guibutton> opens a bookmark dialog on the current verse.
1145
 
                                </para>
1146
 
                        </listitem>
1147
 
                        <listitem>
1148
 
                                <para>
1149
 
                                        <guibutton>Alt-D</guibutton> focuses on the dictionary navbar text.
1150
 
                                </para>
1151
 
                        </listitem>
1152
 
                        <listitem>
1153
 
                                <para>
1154
 
                                        <guibutton>Alt-P</guibutton> detaches/re-attaches the parallel view dialog.
1155
 
                                </para>
1156
 
                        </listitem>
1157
 
                        <listitem>
1158
 
                                <para>
1159
 
                                        <guibutton>Alt-Z</guibutton> opens the personal commentary editor.
1160
 
                                </para>
1161
 
                        </listitem>
1162
 
                        <listitem>
1163
 
                                <para>
1164
 
                                        <guibutton>Ctrl-Plus/Ctrl-Minus</guibutton> increases/decreases the base font size.
1165
 
                                </para>
1166
 
                        </listitem>
1167
 
                        <listitem>
1168
 
                                <para>
1169
 
                                Location bar navigation:
1170
 
                                <itemizedlist>
1171
 
                                        <listitem>
1172
 
                                                <para><guibutton>Ctrl-p/Ctrl-n</guibutton>: Verse
1173
 
                                        previous/next.</para>
1174
 
                                        </listitem>
1175
 
                                        <listitem>
1176
 
                                                <para><guibutton>p/n</guibutton>: Chapter
1177
 
                                        previous/next.</para>
1178
 
                                        </listitem>
1179
 
                                        <listitem>
1180
 
                                                <para><guibutton>P/N</guibutton>: Book
1181
 
                                        previous/next.</para>
1182
 
                                        </listitem>
1183
 
                                </itemizedlist>
1184
 
                                </para>
1185
 
                        </listitem>
1186
 
                </itemizedlist>
1187
 
        </sect2>
1188
 
 
1189
 
        <sect2 id="xiphos-differences">
1190
 
                <title>Version Differences in <application>Xiphos</application>'s Display</title>
1191
 
                <para>
1192
 
                The <application>Xiphos</application> interface has evolved over time, and there are two display libraries with which
1193
 
                <application>Xiphos</application> can be built.  The older, less featureful version is called "gtkhtml3", and the newer,
1194
 
                more capable version is called "MozEmbed".  Both of these display libraries render text in a browser-like fashion, using HTML
1195
 
                constructs to control display.
1196
 
                </para>
1197
 
 
1198
 
                <para>
1199
 
                Several desirable capabilities are unsupportable in gtkhtml3, and although recent <application>Xiphos</application> is
1200
 
                written to take advantage of MozEmbed features, it is possible that the version running on your computer needed to be
1201
 
                built with gtkhtml3 instead, either because the version of MozEmbed available for your system is not recent enough to
1202
 
                support the needs of <application>Xiphos</application>, or it simply doesn't exist for your system.  (Mozembed is not
1203
 
                supported under Windows at this time.)  The following differences will be apparent, depending on whether gtkhtml3 or 
1204
 
                MozEmbed is the underlying display engine:
1205
 
                </para>
1206
 
 
1207
 
                <itemizedlist>
1208
 
                        <listitem>
1209
 
                                <para>
1210
 
                                Morphology and Strong's references, enabled via the right-click menu in some modules, are displayed inline
1211
 
                                with gtkhtml3; with MozEmbed, a blocked display is used, where these references are aligned beneath the word
1212
 
                                to which they refer, for a much more readable, less cluttered display.
1213
 
                                </para>
1214
 
                        </listitem>
1215
 
                        <listitem>
1216
 
                                <para>
1217
 
                                Footnote and cross-reference markers (<guibutton>*n</guibutton>, <guibutton>*x</guibutton>) are displayed as
1218
 
                                proper superscripts in MozEmbed, but not in gtkhtml3.
1219
 
                                </para>
1220
 
                        </listitem>
1221
 
                        <listitem>
1222
 
                                <para>
1223
 
                                Links in gtkhtml3 are necessarily both colored and underlined; in MozEmbed, no underlines are needed.
1224
 
                                </para>
1225
 
                        </listitem>
1226
 
                        <listitem>
1227
 
                                <para>
1228
 
                                Under MozEmbed, double-space display is available using the <guimenuitem>View</guimenuitem> menu, but not
1229
 
                                under gtkhtml3.
1230
 
                                </para>
1231
 
                        </listitem>
1232
 
                        <listitem>
1233
 
                                <para>
1234
 
                                It is not possible for gtkhtml3 to interpret multiple font face directives in a single window, so the
1235
 
                                gtkhtml3 detached parallel view window cannot provide per-module font selections.  Also, modules' internal
1236
 
                                font requests are ignored in any gtkhtml3 window.
1237
 
                                </para> 
1238
 
                        </listitem>
1239
 
                </itemizedlist>
1240
 
 
1241
 
                <para>
1242
 
                Using the "About Xiphos" selection under the <guimenuitem>Help</guimenuitem> menu, you will see the display library with
1243
 
                which <application>Xiphos</application> was built.
1244
 
                </para>
1245
 
                <figure id="displib_figure">
1246
 
                  <title>Comparison, gtkhtml3 -vs- mozembed</title>
1247
 
                  <screenshot> 
1248
 
                    <mediaobject> 
1249
 
                      <imageobject>
1250
 
                        <imagedata fileref="figures/gtkhtml3-vs-mozembed.png" format="PNG"/> 
1251
 
                      </imageobject>
1252
 
                      <textobject> 
1253
 
                        <phrase>Comparison, gtkhtml3 -vs- mozembed</phrase> 
1254
 
                      </textobject> 
1255
 
                   </mediaobject> 
1256
 
                  </screenshot>
1257
 
                </figure>
1258
 
        </sect2>
1259
 
 
1260
 
  </sect1>
1261
 
 
1262
 
  <!-- Preferences -->
1263
 
  <sect1 id="preferences">
1264
 
    <title>Preferences</title>
1265
 
    <!-- Preferences -->
1266
 
 
1267
 
 
1268
 
<!-- Introduction -->
1269
 
        <sect2 id="preferences-introduction">
1270
 
                <title>Introduction To Preferences</title>
1271
 
                <figure>
1272
 
                        <title>The Preference Dialog</title>
1273
 
                        <screenshot> 
1274
 
          <mediaobject> 
1275
 
            <imageobject><imagedata fileref="figures/preferences.png" format="PNG"/> 
1276
 
            </imageobject>
1277
 
            <!-- EPS versions of the figures are not required at the moment. -->
1278
 
            <!-- 
1279
 
                    <imageobject>
1280
 
                <imagedata fileref="figures/preferences.eps" format="EPS"/>
1281
 
                    </imageobject>
1282
 
            -->
1283
 
            <textobject> 
1284
 
              <phrase>The Preferences Dialog</phrase> 
1285
 
            </textobject> 
1286
 
          </mediaobject> 
1287
 
                        </screenshot>
1288
 
                </figure>
1289
 
               </sect2>
1290
 
        
1291
 
<!-- Fonts And Colors -->
1292
 
        <sect2 id="fonts-and-colors">
1293
 
                <title>Fonts And Colors</title>
1294
 
                <sect3 id="font-color">
1295
 
                        <title>Setting Font Colors</title>
1296
 
                        <figure>
1297
 
                        <title>Font Colour Settings</title>
1298
 
                        <screenshot> 
1299
 
          <mediaobject> 
1300
 
            <imageobject><imagedata fileref="figures/preferences_fonts-color.png" format="PNG"/>
1301
 
            </imageobject>
1302
 
            <!-- EPS versions of the figures are not required at the moment. -->
1303
 
            <!-- 
1304
 
                    <imageobject>
1305
 
                <imagedata fileref="figures/image.eps" format="EPS"/>
1306
 
                    </imageobject>
1307
 
            -->
1308
 
            <textobject> 
1309
 
              <phrase>Font Colour Settings</phrase> 
1310
 
            </textobject> 
1311
 
          </mediaobject> 
1312
 
                        </screenshot>
1313
 
 
1314
 
                </figure>
1315
 
                </sect3>
1316
 
                
1317
 
                <sect3 id="font-misc">
1318
 
                        <title>Miscellaneous Font Settings</title>
1319
 
                        <figure>
1320
 
                        <title>Miscellaneous Font Settings</title>
1321
 
                        <screenshot> 
1322
 
          <mediaobject> 
1323
 
            <imageobject><imagedata fileref="figures/preferences_fonts-misc.png" format="PNG"/> 
1324
 
            </imageobject>
1325
 
            <!-- EPS versions of the figures are not required at the moment. -->
1326
 
            <!-- 
1327
 
                    <imageobject>
1328
 
                <imagedata fileref="figures/preferences_fonts-misc.eps" format="EPS"/>
1329
 
                    </imageobject>
1330
 
            -->
1331
 
            <textobject> 
1332
 
              <phrase>Miscellaneous Font Settings</phrase> 
1333
 
            </textobject> 
1334
 
          </mediaobject> 
1335
 
        
1336
 
                        </screenshot>
1337
 
                </figure>
1338
 
 
1339
 
                <para>
1340
 
                In individual modules' display, the right-click menu's <guimenuitem>Module Options</guimenuitem> selector provides font name
1341
 
                and size selection.
1342
 
                </para>
1343
 
 
1344
 
                <para>
1345
 
                The base font size is the size initially chosen for all modules displayed by <application>Xiphos</application>.  The
1346
 
                verse number and individual modules' font size choices are relative to the base font size.
1347
 
                </para>
1348
 
                </sect3>
1349
 
        </sect2>
1350
 
        
1351
 
<!-- General Settings -->
1352
 
        <sect2 id="general-settings">
1353
 
                <title>General Settings</title>
1354
 
                <sect3 id="tab-pane1">
1355
 
                        <title>Tabs and Pane Settings</title>
1356
 
                <figure>
1357
 
                        <title>Tab and Pane Settings</title>
1358
 
                        <screenshot> 
1359
 
          <mediaobject> 
1360
 
            <imageobject><imagedata fileref="figures/preferences_general-tabs.png" format="PNG"/> 
1361
 
            </imageobject>
1362
 
            <!-- EPS versions of the figures are not required at the moment. -->
1363
 
            <!-- 
1364
 
                    <imageobject>
1365
 
                <imagedata fileref="figures/preferences_general-tabs.eps" format="EPS"/>
1366
 
                    </imageobject>
1367
 
            -->
1368
 
            <textobject> 
1369
 
              <phrase>Tab and Pane Settings</phrase> 
1370
 
            </textobject> 
1371
 
          </mediaobject> 
1372
 
        
1373
 
                        </screenshot>
1374
 
 
1375
 
                </figure>
1376
 
                </sect3>
1377
 
                <sect3 id="tab-pane2">
1378
 
                        <title>General Preferences and StudyPad directory</title>
1379
 
                <figure>
1380
 
                        <title>General Preferences and StudyPad directory</title>
1381
 
                        <screenshot> 
1382
 
          <mediaobject> 
1383
 
            <imageobject><imagedata fileref="figures/preferences_general-misc.png" format="PNG"/>
1384
 
            </imageobject>
1385
 
            <!-- EPS versions of the figures are not required at the moment. -->
1386
 
            <!-- 
1387
 
                    <imageobject>
1388
 
                <imagedata fileref="figures/preferences_general-misc.eps" format="EPS"/>
1389
 
                    </imageobject>
1390
 
            -->
1391
 
            <textobject> 
1392
 
              <phrase>General Preferences and StudyPad directory</phrase> 
1393
 
            </textobject> 
1394
 
          </mediaobject> 
1395
 
        
1396
 
                        </screenshot>
1397
 
 
1398
 
                </figure>
1399
 
                <para>
1400
 
                Certain dictionary-style modules are <guilabel>Daily Devotionals</guilabel> whose keys are numerically in the form "Month.Day".  If you have
1401
 
                such a module installed and it has been selected as your preferred devotional, then you can ask that <application>Xiphos</application>
1402
 
                display today's selection during startup.
1403
 
                </para>
1404
 
                <para>
1405
 
                <guilabel>Verse style</guilabel> indicates that each verse should begin on a separate line, or (when disabled) that verses
1406
 
                should be allowed to group in paragraphs, according to the Bible module's internal markup.  Not all Bible modules have such
1407
 
                markup.
1408
 
                </para>
1409
 
                <para>
1410
 
                With <guilabel>Scroll to Previous/Next Chapter</guilabel> enabled, using the mouse to scroll to the beginning or end of a
1411
 
                chapter will cause <application>Xiphos</application> to move automatically to the appropriate chapter.
1412
 
                </para>
1413
 
                <para>
1414
 
                If you enable <guilabel>Resize images</guilabel>, <application>Xiphos</application> will automatically resize image
1415
 
                content in commentaries, general books, and dictionaries so as to fit the subwindow which contains them.
1416
 
                </para>
1417
 
                <para>
1418
 
                <guilabel>Highlight current verse</guilabel>, if enabled, will cause <application>Xiphos</application> to substitute
1419
 
                mere current verse colorization with a high-contrast alternate color scheme on the current verse.  The colors used may be
1420
 
                chosen from the color selector pane (see above).
1421
 
                </para>
1422
 
                </sect3>
1423
 
        </sect2>
1424
 
        
1425
 
<!-- Module Settings -->
1426
 
        <sect2 id="module-settings">
1427
 
                <title>Module Settings</title>
1428
 
                <sect3 id="main-modules">
1429
 
                        <title>Main Module Settings</title>
1430
 
                <figure>
1431
 
                        <title>The Module Preferences Dialog</title>
1432
 
                        <screenshot> 
1433
 
          <mediaobject> 
1434
 
            <imageobject><imagedata fileref="figures/preferences_modules-main.png" format="PNG"/>
1435
 
            </imageobject>
1436
 
            <!-- EPS versions of the figures are not required at the moment. -->
1437
 
            <!-- 
1438
 
                    <imageobject>
1439
 
                <imagedata fileref="figures/preferences_modules-main.eps" format="EPS"/>
1440
 
                    </imageobject>
1441
 
            -->
1442
 
            <textobject> 
1443
 
              <phrase>The Module Preferences Dialog</phrase> 
1444
 
            </textobject> 
1445
 
          </mediaobject>
1446
 
                        </screenshot>
1447
 
 
1448
 
                </figure>
1449
 
                <figure>
1450
 
                        <title>Parallel Preferences</title>
1451
 
                        <screenshot> 
1452
 
          <mediaobject> 
1453
 
            <imageobject><imagedata fileref="figures/preferences_modules-parallel.png" format="PNG"/> 
1454
 
            </imageobject>
1455
 
            <!-- EPS versions of the figures are not required at the moment. -->
1456
 
            <!-- 
1457
 
                    <imageobject>
1458
 
                <imagedata fileref="figures/preferences_modules-parallel.eps" format="EPS"/>
1459
 
                    </imageobject>
1460
 
            -->
1461
 
            <textobject> 
1462
 
              <phrase>Parallel Preferences</phrase> 
1463
 
            </textobject> 
1464
 
          </mediaobject> 
1465
 
                        </screenshot>
1466
 
 
1467
 
                </figure>
1468
 
                <figure>
1469
 
                        <title>Various preferences Modules </title>
1470
 
                        <screenshot> 
1471
 
          <mediaobject> 
1472
 
            <imageobject><imagedata fileref="figures/preferences_modules-misc.png" format="PNG"/> 
1473
 
            </imageobject>
1474
 
            <!-- EPS versions of the figures are not required at the moment. -->
1475
 
            <!-- 
1476
 
                    <imageobject>
1477
 
                <imagedata fileref="figures/preferences_modules-misc.eps" format="EPS"/>
1478
 
                    </imageobject>
1479
 
            -->
1480
 
            <textobject> 
1481
 
              <phrase>Various Preferences Modules</phrase> 
1482
 
            </textobject> 
1483
 
          </mediaobject> 
1484
 
        
1485
 
                        </screenshot>
1486
 
 
1487
 
                </figure>
1488
 
                </sect3>
1489
 
        </sect2>
1490
 
 
1491
 
 
1492
 
  </sect1>
1493
 
 
1494
 
  <!-- Modules -->
1495
 
  <sect1 id="module-manager">
1496
 
    <title>Module Manager</title>
1497
 
    <!-- Modules -->
1498
 
 
1499
 
<!-- Introduction To Module Manager -->
1500
 
        <sect2 id="module-introduction">
1501
 
                <title>Introduction To The Module Manager</title>
1502
 
                <para>
1503
 
                The "module" is the unit of content in <application>Xiphos</application>, and Sword generally; a Sword module is a
1504
 
                resource available for viewing in Sword applications.  There are several varieties: Most importantly, Bible texts, as well
1505
 
                as dictionaries and lexicons, commentaries, and general books, any of which may include image content (e.g. atlases).
1506
 
                They are installed either from a local directory structure (typically on removable media, such as a CDROM distribution)
1507
 
                or remotely via ftp from a repository such as Crosswire, which is the home of Sword, and from which all officially
1508
 
                Sword-sanctioned modules are available.  Also, many other modules are available from non-Crosswire repositories.
1509
 
                </para>
1510
 
                <para>
1511
 
                If you have other Sword applications installed, they will all share the same set of Sword modules that you install through
1512
 
                the Module Manager.
1513
 
                </para>
1514
 
                <figure>
1515
 
                        <title>The Module Manager Dialog</title>
1516
 
                        <screenshot> 
1517
 
          <mediaobject> 
1518
 
            <imageobject><imagedata fileref="figures/module.png" format="PNG"/> 
1519
 
            </imageobject>
1520
 
            <!-- EPS versions of the figures are not required at the moment. -->
1521
 
            <!-- 
1522
 
                    <imageobject>
1523
 
                <imagedata fileref="figures/module.eps" format="EPS"/>
1524
 
                    </imageobject>
1525
 
            -->
1526
 
            <textobject> 
1527
 
              <phrase>The Module Manager Dialog</phrase> 
1528
 
            </textobject> 
1529
 
          </mediaobject> 
1530
 
                        </screenshot>
1531
 
                </figure>
1532
 
        </sect2>
1533
 
        
1534
 
<!-- Sword Configure-->
1535
 
        <sect2 id="sword-config">
1536
 
        <title>Sword Module Configurations</title>
1537
 
                <sect3 id="sword-sources">
1538
 
                        <title>Module Sources Settings</title>
1539
 
                        <figure>
1540
 
                                <title>Module Sources Settings</title>
1541
 
                        <screenshot> 
1542
 
          <mediaobject> 
1543
 
            <imageobject><imagedata fileref="figures/sword_sources.png" format="PNG"/>
1544
 
            </imageobject>
1545
 
            <!-- EPS versions of the figures are not required at the moment. -->
1546
 
            <!-- 
1547
 
                    <imageobject>
1548
 
                <imagedata fileref="figures/sword_sources.eps" format="EPS"/>
1549
 
                    </imageobject>
1550
 
            -->
1551
 
            <textobject> 
1552
 
              <phrase>Module Installation</phrase> 
1553
 
            </textobject> 
1554
 
          </mediaobject> 
1555
 
                                </screenshot>
1556
 
 
1557
 
                        </figure>
1558
 
                <para>
1559
 
                There are other repositories available besides CrossWire's own, though the modules available from other repositories do not
1560
 
                represent content officially sanctioned by Crosswire.  On the web, see this page for list of those repositories known:
1561
 
                <ulink type="http" url="http://www.crosswire.org/wiki/Module_Repositories">http://www.crosswire.org/wiki/Module_Repositories</ulink>            
1562
 
                </para>
1563
 
                <para>
1564
 
                The list of standard repositories is maintained at CrossWire.  Xiphos normally auto-synchronizes with that list one time,
1565
 
                when the user first puts the Module Manager to use.  The list may change, as new repositories come into existence;
1566
 
                occasional re-synchronization with the list is suggested, which is accomplished by clicking the <guibutton>Load
1567
 
                Standard</guibutton>.
1568
 
                </para>
1569
 
                </sect3>
1570
 
                <sect3 id="installation">
1571
 
                        <title>Sword Module Installations</title>
1572
 
                        <figure>
1573
 
                                <title>Sword Module Installations</title>
1574
 
                        <screenshot> 
1575
 
          <mediaobject> 
1576
 
            <imageobject><imagedata fileref="figures/sword_config.png" format="PNG"/> 
1577
 
            </imageobject>
1578
 
            <!-- EPS versions of the figures are not required at the moment. -->
1579
 
            <!-- 
1580
 
                    <imageobject>
1581
 
                <imagedata fileref="figures/sword_config.eps" format="EPS"/>
1582
 
                    </imageobject>
1583
 
            -->
1584
 
            <textobject> 
1585
 
              <phrase>Module Installation</phrase> 
1586
 
            </textobject> 
1587
 
          </mediaobject> 
1588
 
                        </screenshot>
1589
 
                        </figure>
1590
 
                        <para>
1591
 
                        After you have selected your Install Source, click the <guimenuitem>Refresh</guimenuitem> button to cause
1592
 
                        <application>Xiphos</application> to find the module summary available from that source before moving on.
1593
 
                        </para>
1594
 
 
1595
 
                        <para>
1596
 
                        Take note of the "Install Destination". In most cases, you will have a choice of a personal area or a system area. 
1597
 
                        The details vary according to your operating system.
1598
 
                        </para>
1599
 
                        
1600
 
                        <sect4 id="destination-linux">
1601
 
                                <title>Linux</title>
1602
 
                                <para>
1603
 
                                Unless you run as root (via su or sudo) you will only be able to install in your personal area, under ~/.sword.
1604
 
                                If you run as root, or change permissions on the shared directory, you will also be able to install modules for
1605
 
                                all users, typically in /usr/share/sword. There have been some requests for Xiphos to provide a means by which
1606
 
                                an ordinary (non-root) user could start the program, gain temporary write access to the system area while installing
1607
 
                                modules, and then revoke that access after installation is complete.  Attempting to devise a scheme to do this has
1608
 
                                proven quite difficult, given the different superuser management schemes employed by various Linux distributions. 
1609
 
                                Therefore, at this time there are no ongoing plans to try to solve this problem, and users are advised to enable 
1610
 
                                write access to the system area outside Xiphos.
1611
 
                                </para>
1612
 
                        </sect4>
1613
 
                        
1614
 
                        <sect4 id="destination-xp">
1615
 
                                <title>Windows XP</title>
1616
 
                                <para>
1617
 
                                You may install modules to a shared folder so the modules are available to all users. If you have previously used
1618
 
                                "The Sword Project for Windows", this folder will be "C:\Program Files\Crosswire\The Sword Project\Sword". Otherwise
1619
 
                                it will be "C:\Documents and Settings\All Users\Application Data\Sword". You may also install modules to a location
1620
 
                                that can only be seen by you. This location is "C:\Documents and Settings\YOUR NAME\Application Data\Sword".
1621
 
                                </para>
1622
 
                        </sect4>
1623
 
                        
1624
 
                        <sect4 id="destination-vista">
1625
 
                                <title>Windows Vista</title>
1626
 
                                <para>
1627
 
                                Vista works much the same as XP, except for the locations. The private location is 
1628
 
                                "C:\Users\YOUR NAME\AppData\Roaming\Sword". The shared location is "C:\ProgramData\Sword".
1629
 
                                </para>
1630
 
                        </sect4>
1631
 
                        
1632
 
                </sect3>
1633
 
        </sect2>
1634
 
        
1635
 
<!-- Installing, Updating, and Maintaining Modules -->
1636
 
        <sect2 id="module-management">
1637
 
                <title>Installing, Updating, and Maintaining Modules</title>
1638
 
                <sect3 id="add-module">
1639
 
                        <title>Installing, Updating, and Maintaining Modules</title>
1640
 
                        <figure>
1641
 
                                <title>Installing and Updating Modules</title>
1642
 
                        <screenshot> 
1643
 
          <mediaobject> 
1644
 
            <imageobject><imagedata fileref="figures/sword_install.png" format="PNG"/> 
1645
 
            </imageobject>
1646
 
            <!-- EPS versions of the figures are not required at the moment. -->
1647
 
            <!-- 
1648
 
                    <imageobject>
1649
 
                <imagedata fileref="figures/image.eps" format="EPS"/>
1650
 
                    </imageobject>
1651
 
            -->
1652
 
            <textobject> 
1653
 
              <phrase>Module Installation</phrase> 
1654
 
            </textobject> 
1655
 
          </mediaobject> 
1656
 
        
1657
 
                        </screenshot>
1658
 
                        </figure>
1659
 
                <para>
1660
 
                The module manager generates both a per-type module list as well as a parallel availability list.  The latter is
1661
 
                intended to make it easier to find new items without having to work one's way through the per-type list, one subtree at a
1662
 
                time.  Modules which are either not yet installed or updated beyond what is currently installed will appear in both lists.
1663
 
                </para>
1664
 
                <para>
1665
 
                Modules that are already installed will show a checkmark beside them.  If a fast search ("lucene") index is available, a magnifying glass will be
1666
 
                displayed, otherwise an "X" will be shown; creation of the index is available on the Maintenance pane.  Locked modules, which require that you
1667
 
                purchase an unlock key from the module's copyright holder, will show a lock symbol.  If there are modules installed for which a more recent
1668
 
                version is available, a refresh icon will appear between the differing old and new version stamps.  There may be an approximate size displayed,
1669
 
                if the repository management provides this information, otherwise a question mark ("-?-") will be shown.
1670
 
                </para>
1671
 
                <para>
1672
 
                Select new modules to be installed by clicking the checkboxes and then the Install button at the bottom.  Any number of
1673
 
                modules may be requested for installation at one time.
1674
 
                </para>
1675
 
                <para>
1676
 
                If you acquire a locked module and have obtained the cipher key for it, the module is then unlocked in the main window: Open
1677
 
                the module, which will probably appear blank, then using the right-click context menu, choose "Unlock This Module."
1678
 
                </para>
1679
 
                </sect3>
1680
 
                <sect3 id="remove-module">
1681
 
                        <title>Module Maintenance</title>
1682
 
                        <figure>
1683
 
                                <title>Module Maintenance</title>
1684
 
                        <screenshot> 
1685
 
          <mediaobject> 
1686
 
            <imageobject><imagedata fileref="figures/sword_remove.png" format="PNG"/> 
1687
 
            </imageobject>
1688
 
            <!-- EPS versions of the figures are not required at the moment. -->
1689
 
            <!-- 
1690
 
                    <imageobject>
1691
 
                <imagedata fileref="figures/sword_remove.eps" format="EPS"/>
1692
 
                    </imageobject>
1693
 
            -->
1694
 
            <textobject> 
1695
 
              <phrase>Module Maintenance</phrase> 
1696
 
            </textobject> 
1697
 
          </mediaobject> 
1698
 
                                </screenshot>
1699
 
                        </figure>
1700
 
                <para>
1701
 
                Several maintenance functions are available: Removal, archival, index, and index deletion.
1702
 
                </para>
1703
 
                <para>
1704
 
                Removal disposes of a module entirely.  There is no recovery of the module unless you have previously archived a copy of it.
1705
 
                </para>
1706
 
                <para>
1707
 
                Archival is available for any module, although it is provided with personal commentaries specifically in mind.  A *.zip of
1708
 
                the module is left in the directory ~/.sword/zip.  Archival prior to removal of personal commentaries is recommended, in
1709
 
                order to be available for future re-install if the subject matter of the personal commentary becomes important again.
1710
 
                </para>
1711
 
                <para>
1712
 
                Indexing is provided so that the underlying Sword search support can create the index needed for the "lucene" multi-word
1713
 
                fast-search functions.  If the index is not created, multi-word search will still be available, but it will be much slower.
1714
 
                With the index in place, searches through an entire Bible can take just a few seconds.
1715
 
                </para>
1716
 
                <para>
1717
 
                Indexes may be deleted as well.
1718
 
                </para>
1719
 
                </sect3>
1720
 
        </sect2>
1721
 
 
1722
 
<!-- Installing Non-Standard Modules -->
1723
 
        <sect2 id="non-standard-modules">
1724
 
                <title>Installing Non-Standard Modules</title>
1725
 
                <para>
1726
 
                Some resource modules in Sword Project format are available from sources other than Crosswire and not from a module manager-ready repository.
1727
 
                Necessarily, installing such a module is a manual task.
1728
 
                </para>
1729
 
                <para>
1730
 
                Modules are normally packaged as *.zip files; they contain a configuration file plus a number of data files.  Installation
1731
 
                of such a module is done by cd'ing to your personal Sword (not <application>Xiphos</application>) configuration
1732
 
                directory, ~/.sword, and unzipping the file there.  The configuration file will be left in "mods.d", and the module's data
1733
 
                files will go into a subdirectory of "modules".  Alternatively, if you have write access to the system Sword directory,
1734
 
                typically /usr/share/sword, you may cd there instead before unzipping.
1735
 
                </para>
1736
 
                <para>
1737
 
                Restart <application>Xiphos</application> after installing such a module, so that a fresh instance of the program can
1738
 
                notice the new module in place.
1739
 
                </para>
1740
 
        </sect2>
1741
 
 
1742
 
  </sect1>
1743
 
 
1744
 
  <!-- Searching -->
1745
 
  <sect1 id="search">
1746
 
    <title>The Search Function</title>
1747
 
    <!-- ============= Search  ============--> 
1748
 
 
1749
 
        <sect2 id="xiphos-searchpane">
1750
 
                <title>Simple Searches</title>
1751
 
                <para>
1752
 
                To conduct a quick search within the current Bible or commentary module, the Search Bar in the Sidebar should usually be adequate. Click either
1753
 
                in the menu bar <guimenuitem>Edit-&gt;Search</guimenuitem> or in the Sidebar <guimenuitem>Modules-&gt;Search</guimenuitem> to access it.
1754
 
                </para> 
1755
 
        
1756
 
                <figure>
1757
 
                <title>The Search Bar</title>
1758
 
                       <screenshot> 
1759
 
          <mediaobject> 
1760
 
            <imageobject><imagedata fileref="figures/interface_searchpane.png" format="PNG"/> 
1761
 
            </imageobject>
1762
 
            <!-- EPS versions of the figures are not required at the moment. -->
1763
 
            <!-- 
1764
 
                    <imageobject>
1765
 
                <imagedata fileref="figures/interface_searchpane.eps" format="EPS"/>
1766
 
                    </imageobject>
1767
 
            -->
1768
 
            <textobject> 
1769
 
              <phrase>The Search Bar</phrase> 
1770
 
            </textobject> 
1771
 
          </mediaobject> 
1772
 
        
1773
 
                       </screenshot>
1774
 
 
1775
 
                </figure>
1776
 
              <para>
1777
 
                The <interface>Search Dialog</interface> consists of the following parts:
1778
 
                </para>
1779
 
                        <itemizedlist>
1780
 
                                <listitem>
1781
 
                                        <para>
1782
 
                                        Search Key Entry box
1783
 
                                        </para>
1784
 
                                </listitem>
1785
 
                                <listitem>
1786
 
                                        <para>
1787
 
                                        Search Module Selector
1788
 
                                        </para>
1789
 
                                </listitem>
1790
 
                                <listitem>
1791
 
                                        <para>
1792
 
                                        Search Type Selector
1793
 
                                        </para>
1794
 
                                </listitem>
1795
 
                                <listitem>
1796
 
                                        <para>
1797
 
                                        Search Options Checkbox
1798
 
                                        </para>
1799
 
                                </listitem>
1800
 
                                <listitem>
1801
 
                                        <para>
1802
 
                                        Search Scope Selector
1803
 
                                        </para>
1804
 
                                </listitem>
1805
 
                                <listitem>
1806
 
                                        <para>
1807
 
                                        Search Results View
1808
 
                                        </para>
1809
 
                                </listitem>
1810
 
                        </itemizedlist>                 
1811
 
                <sect3 id="xiphos-search-key">
1812
 
                        <title>Search Key Entry Box</title>
1813
 
                        <para>Allows entry of the key for which you would like to search. The 
1814
 
                        search key can be a word, part of a word, several words, a phrase, or 
1815
 
                        a regular expression depending on the type of search selected. When 
1816
 
                        the search key is entered and all other selections in the search dialog 
1817
 
                        are complete, click the <guibutton>Find</guibutton> button to begin 
1818
 
                        the search.
1819
 
                        </para>
1820
 
                        <para>
1821
 
                        This search uses the optimized search method (see next section) if
1822
 
                        the module has previously been indexed, and will use AND semantics by default 
1823
 
                        (verses must contain all words you entered).
1824
 
                        </para>
1825
 
                        </sect3>
1826
 
                
1827
 
                <sect3 id="xiphos-search-modselect">
1828
 
                        <title>Search Module Selector</title>
1829
 
                        <para>Allows selection of which modules you would like to search. 
1830
 
                        Select <guibutton>Bible</guibutton> to search Bible versions or 
1831
 
                        <guibutton>Commentary</guibutton> to search commentaries. Only 
1832
 
                        the currently active module will be searched.</para>
1833
 
                </sect3>
1834
 
                
1835
 
                <sect3 id="xiphos-search-typeselect">
1836
 
                <title>Search Type Selector</title>
1837
 
                <para>Allows selection of the type of search. There are three search
1838
 
                types available:
1839
 
                </para>
1840
 
                        <variablelist>
1841
 
                                <varlistentry>
1842
 
                                        <term><guibutton>Multi word</guibutton></term> 
1843
 
                                        <listitem><para>This type will match any verse that has 
1844
 
                                        all the words in the search key, regardless of where 
1845
 
                                        they appear in the verse.</para></listitem>
1846
 
                                </varlistentry>
1847
 
                                <varlistentry>
1848
 
                                        <term><guibutton>Regular expression</guibutton></term> 
1849
 
                                        <listitem><para>This search uses a regular expression
1850
 
                                        as a search key. A regular expression is a pattern used 
1851
 
                                        to match a string of text. A regular expression can be 
1852
 
                                        used to find verses with words that match a particular 
1853
 
                                        pattern. For example the regular expression
1854
 
                                        <userinput>[a-z]*iah </userinput> will match verses that contain
1855
 
                                        the words Aiah, Ahaziah, Athaliah and Amariah.</para>
1856
 
                                        <para>A complete discussion of regular expressions is 
1857
 
                                        beyond the scope of this manual, but more information 
1858
 
                                        can be found in the grep man page.</para></listitem>
1859
 
                                </varlistentry>
1860
 
                                <varlistentry>
1861
 
                                        <term><guibutton>Exact phrase</guibutton></term> 
1862
 
                                        <listitem><para>This type will match the search key
1863
 
                                        exatly as entered. If the search key is <userinput>
1864
 
                                        it is good</userinput>, this search would match a verse
1865
 
                                        which contains "<emphasis>it is good</emphasis>," but 
1866
 
                                        would not match a verse which contains "<emphasis>
1867
 
                                        good</emphasis>, and doeth <emphasis>it</emphasis> not, 
1868
 
                                        to him it <emphasis>is</emphasis> sin."</para></listitem>
1869
 
                                </varlistentry>
1870
 
                        </variablelist>
1871
 
                </sect3>
1872
 
 
1873
 
                <sect3 id="xiphos-search-options">
1874
 
                        <title>Search Options Checkbox</title>
1875
 
                        <para>Allows selecting of search options. The only available option 
1876
 
                        is <guibutton>Match case</guibutton>. Check this box to make the 
1877
 
                        search case sensitive.</para>
1878
 
                </sect3>
1879
 
                
1880
 
                <sect3 id="xiphos-search-scopeselect">
1881
 
                        <title>Search Scope Selector</title>
1882
 
                        <para>Allows defining the range within the specificed module that will
1883
 
                        be searched. There are three search scopes available:</para>
1884
 
                        <variablelist>
1885
 
                                <varlistentry>
1886
 
                                        <term><guibutton>No scope</guibutton></term>
1887
 
                                        <listitem><para>This button causes the search to
1888
 
                                        to include the entire module.</para>
1889
 
                                        </listitem>
1890
 
                                </varlistentry>
1891
 
                                <varlistentry>
1892
 
                                        <term><guibutton>Use bounds</guibutton></term>
1893
 
                                        <listitem><para>Selecting this button produces two dropdown
1894
 
                                        selector boxes marked <guilabel>Lower</guilabel> and
1895
 
                                        <guilabel>Upper</guilabel>. Select the first book
1896
 
                                        to search in the <guilabel>Lower</guilabel> box and
1897
 
                                        the last book to search in the <guilabel>Upper</guilabel>
1898
 
                                        box. The search will begin with the <guilabel>Lower
1899
 
                                        </guilabel> book and end with the <guilabel>Upper
1900
 
                                        </guilabel> book and include all books in between.
1901
 
                                        </para>
1902
 
                                        <para>Chapter and verse numbers can be entered into
1903
 
                                        the search bound boxes as well to further narrow the
1904
 
                                        search. </para>
1905
 
                                        </listitem>
1906
 
                                </varlistentry>
1907
 
                                <varlistentry>
1908
 
                                        <term><guibutton>Last search</guibutton></term>
1909
 
                                        <listitem><para>Select this button to do a new 
1910
 
                                        search including only the verses returned as a 
1911
 
                                        result of the last search. Use this with a new 
1912
 
                                        search key to narrow the search further.</para>
1913
 
                                        </listitem>
1914
 
                                </varlistentry>
1915
 
                        </variablelist> 
1916
 
                </sect3>
1917
 
                <sect3 id="xiphos-search-results">
1918
 
                        <title>Search Results View</title>
1919
 
                        <para>This shows a list of the current search results for previewing, navigation, or saving.</para>
1920
 
                        <variablelist>
1921
 
                                <varlistentry>
1922
 
                                        <term>Preview</term>
1923
 
                                        <listitem><para>To preview the search result, simply click on an individual result.
1924
 
                                        The entry will show in the preview pane.
1925
 
                                        </para>
1926
 
                                        </listitem>
1927
 
                                </varlistentry>
1928
 
                                <varlistentry>
1929
 
                                        <term>Navigation</term>
1930
 
                                        <listitem><para>Navigation to the search result can be done in two ways. To open the result
1931
 
                                        in a new tab, middle-click the mouse. To open the result in the current tab, double-click the result.
1932
 
                                        </para>
1933
 
                                        </listitem>
1934
 
                                </varlistentry>
1935
 
                                <varlistentry>
1936
 
                                        <term>Save Results</term>
1937
 
                                        <listitem><para>You may save your results as a list of bookmarks. To do this, right-click and select
1938
 
                                        <guilabel>Save List</guilabel>. You will be prompted to enter a name for the folder that your results
1939
 
                                        will be saved to. After you have saved the results, you may view them by going to your bookmarks and
1940
 
                                        finding the folder you just named.
1941
 
                                        </para>
1942
 
                                        </listitem>
1943
 
                                </varlistentry>
1944
 
                        </variablelist>
1945
 
        </sect3>
1946
 
        </sect2>
1947
 
        <sect2 id="xiphos-advanced-search">
1948
 
           <title>Advanced Searches</title> 
1949
 
           <para>
1950
 
                More complicated searches might require the use of the advanced search functions, found under <guimenuitem>Edit-&gt;Advanced
1951
 
                Search</guimenuitem>.
1952
 
           </para>
1953
 
         
1954
 
          <figure>
1955
 
          <title>The Advanced Search Dialogue</title>
1956
 
          <screenshot> 
1957
 
          <mediaobject> 
1958
 
            <imageobject><imagedata fileref="figures/search_search.png" format="PNG"/> 
1959
 
            </imageobject>
1960
 
            <!-- EPS versions of the figures are not required at the moment. -->
1961
 
            <!-- 
1962
 
                    <imageobject>
1963
 
                <imagedata fileref="figures/search_search.eps" format="EPS"/>
1964
 
                    </imageobject>
1965
 
            -->
1966
 
            <textobject> 
1967
 
              <phrase>The Advanced Search  Dialog</phrase> 
1968
 
            </textobject> 
1969
 
          </mediaobject> 
1970
 
        
1971
 
          </screenshot> 
1972
 
 
1973
 
          </figure>
1974
 
           
1975
 
           <para>
1976
 
                In <guimenuitem>Advanced Search</guimenuitem>, much more complex queries can be constructed, involving custom search ranges,
1977
 
                custom lists of modules over which to search, regular expression matching (see next section), and attribute-based searches
1978
 
                such as are found in footnotes or Strong's Hebrew and Greek dictionary references.
1979
 
           </para>
1980
 
 
1981
 
           <para>
1982
 
                The default search is multi-word, a somewhat slow and blunt search through module text.  Also available is an optimized
1983
 
                search based on the Lucene indexing and search library. In order to use the optimized search, the index must be constructed
1984
 
                beforehand: Please see the preceding section on the Module Manager regarding the Maintenance functions, including indexing. A
1985
 
                web search will provide several references to the syntax needed to put to use the power of optimized Lucene search. A few
1986
 
                examples follow:
1987
 
           </para>
1988
 
           
1989
 
           <para>
1990
 
                Simple Searches: just type in the words you want to search for. To return only verses that include all of the words,
1991
 
                prefix the word with "+". So, in the KJV, you could find Psalm 23 by searching for "+Lord +shepherd +want". To search for
1992
 
                an entire phrase, surround the entire phrase with quotes, like "maketh me to lie down" (note that quotes are unnecessary
1993
 
                in all of the other examples).
1994
 
           </para>
1995
 
           
1996
 
           <para>
1997
 
                Single Letter Wildcard: to search for "veil" or "vail", use this syntax "v?il". The "?" represents a single character
1998
 
                that could be anything. A more complex example returns both spellings for Isaiah used in the KJV. "?saia?" will return
1999
 
                results for "Isaiah" and "Esaias".
2000
 
           </para>
2001
 
 
2002
 
           <para>
2003
 
                Multiple Letter Wildcard: to search for "prophet" or "prophesy" or "prophecy" or "prophesied", use this syntax "prophe*".
2004
 
           </para>
2005
 
 
2006
 
          <para>
2007
 
                AND syntax: in the advanced search to return results for all of the search terms, you must put "AND" in between the terms.
2008
 
                To continue our example, if we wish to search for any occurrence of Isaiah or Esaias that also mention either prophet, or
2009
 
                prophecy, or prophesy, we can do a search like this: "?saia? AND prophe*". 
2010
 
          </para>
2011
 
 
2012
 
           <para>
2013
 
                By default, two standard search ranges are defined, for Old and New Testament; you may wish to define others for
2014
 
                e.g. "Gospels" or "Paul's Epistles". One custom module list containing only the first Bible found will be present.
2015
 
                If desired, new searches can be performed across only the current results of the previous search.  Any modules may be
2016
 
                searched, including general books and even dictionaries, in any combination.
2017
 
           </para>
2018
 
 
2019
 
           <para>
2020
 
                Note the tooltip in the screenshot above, for Attributes search.  This qualifier is used to perform searches on attributes
2021
 
                that are carried with verses, instead of verse content proper, such as footnote content or Strong's Hebrew and Greek
2022
 
                references.  If this button is selected, specific attribute qualifiers must be made in the Attribute Search tab, at the
2023
 
                right end of the tab set.  Strong's references are identified with a leading "H" or "G" and the numeric Strong's identifier.
2024
 
                Thus, a search of KJV for Strong's Greek #140, using "G140", will return the single result of Matthew 12:18.
2025
 
           </para>
2026
 
                
2027
 
           <para>
2028
 
                If you have indexed your modules, there is a much faster way to search for Strong's references. Enter your search preceded by 
2029
 
                "lemma:", so to search for Strong's Greek #140, enter "lemma:G140". You must have selected <guibutton>Optimized ("Lucene")</guibutton>
2030
 
                for this to work.
2031
 
          </para>
2032
 
 
2033
 
           <para>
2034
 
                The "Find" button also stops an in-progress search, as its tooltip indicates.
2035
 
           </para>
2036
 
 
2037
 
           <para>
2038
 
                Results will show in the <guibutton>Results</guibutton> tab. If you wish to show Strongs, Morphology, or Footnote tags,
2039
 
                make those selections on the <guibutton>Attributes Search</guibutton> tab. Clicking once on the result will show the result
2040
 
                in the <guibutton>Advanced Search</guibutton> previewer. Hovering over Strongs, Morphology, Footnote, or Cross-reference
2041
 
                tags will show the results in the main previewer. Double-clicking a result will cause the current tab to navigate to that
2042
 
                result. This applies to search results in general books and commentaries as well, but note that the respective tab must
2043
 
                be visible.
2044
 
           </para>
2045
 
 
2046
 
           <warning>
2047
 
                <para>
2048
 
                 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.
2049
 
                </para>
2050
 
           </warning>  
2051
 
           </sect2>
2052
 
 
2053
 
        <sect2 id="hdbk-op-search-dialog-text-regexp">
2054
 
                <title>Search Syntax using Regular Expression</title>
2055
 
 
2056
 
                <para>
2057
 
                        Regular expression searches provide a way to do simple or complex searches for strings that match a pattern or set of patterns (branches) separated by vertical bars "|". While a pattern can be built to look for a word or phrase, a simple pattern that consists of a word does not look for only that word but for any place the string of letters that make that word are found. A search for "right" will return verses that contain the word "right", but also "<emphasis>right</emphasis>eous", "<emphasis>right</emphasis>eousness", "un<emphasis>right</emphasis>eous", "up<emphasis>right</emphasis>" and even "b<emphasis>right</emphasis>". A search for "hall not" is not a search for "hall" AND "not" but for the string "hall not" with a space between the second "l" and the "n". The search for "hall not" will find occurrences of "s<emphasis>hall not</emphasis>".
2058
 
                </para>
2059
 
                <para>
2060
 
                        The power of Regular Expressions is in the patterns (or templates) used to define a search. A pattern consists of
2061
 
ordinary characters and some special characters that are used and interpreted by a set of rules. Special characters include
2062
 
.\[^*$?+. Ordinary (or simple) characters are any characters that are not special. The backslash, "\", is used to convert special characters to ordinary and ordinary characters to special.
2063
 
                 </para>
2064
 
                <para>
2065
 
                        Example: the pattern "<emphasis>i. love\.</emphasis>" will find sentences that end with "h<emphasis>i</emphasis>s <emphasis>love</emphasis>" or "<emphasis>i</emphasis>n <emphasis>love</emphasis>" or "<emphasis>i</emphasis>s <emphasis>love</emphasis>" followed by
2066
 
a period. The first period in "i. love\." is a special character that means allow any character in this position. The
2067
 
backslash in "i. love\." means that the period following it is not to be considered a special character, but is
2068
 
an ordinary period. 
2069
 
                </para>
2070
 
 
2071
 
                <sect3 id="hdbk-op-search-dialog-text-regexp-rules">
2072
 
                        <title>Rules for Regular Expression Search Requests</title>
2073
 
                        <itemizedlist>
2074
 
<listitem><para>. The period matches any character.</para></listitem>
2075
 
<listitem><para>* The asterisk matches 0 or more characters of the
2076
 
        preceding: set, character or indicated character.</para></listitem>
2077
 
<listitem><para>+ The plus sign matches 1 or more characters of the
2078
 
        preceding: set, character or indicated character.</para></listitem>
2079
 
<listitem><para>? The question mark matches 0 or 1 character of the
2080
 
        preceding: set, character or indicated character.</para></listitem>
2081
 
<listitem><para>[ ] Square brackets match any one of the characters
2082
 
        specified inside [ ].</para></listitem>
2083
 
<listitem><para>^ A caret as the first character inside [ ] means NOT.</para></listitem>
2084
 
<listitem><para>^ A caret beginning a pattern anchors the beginning of a
2085
 
        line.</para></listitem>
2086
 
<listitem><para>$ A dollar at the end of a pattern anchors the end of a
2087
 
        line.</para></listitem>
2088
 
<listitem><para>| A vertical bar means logical OR.</para></listitem>
2089
 
<listitem><para>( ) Parentheses enclose expressions for grouping.
2090
 
<emphasis>Not supported!</emphasis></para></listitem>
2091
 
<listitem><para>\ A backslash can be used prior to any special character
2092
 
        to match that character.</para></listitem>
2093
 
<listitem><para>\ A backslash can be used prior to an ordinary character
2094
 
        to make it a special character.</para></listitem>
2095
 
</itemizedlist>
2096
 
 
2097
 
<sect4 id="period">
2098
 
<title>The Period</title>
2099
 
 
2100
 
<para>The Period "." will match any single character even
2101
 
a space or other non-alphabet character.
2102
 
<emphasis>s.t</emphasis> matches <emphasis>s</emphasis>i<emphasis>t</emphasis>,
2103
 
<emphasis>s</emphasis>e<emphasis>t</emphasis>,<emphasis> s</emphasis>o<emphasis>t</emphasis>,
2104
 
etc., which could be located in <emphasis>s</emphasis>i<emphasis>t</emphasis>ting,
2105
 
compas<emphasis>s</emphasis>e<emphasis>t</emphasis>h and <emphasis>s</emphasis>o<emphasis>t</emphasis>tish
2106
 
<emphasis>b..t</emphasis> matches <emphasis>b</emphasis>oo<emphasis>t</emphasis>,
2107
 
<emphasis>b</emphasis>oa<emphasis>t</emphasis> and <emphasis>b</emphasis>ea<emphasis>t
2108
 
foot.tool </emphasis>matches <emphasis>foot</emphasis>s<emphasis>tool </emphasis>and
2109
 
<emphasis>foot tool</emphasis></para>
2110
 
</sect4>
2111
 
 
2112
 
 
2113
 
<sect4 id="asterisk">
2114
 
<title>The Asterisk</title>
2115
 
 
2116
 
<para>The asterisk "*" matches zero or more characters of the preceding:
2117
 
set, character or indicated character. Using
2118
 
a period asterisk combination ".*" after a commonly
2119
 
found pattern can cause the search to take a very long time,
2120
 
making the program seem to freeze.
2121
 
<emphasis>be*n</emphasis> matches<emphasis> beeen, been, ben</emphasis>,
2122
 
and <emphasis>bn</emphasis> which could locate Reu<emphasis>ben</emphasis>
2123
 
and She<emphasis>bn</emphasis>a.</para>
2124
 
</sect4>
2125
 
 
2126
 
 
2127
 
<sect4 id="plus">
2128
 
<title>The Plus Sign</title>
2129
 
<para>The Plus Sign "+" matches one or more characters of the preceding:
2130
 
set, character or indicated character. Using
2131
 
a period and plus sign combination ".+" after a
2132
 
commonly found pattern can cause the search to take a very long
2133
 
time, making the program seem to freeze.
2134
 
<emphasis>be+n</emphasis> matches <emphasis>beeen, been</emphasis> and <emphasis>ben</emphasis>,
2135
 
but not <emphasis>bn</emphasis>.</para>
2136
 
</sect4>
2137
 
 
2138
 
 
2139
 
<sect4 id="question">
2140
 
<title>The Question Mark</title>
2141
 
<para>The Question Mark "?"matches zero or one character of the
2142
 
preceding: set, character or indicated character.
2143
 
<emphasis>be?n</emphasis> matches <emphasis>ben</emphasis> and <emphasis>bn</emphasis>
2144
 
but not <emphasis>been</emphasis>.
2145
 
<emphasis>trees?</emphasis> matches <emphasis>trees</emphasis> or <emphasis>tree</emphasis>.</para>
2146
 
</sect4>
2147
 
 
2148
 
 
2149
 
<sect4 id="bracket">
2150
 
<title>The Square Brackets </title>
2151
 
<para>The Square Brackets "[]" enclose a set of characters that can
2152
 
match. The period, asterisk, plus sign and question mark are not
2153
 
special inside the brackets. A minus sign can be used to indicate
2154
 
a range. If you want a caret "^" to be part of the
2155
 
range do not place it first after the left bracket or it will be
2156
 
a special character. To include a "]" in the set make
2157
 
it the first (or second after a special "^") character
2158
 
in the set. To include a minus sign in the set make it the first
2159
 
(or second after a special "^") or last character in
2160
 
the set.
2161
 
<emphasis>s[eia]t</emphasis> matches <emphasis>set</emphasis>, <emphasis>sit</emphasis>,
2162
 
and <emphasis>sat</emphasis>, but not <emphasis>s</emphasis>o<emphasis>t</emphasis>.
2163
 
<emphasis>s[eia]+t </emphasis>matches as above but also, <emphasis>seat,
2164
 
seet, siet</emphasis>, etc.
2165
 
<emphasis>[a-d]</emphasis> matches <emphasis>a, b, c,</emphasis> or <emphasis>d</emphasis>.
2166
 
<emphasis>[A-Z]</emphasis> matches any uppercase letter.
2167
 
[.;:?!] matches ., ;, :, ?, or ! but not a comma.
2168
 
[ ]^-] matches ] or ^ or -</para>
2169
 
</sect4>
2170
 
 
2171
 
 
2172
 
<sect4 id="caret">
2173
 
<title>The Caret first in Square Brackets </title>
2174
 
<para>If the Caret is the first character after the left bracket ("[^") it
2175
 
means NOT.
2176
 
<emphasis>s[^io]t</emphasis> matches <emphasis>set, sat</emphasis>, etc.,
2177
 
but not <emphasis>s</emphasis>i<emphasis>t</emphasis> and <emphasis>s</emphasis>o<emphasis>t</emphasis>.</para>
2178
 
</sect4>
2179
 
 
2180
 
<sect4 id="caret-s">
2181
 
<title>The Caret as Start of Line Anchor </title>
2182
 
<para>If the Caret is the first character in a pattern ("^xxx") it anchors
2183
 
the pattern to the start of a line. Any match must be at the
2184
 
beginning of a line. Because of unfiltered
2185
 
formatting characters in some texts, this feature does not always
2186
 
work, but may if a few periods are placed after the caret to
2187
 
account for the formatting characters.
2188
 
<emphasis>^In the beginning</emphasis> matches lines that
2189
 
start with "<emphasis>In the beginning</emphasis>".
2190
 
(May need to use: <emphasis>^.....In the beginning</emphasis>)</para>
2191
 
</sect4>
2192
 
 
2193
 
 
2194
 
<sect4 id="dollar">
2195
 
<title>The Dollar Sign as End of Line Anchor </title>
2196
 
<para>If the Dollar Sign is the last character ("xxx$") in a pattern it
2197
 
anchors the pattern to the end of a line. Any match must be at
2198
 
the end of a line. Because of unfiltered
2199
 
formatting characters in some texts, this feature does not always
2200
 
work, but may if a few periods are placed before the dollar sign
2201
 
to account for the formatting characters.
2202
 
<emphasis>Amen\.$</emphasis> matches lines that end with
2203
 
"<emphasis>Amen.</emphasis>" (May
2204
 
need to use Amen\....$, Amen\..........$, or even
2205
 
Amen\....................$)</para>
2206
 
</sect4>
2207
 
 
2208
 
 
2209
 
<sect4 id="bar">
2210
 
<title>The Vertical Bar </title>
2211
 
<para>The Vertical Bar "|" between patterns means OR.
2212
 
<emphasis>John|Peter</emphasis> matches <emphasis>John</emphasis> or <emphasis>Peter.
2213
 
John .*Peter|Peter .*John</emphasis> matches <emphasis>John</emphasis>
2214
 
... <emphasis>Peter</emphasis> or <emphasis>Peter</emphasis> ... <emphasis>John</emphasis>.
2215
 
(.* slows a search)
2216
 
<emphasis>pain|suffering|sorrow</emphasis> matches <emphasis>pain</emphasis>,
2217
 
or <emphasis>suffering</emphasis>, or <emphasis>sorrow</emphasis>.</para>
2218
 
</sect4>
2219
 
 
2220
 
 
2221
 
<sect4 id="parenth">
2222
 
<title>The Parentheses</title>
2223
 
<para><emphasis>The use of Parentheses "( )" is
2224
 
not supported!</emphasis></para>
2225
 
</sect4>
2226
 
 
2227
 
 
2228
 
<sect4 id="backslash">
2229
 
<title>The Backslash Prior to a Special Character</title>
2230
 
<para>The Backslash prior to a special character ("\*") indicates that the
2231
 
character is not being used in its special meaning, but is just
2232
 
to match itself.
2233
 
<emphasis>amen\.</emphasis> matches <emphasis>amen.</emphasis> but not <emphasis>amen</emphasis>t
2234
 
and will not locate firm<emphasis>amen</emphasis>t.</para>
2235
 
</sect4>
2236
 
 
2237
 
<sect4 id="backslash-o">
2238
 
<title>The Backslash Prior to an Ordinary Character </title>
2239
 
 
2240
 
<para>The Backslash prior to an ordinary character ("\o") indicates that
2241
 
the character is not being used to match itself, but has special
2242
 
meaning.</para>
2243
 
 
2244
 
<itemizedlist>
2245
 
<listitem><para>
2246
 
\b if use outside [ ] means word boundary. If used inside [ ] means backspace.
2247
 
<emphasis>\brighteous\b</emphasis> matches <emphasis>righteous</emphasis> but
2248
 
not un<emphasis>righteous</emphasis> or <emphasis>righteous</emphasis>ness</para></listitem>
2249
 
<listitem><para>\B means non-word boundary.  <emphasis>\Brighteous\B</emphasis>
2250
 
matches un<emphasis>righteous</emphasis>ness and un<emphasis>righteous</emphasis>ly
2251
 
but not <emphasis>righteous</emphasis>, un<emphasis>righteous</emphasis> or <emphasis>
2252
 
righteous</emphasis>ness.</para></listitem>
2253
 
<listitem><para>\d means digit; same as [0-9].</para></listitem>
2254
 
<listitem><para>\D means non-digit, same as [^0-9].</para></listitem>
2255
 
<listitem><para>\s means space. </para></listitem>
2256
 
<listitem><para>\S means not a space. </para></listitem>
2257
 
<listitem><para>\w means alphanumeric; same as [a-zA-Z0-9_].</para></listitem>
2258
 
<listitem><para>\W means not alphanumeric; same as [^a-zA-Z0-9_].</para></listitem>
2259
 
</itemizedlist>
2260
 
</sect4>
2261
 
</sect3>
2262
 
</sect2>
2263
 
 
2264
 
 
2265
 
  </sect1>
2266
 
 
2267
 
  <!-- Studypad -->
2268
 
  <sect1 id="studypad">
2269
 
    <title>The Studypad</title>
2270
 
    
2271
 
<!-- ============= The Studypad ============================= -->
2272
 
    <sect2 id="xiphos-studypad">
2273
 
                <title>Using The Studypad</title>
2274
 
                <para>
2275
 
                The Studypad can be opened by choosing <guibutton>File-&gt;Open Studypad</guibutton>
2276
 
                </para>
2277
 
                <para>
2278
 
                This is what the Studypad typically looks like:
2279
 
                </para>
2280
 
                <figure>
2281
 
                        <title>The Studypad</title>
2282
 
                        <screenshot> 
2283
 
          <mediaobject> 
2284
 
            <imageobject><imagedata fileref="figures/studypad.png" format="PNG"/> 
2285
 
            </imageobject>
2286
 
            <!-- EPS versions of the figures are not required at the moment. -->
2287
 
            <!-- 
2288
 
                    <imageobject>
2289
 
                <imagedata fileref="figures/studypad.eps" format="EPS"/>
2290
 
                    </imageobject>
2291
 
            -->
2292
 
            <textobject> 
2293
 
              <phrase>The Studypad</phrase> 
2294
 
            </textobject> 
2295
 
          </mediaobject> 
2296
 
        
2297
 
                        </screenshot>
2298
 
 
2299
 
                </figure>
2300
 
                                        
2301
 
                <para> The Studypad will save into your working directory, making it useful for collecting and exporting information and Bible study material from Xiphos into other programmes.</para>
2302
 
                <para> Toolbar 1</para>
2303
 
                                        <itemizedlist>
2304
 
                                        <listitem><para>Font Size and Environment</para></listitem>
2305
 
                                        <listitem><para>Font Type</para></listitem>
2306
 
                                        <listitem><para>Bold, Italics, Underscored, Crossed Out</para></listitem>
2307
 
                                        <listitem><para>Left, Centre and Right  Bound</para></listitem>
2308
 
                                        <listitem><para>Shift Paragraph Right or Left</para></listitem>
2309
 
                                        <listitem><para>Colour Selector</para></listitem>
2310
 
                                        </itemizedlist>
2311
 
                <para> Toolbar 2</para>
2312
 
                                        <itemizedlist>
2313
 
                                        <listitem><para>New, Save, Delete and Print</para></listitem>
2314
 
                                        <listitem><para>Cut, Copy, Paste and Undo</para></listitem>
2315
 
                                        <listitem><para>Find and 'Find and Replace'</para></listitem>
2316
 
                                        <listitem><para>Spellcheck</para></listitem>
2317
 
                                        </itemizedlist>
2318
 
 
2319
 
                <para>
2320
 
                In order for spellcheck to be available, one of the languages
2321
 
                under <guimenuitem>Edit-&gt;Current Languages</guimenuitem>
2322
 
                must be set.
2323
 
                </para>
2324
 
 
2325
 
        </sect2>
2326
 
 
2327
 
 
2328
 
  </sect1>
2329
 
 
2330
 
  <!-- Personal Commentary -->
2331
 
  <sect1 id="personal">
2332
 
    <title>The Personal Commentary</title>
2333
 
    <!-- Personal Commentary-->
2334
 
 
2335
 
                <para>
2336
 
                To build up a personal commentary you will need to install the
2337
 
                editable 'Personal' sword module from the English Commentaries
2338
 
                section. Right click it and choose
2339
 
                <guimenuitem>Edit-&gt;Note-&gt;Personal</guimenuitem>
2340
 
                in the menu.
2341
 
                </para>
2342
 
 
2343
 
                <para>
2344
 
                An editor window similar to the
2345
 
                <guimenuitem>Study Pad</guimenuitem>
2346
 
                will appear. Edit your comment and save it; in the future it will
2347
 
                appear as your comment to the relevant verse.
2348
 
                </para>
2349
 
                <figure>
2350
 
                <title>The Personal Commentary Editor </title>
2351
 
                <screenshot> 
2352
 
                  <mediaobject> 
2353
 
                    <imageobject><imagedata fileref="figures/personal.png" format="PNG"/>
2354
 
                    </imageobject>
2355
 
            <!-- EPS versions of the figures are not required at the moment. -->
2356
 
            <!-- 
2357
 
                    <imageobject>
2358
 
                <imagedata fileref="figures/personal.eps" format="EPS"/>
2359
 
                    </imageobject>
2360
 
            -->
2361
 
                    <textobject> 
2362
 
                      <phrase>The Personal Commentary</phrase> 
2363
 
                    </textobject> 
2364
 
                  </mediaobject> 
2365
 
                </screenshot>
2366
 
                </figure>
2367
 
 
2368
 
                <para>
2369
 
                Locationbar
2370
 
                </para>
2371
 
                        <itemizedlist>
2372
 
                        <listitem><para> Synchronise Button</para></listitem>
2373
 
                        <listitem><para>Bible Book, Chapter and Verse Selectors</para></listitem>
2374
 
                        <listitem><para>Location Summary</para></listitem>
2375
 
                        </itemizedlist>
2376
 
 
2377
 
                <para>
2378
 
                Use the <guimenuitem>Synchronise Button</guimenuitem> to
2379
 
                quickly change location of your editor to that of the
2380
 
                underlying Bibletext or use the
2381
 
                <guimenuitem>Book</guimenuitem>,
2382
 
                <guimenuitem>Chapter</guimenuitem>, and
2383
 
                <guimenuitem>Verse</guimenuitem>
2384
 
                selectors to choose to edit your comment to one particular
2385
 
                verse.
2386
 
                </para>
2387
 
 
2388
 
                <para>Toolbar 1</para>
2389
 
                        <itemizedlist>
2390
 
                        <listitem><para>Font Size and Environment</para></listitem>
2391
 
                        <listitem><para>Font Type</para></listitem>
2392
 
                        <listitem><para>Bold, Italics, Underscored, Crossed Out</para></listitem>
2393
 
                        <listitem><para>Left, Centre and Right  Bound</para></listitem>
2394
 
                        <listitem><para>Shift Paragraph Right or Left</para></listitem>
2395
 
                        <listitem><para>Colour Selector</para></listitem>
2396
 
                        </itemizedlist>
2397
 
                <para>Toolbar 2</para>
2398
 
                        <itemizedlist>
2399
 
                        <listitem><para>Save, Delete and Print</para></listitem>
2400
 
                        <listitem><para>Cut, Copy, Paste and Undo</para></listitem>
2401
 
                        <listitem><para>Find and 'Find and Replace'</para></listitem>
2402
 
                        <listitem><para>Spellcheck</para></listitem>
2403
 
                        </itemizedlist>
2404
 
 
2405
 
                <para>
2406
 
                In order for spellcheck to be available, one of the languages
2407
 
                under <guimenuitem>Edit-&gt;Current Languages</guimenuitem>
2408
 
                must be set.
2409
 
                </para>
2410
 
 
2411
 
                <para>
2412
 
                To create a link to other verses right click the text and
2413
 
                choose <guimenuitem>Link..</guimenuitem>. In the pop-up window
2414
 
                enter the link location and the module linked to.
2415
 
                </para>
2416
 
 
2417
 
                <para>
2418
 
                It is possible to rename a personal commentary to suit a
2419
 
                particular subject of study for that commentary.  Thus,
2420
 
                multiple personal commentaries may be installed: Rename the
2421
 
                existing personal commentary, and then re-install another
2422
 
                instance of the personal commentary if desired.  Personal
2423
 
                commentary names can consist only of letters and digits, and
2424
 
                cannot duplicate an existing module's name.  Rename is
2425
 
                accessible off the right-click menu.
2426
 
                </para>
2427
 
 
2428
 
                <para>
2429
 
                If the study embodied in a particular personal commentary is
2430
 
                no longer needed, archival is available in the module manager,
2431
 
                prior to removal, for possible future re-installation.  See
2432
 
                the module manager's Remove/Archive page.  Any module may be
2433
 
                archived, not just personal commentaries.
2434
 
                </para>
2435
 
 
2436
 
                <para>
2437
 
                Although there are 31,102 verses in standard versification, it
2438
 
                is unlikely that more than a tiny fraction of all verses will
2439
 
                have personal commentary attached to them.  A verse list
2440
 
                showing where personal commentary notes exist is available
2441
 
                from <menuchoice><guisubmenu>Right Click</guisubmenu><guimenuitem>
2442
 
                Dump Pers.Comm.</guimenuitem></menuchoice>.
2443
 
                </para>
2444
 
                                
2445
 
                <tip>
2446
 
                <para>
2447
 
                The created commentary page will be attached to an individual
2448
 
                verse only. To write commentary pages from within
2449
 
                Xiphos, attached to longer stretches of text use the
2450
 
                <guimenuitem>Link..</guimenuitem> function to link several
2451
 
                pages together
2452
 
                </para>
2453
 
                </tip>
2454
 
 
2455
 
  </sect1>
2456
 
 
2457
 
  <!-- Journals and Prayer Lists -->
2458
 
  <sect1 id="journals">
2459
 
    <title>Journals and Prayer Lists</title>
2460
 
    <!-- Journals and Prayer Lists -->
2461
 
 
2462
 
                <para>
2463
 
                <application>Xiphos</application> supports
2464
 
                user-created and -editable modules to contain general
2465
 
                content.  Initially conceived as simple prayer lists,
2466
 
                they have expanded to include daily journals and
2467
 
                topic-outline content.  The user can maintain prayer
2468
 
                lists, or prepare sermons, or write any structured
2469
 
                content desired.
2470
 
                </para>
2471
 
 
2472
 
                <para>
2473
 
                To enable prayer list and journal support, see the
2474
 
                Preferences dialog as previously described.  There, in
2475
 
                <guibutton>General-&gt;Misc</guibutton>, check the
2476
 
                item labeled
2477
 
                <guimenuitem>Enable Prayer Lists</guimenuitem>.
2478
 
                You will see a new item appear at the bottom of the
2479
 
                sidebar's module list for "Prayer Lists/Journals".
2480
 
                </para>
2481
 
 
2482
 
                <para>
2483
 
                Right-click on this entry, and you will be offered a
2484
 
                context menu to create new modules.  All the offered
2485
 
                options are of the same type, but what is offered is a
2486
 
                variety of templates from which to work.  There are 5
2487
 
                templates at this time.
2488
 
                </para>
2489
 
 
2490
 
                <figure>
2491
 
                <title>Creating a journal or prayer list</title>
2492
 
                <screenshot> 
2493
 
                  <mediaobject> 
2494
 
                    <imageobject><imagedata fileref="figures/journal.png" format="PNG"/>
2495
 
                    </imageobject>
2496
 
                    <textobject> 
2497
 
                      <phrase>New journal or prayer list</phrase> 
2498
 
                    </textobject> 
2499
 
                  </mediaobject> 
2500
 
                </screenshot>
2501
 
                </figure>
2502
 
 
2503
 
                <para>
2504
 
                Their structure is the same, but the offered templates
2505
 
                provide a variety of hints regarding ways to organize
2506
 
                content.  <guimenuitem>Simple</guimenuitem> is
2507
 
                trivial, and can be considered a mental Post-It
2508
 
                note.  <guimenuitem>Subject</guimenuitem> is useful as
2509
 
                a more organized version.
2510
 
                <guimenuitem>Monthly</guimenuitem> provides a
2511
 
                per-month structure in which to track needed content.
2512
 
                <guimenuitem>Daily Journal</guimenuitem> is a full
2513
 
                365-day calendar in which to track a personal journal
2514
 
                or ongoing prayer needs.  And finally,
2515
 
                <guimenuitem>Outlined Topic</guimenuitem> is a full,
2516
 
                expandable outline suitable for topics and subtopics.
2517
 
                </para>
2518
 
 
2519
 
                <para>
2520
 
                Journals and prayer lists have the structure of a
2521
 
                general book: If simply selected for display from the
2522
 
                module list, they will appear in the usual subwindow
2523
 
                for general books.
2524
 
                </para>
2525
 
 
2526
 
                <para>
2527
 
                Editing a journal or prayer list is done by
2528
 
                right-clicking the module name to get its context
2529
 
                menu, whose middle item is <guimenuitem>Open in
2530
 
                Editor</guimenuitem>.  The sections and subsections
2531
 
                will be listed in the left margin.  Click one, and the
2532
 
                editor navigates to that section.  The context menu on
2533
 
                right-click of section keys provides for adding,
2534
 
                deleting, and editing the names of sections and
2535
 
                subsections.
2536
 
                </para>
2537
 
 
2538
 
                <para>
2539
 
                If the general book subwindow is currently displaying
2540
 
                the journal or prayer list being edited, it will
2541
 
                synchronize with new content when
2542
 
                <guimenuitem>Save</guimenuitem> is used.
2543
 
                </para>
2544
 
 
2545
 
                <para>
2546
 
                As mentioned, these user-edited modules are in effect
2547
 
                general books.  This means they can be viewed in any
2548
 
                Sword Project application.  Thus, you can use these
2549
 
                modules immediately in
2550
 
                <application>BibleTime</application>, for example; or
2551
 
                from the Module Manager's
2552
 
                <guimenuitem>Maintenance</guimenuitem> page, you can
2553
 
                archive a zip file to copy to a Windows system where
2554
 
                you can then install the zip content as a module for
2555
 
                the Windows user interface.  Few other Sword Project
2556
 
                applications provide for editing these modules,
2557
 
                however, meaning that they will appear in such other
2558
 
                applications as just ordinary general books.
2559
 
                </para>
2560
 
 
2561
 
                <para>
2562
 
                In the future, it is planned that a module sharing
2563
 
                facility will become available, by which user-edited
2564
 
                modules such as these can be uploaded to become
2565
 
                available to a wide audience.  The current install
2566
 
                repository facility will be expanded to provide upload
2567
 
                as well as the existing download capability in order
2568
 
                to support this.  Thus, users will be able to share
2569
 
                their sermons, Bible studies, and other
2570
 
                personally-authored content with other Sword
2571
 
                application users.
2572
 
                </para>
2573
 
 
2574
 
  </sect1>
2575
 
 
2576
 
  <!-- Getting Help Online -->
2577
 
  <sect1 id="onlinehelp">
2578
 
    <title>Getting Help Online</title>
2579
 
    <!-- ============= Online Help  ============--> 
2580
 
 
2581
 
        <sect2 id="xiphos-mailing-list">
2582
 
                <title>Users Mailing List</title>
2583
 
                <para>One way you can get help with Xiphos is using our low-traffic users' mailing list.
2584
 
                You can sign up by clicking <ulink url="https://lists.sourceforge.net/lists/listinfo/gnomesword-users/">
2585
 
                this link</ulink>. Once you are signed up, you can email the list with any problems you are having
2586
 
                and other users or the developers will respond, typically within a day.
2587
 
                </para>
2588
 
        </sect2>
2589
 
 
2590
 
        <sect2 id="xiphos-live-chat">
2591
 
                <title>Live Chat</title>
2592
 
                <para>Another way to get help is with online chat. Xiphos has an IRC channel on freenode, #xiphos.
2593
 
                If you don't know what that means, it's ok. Just click <ulink url="http://webchat.freenode.net/?randomnick=1&amp;channels=xiphos&amp;prompt=1">this link</ulink> (it will open your web browser), type a nickname or accept the default, and click "Click to join chatroom".
2594
 
                This will take you to a chatroom where the developers and other users are available to help you with issues
2595
 
                you may be having. Although many times someone will answer your question immediately, sometimes you may
2596
 
                have to wait a few minutes or longer.
2597
 
                </para>
2598
 
        </sect2>
2599
 
 
2600
 
  </sect1>
2601
 
 
2602
 
  <!-- Original Language Research -->
2603
 
  <sect1 id="originallanguage">
2604
 
     <title>Original Language Research</title>
2605
 
     <!-- ============= Original Language Research  ============--> 
2606
 
 
2607
 
        <sect2 id="orig-lang-install-modules">
2608
 
                <title>Installing Needed Modules</title>
2609
 
                <para>Xiphos is ideally suited for studying the original Greek and Hebrew. 
2610
 
                To get started, you will want the following modules:
2611
 
                </para>
2612
 
                <para>
2613
 
                From Crosswire Repository:
2614
 
                </para>
2615
 
                <itemizedlist>
2616
 
                        <listitem>
2617
 
                                <para>
2618
 
                                StrongsHebrew Dictionary (or get StrongsRealHebrew from the Xiphos Repository)
2619
 
                                </para>
2620
 
                        </listitem>
2621
 
                        <listitem>
2622
 
                                <para>
2623
 
                                StrongsGreek Dictionary (or get StrongsRealGreek from the Xiphos Repository)
2624
 
                                </para>
2625
 
                        </listitem>
2626
 
                        <listitem>
2627
 
                                <para>
2628
 
                                Robinson Dictionary
2629
 
                                </para>
2630
 
                        </listitem>
2631
 
                        <listitem>
2632
 
                                <para>
2633
 
                                KJV Bible
2634
 
                                </para>
2635
 
                        </listitem>
2636
 
                </itemizedlist>
2637
 
                <para>
2638
 
                From Xiphos Repository:
2639
 
                </para>
2640
 
                <itemizedlist>
2641
 
                        <listitem>
2642
 
                                <para>
2643
 
                                StrongsRealGreek Dictionary (same as StrongsGreek, but with Greek characters, B-Greek transliteration, and self-referencing links)
2644
 
                                </para>
2645
 
                        </listitem>
2646
 
                        <listitem>
2647
 
                                <para>
2648
 
                                StrongsRealHebrew Dictionary (same as StrongsHebrew, but with Hebrew characters and self-referencing links)
2649
 
                                </para>
2650
 
                        </listitem>
2651
 
                        <listitem>
2652
 
                                <para>
2653
 
                                InvertedStrongsRealGreek (key in or copy actual Greek word, rather than number)
2654
 
                                </para>
2655
 
                        </listitem>
2656
 
                </itemizedlist>
2657
 
        </sect2>
2658
 
 
2659
 
        <sect2 id="orig-lang-setup">
2660
 
                <title>Setting Up</title>
2661
 
                <para>While still in the module manager, create indexes for all of the modules you just installed. 
2662
 
                Then close the module manager and open <menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>
2663
 
                Preferences</guimenuitem></menuchoice> and go to <menuchoice><guisubmenu>Modules</guisubmenu>
2664
 
                <guimenuitem>Misc</guimenuitem></menuchoice>. Set your Hebrew and Greek lexicons according to what you installed.
2665
 
                Close preferences and open the KJV module. Turn on the module options <menuchoice>
2666
 
                <guisubmenu>Right Click</guisubmenu><guisubmenu>Module Options</guisubmenu><guimenuitem>Show Strongs
2667
 
                </guimenuitem></menuchoice> and <menuchoice><guisubmenu>Right Click</guisubmenu><guisubmenu>Module Options
2668
 
                </guisubmenu><guimenuitem>Show Morphology</guimenuitem></menuchoice>. You should see the Bible text
2669
 
                change to show Strongs numbers underneath the appropriate English words. Hover over the numbers 
2670
 
                (or letters for morphology) with the mouse and you will see the definition displayed in the previewer pane. 
2671
 
                Click on the link and the definition will show in the dictionary pane. If you are using StrongsRealGreek or
2672
 
                StrongsRealHebrew, you can click on any other number referenced in the definition and you will be taken to that entry.
2673
 
                </para>
2674
 
        </sect2>
2675
 
 
2676
 
        <sect2 id="orig-lang-search">
2677
 
                <title>Searching for Strongs Numbers</title>
2678
 
                <para>Choose <menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Advanced Search</guimenuitem></menuchoice>or press
2679
 
                <keycap>F3</keycap>. Under <interface>Search Type</interface>, select <guibutton>Optimized ("Lucene")</guibutton>.
2680
 
                Click on the <interface>Attribute Search</interface> tab, and make check the box that says <guibutton>
2681
 
                Strongs Numbers</guibutton>. Now click in the entry field at the top and search for the number you are looking for
2682
 
                preceded by "lemma:" and "G" for Greek or "H" for Hebrew. So to look for the Hebrew word tsad-deek (6662), enter 
2683
 
                "lemma:H6662". Once the search is done, the results pane will be shown. Notice that when you click on a result, 
2684
 
                it will show the result in the preview pane, and the strong's numbers will show as well, following immediately 
2685
 
                after the words they match. Also note that hovering over these numbers will show the definition in the main preview pane.
2686
 
                </para>
2687
 
        </sect2>
2688
 
        
2689
 
        <sect2 id="orig-lang-additional">
2690
 
                <title>Additional Modules</title>
2691
 
                <para>For more advanced research, the following modules are also available:</para>
2692
 
 
2693
 
                <itemizedlist>
2694
 
                        <listitem>
2695
 
                                <para>   
2696
 
                                2TGreek (Xiphos Repository) : This module contains the entire Bible in Greek. It combines the LXX
2697
 
                                and Tischendorf8 NT into one easy-to-use module. In addition, it contains Strongs, Morphology,Greek Accents,
2698
 
                                and primary/secondary readings. As with all modules that include Strongs, Xiphos displays 2TGreek in 
2699
 
                                beautiful interlinear form.
2700
 
                                </para>
2701
 
                        </listitem>
2702
 
                        <listitem>
2703
 
                                <para>
2704
 
                                Elzevir Textus Receptus (Crosswire Beta Repository as of this writing) : 1624 edition with Strongs and Morphology
2705
 
                                </para>
2706
 
                        </listitem>
2707
 
                        <listitem>
2708
 
                                <para>
2709
 
                                LXX (Crosswire Repository) : the Septuagint with Strongs, Morphology, and footnotes
2710
 
                                </para>
2711
 
                        </listitem>
2712
 
                        <listitem>
2713
 
                                <para>
2714
 
                                MorphGNT (Crosswire Beta Repository as of this writing) : This is derived from the morphologically parsed GNT
2715
 
                                provided by UPenn's CCAT. It was reformatted and error-corrected by James Tauber. It includes Greek accents
2716
 
                                and Morphology.
2717
 
                                </para>
2718
 
                        </listitem>
2719
 
                        <listitem>
2720
 
                                <para>
2721
 
                                TR (Crosswire Repository) : This is the Textus Receptus with Strongs and Morphology
2722
 
                                </para>
2723
 
                        </listitem>
2724
 
                        <listitem>
2725
 
                                <para>
2726
 
                                TischMorph (Xiphos Repository) : As described above, this has Strongs, Morphology, accents, and alternate readings.
2727
 
                                </para>
2728
 
                        </listitem>
2729
 
                        <listitem>
2730
 
                                <para>
2731
 
                                WHNU (Crosswire Repository) : Westcott-Hort of 1881 with Strongs and Morphology
2732
 
                                </para>
2733
 
                        </listitem>
2734
 
                        <listitem>
2735
 
                                <para>
2736
 
                                GreekHebrew (Crosswire Repository) : This is a dictionary keyed to Strongs. It contains words in the LXX 
2737
 
                                that are also found in the New Testament. In addition, it contains the equivalent Hebrew words also keyed
2738
 
                                to Strongs.
2739
 
                                </para>
2740
 
                        </listitem>
2741
 
                        <listitem>
2742
 
                                <para>
2743
 
                                Didache (Crosswire Beta Repository as of this writing) : This is an early Christian treatise in Greek dated
2744
 
                                to the late first or early second century. It includes Strongs, Morphology, and Greek accents.
2745
 
                                </para>
2746
 
                        </listitem>
2747
 
                </itemizedlist>
2748
 
        </sect2>
2749
 
 
2750
 
 
2751
 
  </sect1>
2752
 
 
2753
 
</article>