# Xiphos راهنما

زیفوس برنامه‏ای است که به منظور کمک رسانی در مطالعۀ کتاب‏مقدس تهیه شده است.

2003
2009
تیم زیفوس
تیم زیفوس

## GNU General Public License

Version 2, June 1991
1989, 1991
Free Software Foundation, Inc.

    Free Software Foundation, Inc.
              51 Franklin Street, Fifth Floor,
              Boston, MA 02110-1301
              USA

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Version 2, June 1991

## GNU General Public License

### Preamble

The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software - to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too.

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.

To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.

For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.

We protect your rights with two steps:

1. copyright the software, and

2. offer you this license which gives you legal permission to copy, distribute and/or modify the software.

Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.

Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.

The precise terms and conditions for copying, distribution and modification follow.

### TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

#### Section 0

This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The Program, below, refers to any such program or work, and a work based on the Program means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term modification.) Each licensee is addressed as you.

Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.

#### Section 1

You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.

You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.

#### Section 2

You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:

1. You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.

2. You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.

3. If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: If the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program.

In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.

#### Section 3

You may copy and distribute the Program (or a work based on it, under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:

1. Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,

2. Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,

3. Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.)

The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.

If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.

#### Section 4

You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.

#### Section 5

You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.

#### Section 6

Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License.

#### Section 7

If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program.

If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.

It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.

This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.

#### Section 8

If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.

#### Section 9

The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and any later version, you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.

#### Section 10

If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.

#### NO WARRANTY Section 11

BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

#### Section 12

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

END OF TERMS AND CONDITIONS

### How to Apply These Terms to Your New Programs

If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.

To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the copyright line and a pointer to where the full notice is found.

<one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

Also add information on how to contact you by electronic and paper mail.

If the program is interactive, make it output a short notice like this when it starts in an interactive mode:

Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type show w. This is free software, and you are welcome to redistribute it under certain conditions; type show c for details.

The hypothetical commands show w and show c should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than show w and show c; they could even be mouse-clicks or menu items--whatever suits your program.

You should also get your employer (if you work as a programmer) or your school, if any, to sign a copyright disclaimer for the program, if necessary. Here is a sample; alter the names:

Yoyodyne, Inc., hereby disclaims all copyright interest in the program Gnomovision (which makes passes at compilers) written by James Hacker.

<signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice

This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License.

اندی
پایپر
پیر
بنز
دکتر پیتر
فن کاهن
کارل
کلاین‏پیست
متیو
تالبرت
Dominique
Corbex
Xiphos Development team
French translation
This manual describes version 3.1.2 of Xiphos.
Xiphos Manual V3.1.2
August 2009

تیم زیفوس

تیم زیفوس

## پیشنهادات و نظرات شما

برای گزارش هر گونه ایراد و یا ارائۀ پیشنهاداتتان در ارتباط با نرم‏افزار زیفوس و یا این کتابچه، لطفا روی لینک زیر کلیک بفرمایید:

گنوم
زیفوس
سورد
کراس وایر
هلپ دایالوگ

## مقدمه

زیفوس ابزاری برای مطالعۀ کتاب‏مقدّس است که بر پایۀ "SWORD Project" کتابخانه‏های جی‏ان‏او‏ام‏ای بنا شده است. برنامۀ زیفوس را می‏توانید برای موارد زیر بکار ببرید:

- مشاهدۀ آیات مورد علاقه

- یادداشتهای موعظه و یادداشتهای شخصی خود را در مورد آیات مورد نظر می‏توانید تایپ کنید

- بصورت اتوماتیک پانویس‏های کتاب‏مقدس و سایر کتب مرجع را دنبال کنید

- ترجمه‏های گوناگون را بصورت موازی مقایسه کنید

- با بهره برداری از متون عبری و یونانی روی زبان‏های اصلی کتاب‏مقدس کارهای مطالعاتی و تحقیقاتی انجام دهید

زیفوس این را هدف خود قرار داده است که یک محیط کاری ساده در اختیار کاربران قرار دهد، در عین حال با در اختیار قرار دادن ابزاری بسیار قوی به کاربر اجازه دهد که کارهای مطالعاتی-تحقیقاتی خود را بر روی کتاب‏مقدّس انجام دهد.

### علامت انحصاری پروژۀ شمشیر

علامت انحصاری پروژۀ شمشیر

"پروژۀ شمشیر" بر مبنای http://www.crosswire.org است. سایر برنامه‏هایی که تحت همان علامت هستند، شامل پروژۀ شمشیر برای ویندوز (aka BibleCS or WinSword), مک‏سورد برای کامپیوترهای مک‏اینتاش, بایبل دسکتاپ, که یک برنامۀ جاوا است, و بایبل تایم, که یک برنامۀ دیگر قابل اجرا تحت لینوکس است، می‏باشند.

### زیفوس در حال اجرا می‏باشد

زیفوس در حال اجرا می‏باشد

زیفوس در حال حاضر تحت گسترش است، به همین دلیل ممکن است در بخشی از برنامه مشکلاتی به چشمتان بخورد، که در اینصورت لطفاً آن مورد را از لینک زیر به ما اطلاع دهید وب‏سایت پروژه، یا ایمیل xiphos-developers@lists.sourceforge.net. از هرگونه راهنمایی و کمک شما پیشاپیش سپاسگزاریم

## شروع به استفاده از زیفوس

### زیفوس در حال بارگذاری

شما می‏توانید برنامۀ زیفوس را به یکی از روش‏های زیر اجرا نمایید:

فهرست برنامه‏ها

  گزینۀ لوازم را برگزینید و سپس به راهنمای زیفوس کتاب‏مقدس بروید.

خط فرمان

  عبارت `زیفوس`, را وارد نموده، سپس کلید اینتررا بزنید.

پنجره‏ها

  گزینۀ تمام برنامه‏ها زیفوس زیفوسرا برگزیند.

### شروع برنامۀ زیفوس برای اولین مرتبه

هنگامی کهبرنامۀ زیفوس را برای اولین مرتبه باز می‏کنید،زیفوس یک‏سری گزینه‏های قراردادی ایجاد می‏کند. همچنین، چنانچه در گذشته برنامۀ دیگری از سری سورد اجرا شده باشد، ولی با این وجود هیچ مدول کتاب‏مقدس نصب نشده باشد، در آنصورت زیفوس از شما اجازه خواهد خواست تا برنامۀ مدیر مدول را اجرا نماید که به کمک آن شما می‏توانید یک مدول کتاب‏مقدس را به زبانی که بیشتر آنرا ترجیح می‏دهید، نصب کنید.

#### پرسش‏های مرتبط با دانلود کردن زیفوس

پرسش‏های مرتبط با دانلود کردن زیفوس

زیفوس در ابتدای اجرای آن یک محیط کاری دارای یک برگه باز می‏کند، که در آن آیۀ رومیان 8: 28 به چشم می‏خورد. کاربر در این محیط کاری، می‏تواند در بخش ویرایش فرمان ترجیحات را برگزیند و بدینوسیله تغییرات دلخواه را در قسمت‏هایی که بصورت اتوماتیک ایجاد شده‏اند، بدهد.

### بارگذاری زیفوس

هر زمان که برنامۀ زیفوسرا باز کنید، محیط کاری زیر را مشاهده خواهید کرد:

#### محیط کاری زیفوس

محیط کاری زیفوس

محیط کاری زیفوسدارای عناصر زیر می‏باشد.

خط فرمان

  خط فرمان دارای چند فرمان است که کاربردزیفوسرا گسترش می‏بخشد. این فرامین شامل محلی برای یادداشت‏های مطالعه و نیز توابع جستجوی پیشرفته می‏باشد. فرامی همچنین به شما کمک می‏کنند تا بتوانید استفاده از برنامۀ زیفوس را بسیار شخصی و به دلخواه خود بنمایید.

ستون ابزار

  ستونابزارشامل کلیدهایی است که به شما کمک می‏کند تا به سرعت و سهولت بتوانید از کتاب‏مقدس استفاده نمایید.

ستون جانبی

  ستونجانبیدستیابی به چندین کاربرد اساسی را ممکن می‏سازذ. این ستون شامل تمام علائم و نیز لیست کتابهایی است که نصب کرده‏اید. این ابزار همچنین برای جستجوهای ساده نیز قابل استفاده است.

چارچوب متن کتاب‏مقدس

  چارچوبمتن کتاب‏مقدسمتن کتاب‏مقدسی را که باز دارید نشان می‏دهد.

پیش‏نگر

  فرمان پیش‏نگرگزینه‏های مدول متن کتاب‏مقدس را نشان می‏دهد. این شامل اعداد مرتبط با کشف‏الآیات استرانگ، پانویس‏ها و نیز علائم زبان‏شناسی می‏باشند. این فرمان در زیر چاچوب متن کتاب‏مقدس قرار دارد.

چارچوب تفاسیر

  فرمانچارچوب تفسیرکتابهای تفسیری را که در مرتبط با متن کتاب‏مقدس در حال استفاده است، نشان می‏دهد.

چارچوب کتاب

  فرمان چارچوب کتابکتابهای عمومی را که از طریق سورد در اختیار کاربر قرار دارند، نشان می‏دهد. این شامل مدول‏هایی از قبیل کتابهایی چون: "قوانین کالوین", "ژوزفوس: سری کامل نوشتجات " و غیره. این چارچوب را می‏توان از طریق فرمان مشاهدۀ مرور کتاب که در زیر فرمان چارچوب تفسیر است مورد استفاده قرار داد.

چارچوب فرهنگ واژه‏ها/کتاب

  گزینه دیکشنری تعریف واژه های برگزیده شده را نشان می دهد در در بخش متن کتاب مقدس. نشان می دهد این گزینه پس از گزینه تفسیر قرار دارد.

هنگامی که شما در محیط‏های کاری گوناگون روی ماوس رایت‏کلیک بکنید، یک صفحۀ جدید در آن محیط کاری باز خواهد شد، که به شما گزینه‏های بیشتری خواهد داد، شامل کنترل‏های صفحۀ نمایش و خدمات چاپ.

## محیط کاری

### خط فرمان

در بخش بالایی برنامۀزیفوسخط فرمان قرار دارد.تقریباً تمامی کاربردها توسط انتخاب منوی درست اجرا می‏شوند. این کابردها بسته به نوع کاری که انجام می‏دهند گروه‏بندی شده‏اند. بعنوان نمونه، گروه فرامین کاربردی مرتبط با فایل، زیر فرمانپروندهدسته‏بندی شده‏اند.

#### خط فرمان

خط فرمان زیفوس

### ستون‏فرمان

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.کاربرد ستون ابزار اینست که کنترل‏های مربویط به چارچوب‏های کتاب‏مقدس و تفسیر را فراهم نماید. با حرکت دادن نشانگر ماوس بر روی دکمۀ ابزار مورد نظرتان و انتخاب آن، این گزینه فعال خواهد شد. اگر نشانگر ماوس را برای چند لحظه بر روی ابزار نگاه دارید، یک راهنمای کوچک باز خواهد شد که کاربرد آن کلید را توضیح خواهد داد.

#### ابزار

ابزار

گزینۀ ابزارشامل کاربردهای زیر است:

- تاریخچه مرور انتخاب و لیست

- انتخاب بخشی از کتاب‏مقدس

- انتخاب فصلی از کتاب‏مقدس

- انتخاب آیه‏ای از کتاب‏مقدس

- خلاصۀ بخش بخصوصی از کتاب‏مقدس

#### انتخاب کردن تاریخچۀ پیشین/پسین

حرکت بین قسمت برگزیده شدۀ فعلی و پیشین.

#### انتخاب بخشی از کتاب‏مقدس

این فرمان یک کتاب از کتاب‏مقدس را که مایل هستید در بخش چارچوب متن کتاب‏مقدس و چارچوب تفسیرنشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.

#### انتخاب فصلی از کتاب‏مقدس

این فرمان فصلی از کتاب‏مقدس را که مایل هستید در بخش چارچوب متن کتاب‏مقدس و چارچوب تفسیرنشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.

#### انتخاب آیه‏ای از کتاب‏مقدس

این فرمان یک آیه از کتاب‏مقدس را که مایل هستید در بخش چارچوب متن کتاب‏مقدس و چارچوب تفسیرنشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.

#### خلاصۀ بخش بخصوصی از کتاب‏مقدس

Allows manual editing of passages which are displayed in the Bible Text Pane and Commentary Pane. Changes take effect once Enter is typed.این فرمان، اجازه می‏دهد که شما قسمتهایی را که مایل هستید در بخش چارچوب متن کتاب‏مقدس و چارچوب تفسیرویرایش کنید. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.

لطفا اطمینان حاصل کنید که کتاب، فصل، و یا آیه‏ای که آنرا ویرایش کرده‏اید به درستی نامگذاری شده است، در غیر اینصورت اطلاعات اشتباه نمایش داده خواهد شد.

### ابزار جانبی

#### ستون جانبی

ابزار جانبی

On the left hand side of Xiphos there is the Sidebar. Here the user can switch between the different Sword modules, view bookmarks, do simple searches and view verse lists. To switch between all Sidebar functions, buttons have been placed at the top of the Sidebar.

#### میان‏بر به ابزار جانبی

میان‏بر به ابزار جانبی

### چارچوب متن کتاب‏مقدس

#### چارچوب متن کتاب‏مقدس

چارچوب متن کتاب‏مقدس

در سمت راست ستون شورت‏کات‏ها، چارچوب متن کتاب‏مقدس قرار دارد. تمام ترجمه‏های گوناگونی که شما دارید در این قسمت نشان داده می‏شوند. هنگامی که برنامۀ زیفوسرا باز می‏کنید، بصورت اتوماتیک یا کتاب‏مقدس استاندارد شما و یا آخرین کتاب‏مقدسی که باز کرده بودید، بر روی این صفحه باز خواهد شد.

#### باز کردن ترجمۀ خاصی از کتاب‏مقدس

به منظور تعویض ترجمۀ فعلی کتاب‏مقدس به یکی دیگر از ترجمه‏ها:

- بر روی چارچوب متن کتاب‏مقدسرایت‏کلیک کنید. از صفحۀ فهرستی که باز شد، گزینۀ پرونده بازکردن مدولرا برگزینید و سپس ترجمه‏ای را دوست دارید، استفاده کنید، باز نمایید.

- زیر عنوان مدول‏ها،در بخش ستون جانبی،گزینۀمتون کتابمقدس،زبان مورد علاقه، و ترجمۀ خاصی را که دوست دارید، می‏توانید انتخاب کنید.

#### استفاده از کاربرد موازی

A nice function in Xiphos is the ability to view your specified bible text in five parallel translations of your choice. The Parallel View mode can be accessed by selecting Parallel View just below the Bible Text Pane, next to the Standard View tab. Please note that you 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 that modules that are Old Testament or New Testament only (eg Westminster Leningrad Codex and Byzantine Majority Text ) will not be able to display books, chapters, or verses that they don't have.

##### چارچوب متن کتاب‏مقدس- نگرش موازی

چارچوب متن کتاب‏مقدس- نگرش موازی

Additionally, a separate Parallel View window can be selected from the right click menu with Detach/Attach. Your Bible pane will return to its normal single text view, and the new Parallel View window will show the complete chapter, in all 5 translations.

##### نگرش موازی - پنجره‏ای دیگر

نگرش موازی - پنجره‏ای دیگر

#### ترجمۀ دیگری از کتاب‏مقدس را باز می‏کند

به منظور مشاهدۀ یک ترجمۀ دیگری از کتاب‏مقدس از ترجمه‏های موجود در محیط کاریزیفوس:

- Under the Modules option in the Sidebar,choose Biblical Texts language choice. Then right-click on a translation and choose the Open in dialog option.

#### Finding Out About The Current Translation

To find out about the Bible translation currently being displayed:

- right-click in the Bible Text pane. In the popup menu choose About module name.

- تحت مدول‏هایموجود درستون جانبی،گزینۀمتون کتاب‏مقدس گزینۀ زبان‏هارا برگزینید. سپس روی یک ترجمه کلیک سمت راست ماوس را فشار دهید و در این قسمت گزینۀدر بارۀرا برگزینید.

#### گزینه‏های مدول

Most Bible translations have additional options which the user can select.

- کلمات عیسی مسیح به رنگ قرمز

- شماره‏های کشف‏الآیات استرانگ

- علائم واژه‏شناسی

- پانویس‏ها

- ارجاعات به کتاب‏مقدس

- سر تیترها

- محتویات تصویر

Translations in other languages such as Greek or Hebrew have specific options which deal only with the specific language.

به منظور دستیابی به این گزینه‏ها:

- روی ماوس رایت کلیک کنید،چارچوب متن کتابمقدس باز خواهد شد.در منویی که باز خواهد شد (مانند نمونۀ زیر)،گزینۀ مدولرا انتخاب و کاربرد مورد نظر را علامت گذاری کنید.

##### گزینه‏های مدول

گزینه‏های مدول

#### گزینه‏های مرور

There are several additional modes that can be selected from the menubar's View pulldown.

##### گزینه‏های مرور

گزینه‏های مرور

The first 4 checkboxes control whether each named subwindow is displayed. The viewable state of the subwindows is remembered on a per-tab basis. This makes it possible, for example, to have a tab dedicated to a maps module alone (in a dictionary module, having alphabetically-listed places), by turning off the display of Bible, Previewer, and Commentary for that tab.

The remaining checkboxes control these other display features:

- Verse Style - Toggles between Bible text display in separate verses, or in paragraphs instead. This is set on a per-module basis.

- Link Tabs - When more than one tab is open, each one's verse is navigated separately in the disabled case. If tab linking is enabled, then all tabs navigate together, keeping all translations on the same verse.

- Read Aloud - If you enable this, then Xiphos will funnel all selected verses through the festival text-to-speech system. Festival is a widely-available TTS, often installed by default in Linux distributions. Reading aloud is not currently supported on Windows.

  Also, mouse-selected text may be read aloud from Bibles, commentaries, and general books, using the right-click menu, regardless of whether Read Aloud is selected.

- Show Verse Numbers - Normally enabled, this toggle can be disabled to prevent display of verse numbers within the text.

- Highlight Current Verse - Initially disabled, this toggle replaces mere alternate colorization of the current verse with a substitute high-contrast highlight. The colors used may be selected from the Preferences dialog.

#### User Annotation

Many users wish to make personal annotations on individual verses, without the need to put a full "personal commentary" module to use. Xiphos provides this in the right-click context menu in the Bible pane. This brings up a dialog showing the current verse reference and offering a text box into which to enter a brief personal note. Once the user closes the dialog with "Mark," the verse will be displayed in reverse-highlight (default, blue on yellow) and a marker *u will be inserted at the verse's beginning. This is metaphorically similar for users who mark verses in paper Bibles with a yellow highlighter and write personal notes in the margins.

Selecting an already-annotated verse will (in the usual case) bring up the existing content for re-editing. An already-annotated verse can be unmarked; the verse will cease to show in reverse-highlight.

If the user deletes the module name from the reference at the top of the dialog, then the annotation will apply to any Bible module at the selected verse. However, in this case, re-selecting the annotated verse will not initialize with the existing content, because the dialog is created based on the specific module reference.

#### Geography Support

A connection to browsing BibleMap.org is available by mouse-selecting a place name in any text. Use the right-click context menu to select Lookup Selection Browse in BibleMap.org. A web browser will be brought up to show the selected name's geography via BibleMap, which provides Biblical detail overlaid on a Google Maps interface.

#### Specific Word Meanings

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 explanation should be displayed, if available, in the Dictionary Pane.

#### Finding A Specific Word

To find a specific word within a passage:

- right-click in the Bible Text Pane. In the popup menu, choose Edit-> Find. A separate dialog will appear, which provides text searches. Fill out dialog and click the Find and Find Next buttons.

### پیش‏نگر

#### PreViewer

پیش‏نگر

The Previewer is where the user sees Strong's numbers, morphological tags, footnotes, and cross-references that the Bible Text Pane provides.

Footnote content is displayed in the Previewer when you hover over the indicator *n in the Bible text; it remains visible until your mouse moves over another indicator, Strong's number, etc. Sometimes you may want the text to 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 that you can scroll it in the Previewer, middle-click the indicator (or hold down the Shift key) and move to the Previewer.

Cross-reference indicators *x work much the same way. Clicking the indicator will send the set of references to the Verse List in the Sidebar, where you can click them individually for reading in the Previewer.

Any verses shown in reverse-highlight have personal annotation associated with them, and such verses will include *u at the beginning of the verse. Hovering on this marker will show the annotation in the previewer, just as for publisher's footnotes.

If a devotional has been set via the Preferences dialog, then the day's devotional reference will also appear in the previewer, either on program startup or when the user requests it via the View menu.

### The Commentary Pane

#### The Commentary Pane

چارچوب تفاسیر

The Commentary pane is where the commentary modules are displayed. This provides easy reading, reference, and access to different commentaries currently installed. The passage viewed by the Commentary pane is directly controlled by the current passage viewed in the Bible Text pane, so in order to change to a different passage commentary, select the desired passage on the Toolbar.

If there are images that are part of a commentary, general book, or dictionary/lexicon, they may be clicked to invoke a viewer on that single image, in order to get a better view. This is particularly useful if image resizing has been enabled with the result that images are made very small in the subwindow.

By changing to passage settings on the Toolbar, the contents in the Bible Text pane and the Commentary Pane will be changed.

#### Finding Out About The Commentary Module

To find out about the commentary currently being displayed:

- right-click in the Commentary Pane. In the popup menu choose About module name.

#### Commentary Headings.

Many commentaries have additional headings which enable introductory information about the book and chapter currently being displayed in the Bible Text pane. In order to view them:

- right-click in the Commentary Pane. In the popup menu choose Display Book Heading or Display Chapter Heading.

### Dictionary Pane

#### The Dictionary Pane

The Dictionary Pane

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.

### Keyboard Shortcuts

Several keyboard shortcuts exist in Xiphos:

- F1: opens this manual.

- F2: opens the Preferences dialog.

- F3: opens Advanced Search.

- F4: opens the Module Manager.

- Ctrl-L focuses and selects the main verse navbar text. You can then immediately type in new verse selection text. Be aware that, as is the case with most Sword applications, Xiphos understands many abbreviations: "G" is adequate to specify Genesis, for example, and any book name by itself implies 1:1.

- Ctrl-F opens the "Find" dialog. The subwindow to which it applies depends on which of them are visible: The Bible is first preference, then the commentary or general book, then the dictionary. So a tab can be dedicated to just a genbook, and Ctrl-F will perform "Find" within that pane.

- Alt-C brings the Commentary View forward when previously obscured by the Book View.

- Alt-G is the opposite of Alt-C, focusing on the general book.

- Alt-B opens a bookmark dialog on the current verse.

- Alt-D focuses on the dictionary navbar text.

- Alt-P detaches/re-attaches the parallel view dialog.

- Alt-Z opens the personal commentary editor.

- Ctrl-Plus/Ctrl-Minus increases/decreases the base font size.

- Location bar navigation:

  - Ctrl-p/Ctrl-n: Verse previous/next.

  - p/n: Chapter previous/next.

  - P/N: Book previous/next.

### Version Differences in Xiphos's Display

The Xiphos interface has evolved over time, and there are two display libraries with which Xiphos can be built. The older, less featureful version is called "gtkhtml3", and the newer, more capable version is called "MozEmbed". Both of these display libraries render text in a browser-like fashion, using HTML constructs to control display.

Several desirable capabilities are unsupportable in gtkhtml3, and although recent Xiphos is written to take advantage of MozEmbed features, it is possible that the version running on your computer needed to be built with gtkhtml3 instead, either because the version of MozEmbed available for your system is not recent enough to support the needs of Xiphos, or it simply doesn't exist for your system. (Mozembed is not supported under Windows at this time.) The following differences will be apparent, depending on whether gtkhtml3 or MozEmbed is the underlying display engine:

- Morphology and Strong's references, enabled via the right-click menu in some modules, are displayed inline with gtkhtml3; with MozEmbed, a blocked display is used, where these references are aligned beneath the word to which they refer, for a much more readable, less cluttered display.

- Footnote and cross-reference markers (*n, *x) are displayed as proper superscripts in MozEmbed, but not in gtkhtml3.

- Links in gtkhtml3 are necessarily both colored and underlined; in MozEmbed, no underlines are needed.

- Under MozEmbed, double-space display is available using the View menu, but not under gtkhtml3.

- It is not possible for gtkhtml3 to interpret multiple font face directives in a single window, so the gtkhtml3 detached parallel view window cannot provide per-module font selections. Also, modules' internal font requests are ignored in any gtkhtml3 window.

Using the "About Xiphos" selection under the Help menu, you will see the display library with which Xiphos was built.

#### Comparison, gtkhtml3 -vs- mozembed

Comparison, gtkhtml3 -vs- mozembed

## Preferences

### Introduction To Preferences

#### The Preference Dialog

The Preferences Dialog

### Fonts And Colors

#### Setting Font Colors

##### Font Colour Settings

Font Colour Settings

#### Miscellaneous Font Settings

##### Miscellaneous Font Settings

Miscellaneous Font Settings

In individual modules' display, the right-click menu's Module Options selector provides font name and size selection.

The base font size is the size initially chosen for all modules displayed by Xiphos. The verse number and individual modules' font size choices are relative to the base font size.

### General Settings

#### Tabs and Pane Settings

##### Tab and Pane Settings

Tab and Pane Settings

#### General Preferences and StudyPad directory

##### General Preferences and StudyPad directory

General Preferences and StudyPad directory

Certain dictionary-style modules are Daily Devotionals whose keys are numerically in the form "Month.Day". If you have such a module installed and it has been selected as your preferred devotional, then you can ask that Xiphos display today's selection during startup.

Verse style indicates that each verse should begin on a separate line, or (when disabled) that verses should be allowed to group in paragraphs, according to the Bible module's internal markup. Not all Bible modules have such markup.

With Scroll to Previous/Next Chapter enabled, using the mouse to scroll to the beginning or end of a chapter will cause Xiphos to move automatically to the appropriate chapter.

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

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

### Module Settings

#### Main Module Settings

##### The Module Preferences Dialog

The Module Preferences Dialog

##### Parallel Preferences

Parallel Preferences

##### Various preferences Modules

Various Preferences Modules

## Module Manager

### Introduction To The Module Manager

The "module" is the unit of content in Xiphos, and Sword generally; a Sword module is a resource available for viewing in Sword applications. There are several varieties: Most importantly, Bible texts, as well as dictionaries and lexicons, commentaries, and general books, any of which may include image content (e.g. atlases). They are installed either from a local directory structure (typically on removable media, such as a CDROM distribution) or remotely via ftp from a repository such as Crosswire, which is the home of Sword, and from which all officially Sword-sanctioned modules are available. Also, many other modules are available from non-Crosswire repositories.

If you have other Sword applications installed, they will all share the same set of Sword modules that you install through the Module Manager.

#### The Module Manager Dialog

The Module Manager Dialog

### Sword Module Configurations

#### Module Sources Settings

##### Module Sources Settings

Module Installation

There are other repositories available besides CrossWire's own, though the modules available from other repositories do not represent content officially sanctioned by Crosswire. On the web, see this page for list of those repositories known: http://www.crosswire.org/wiki/Module_Repositories

The list of standard repositories is maintained at CrossWire. Xiphos normally auto-synchronizes with that list one time, when the user first puts the Module Manager to use. The list may change, as new repositories come into existence; occasional re-synchronization with the list is suggested, which is accomplished by clicking the Load Standard.

#### Sword Module Installations

##### Sword Module Installations

Module Installation

After you have selected your Install Source, click the Refresh button to cause Xiphos to find the module summary available from that source before moving on.

Take note of the "Install Destination". In most cases, you will have a choice of a personal area or a system area. The details vary according to your operating system.

##### Linux

Unless you run as root (via su or sudo) you will only be able to install in your personal area, under ~/.sword. If you run as root, or change permissions on the shared directory, you will also be able to install modules for all users, typically in /usr/share/sword. There have been some requests for Xiphos to provide a means by which an ordinary (non-root) user could start the program, gain temporary write access to the system area while installing modules, and then revoke that access after installation is complete. Attempting to devise a scheme to do this has proven quite difficult, given the different superuser management schemes employed by various Linux distributions. Therefore, at this time there are no ongoing plans to try to solve this problem, and users are advised to enable write access to the system area outside Xiphos.

##### Windows XP

You may install modules to a shared folder so the modules are available to all users. If you have previously used "The Sword Project for Windows", this folder will be "C:\Program Files\Crosswire\The Sword Project\Sword". Otherwise it will be "C:\Documents and Settings\All Users\Application Data\Sword". You may also install modules to a location that can only be seen by you. This location is "C:\Documents and Settings\YOUR NAME\Application Data\Sword".

##### Windows Vista

Vista works much the same as XP, except for the locations. The private location is "C:\Users\YOUR NAME\AppData\Roaming\Sword". The shared location is "C:\ProgramData\Sword".

### Installing, Updating, and Maintaining Modules

#### Installing, Updating, and Maintaining Modules

##### Installing and Updating Modules

Module Installation

The module manager generates both a per-type module list as well as a parallel availability list. The latter is 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 time. Modules which are either not yet installed or updated beyond what is currently installed will appear in both lists.

Modules that are already installed will show a checkmark beside them. If a fast search ("lucene") index is available, a magnifying glass will be displayed, otherwise an "X" will be shown; creation of the index is available on the Maintenance pane. Locked modules, which require that you 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 version is available, a refresh icon will appear between the differing old and new version stamps. There may be an approximate size displayed, if the repository management provides this information, otherwise a question mark ("-?-") will be shown.

Select new modules to be installed by clicking the checkboxes and then the Install button at the bottom. Any number of modules may be requested for installation at one time.

If you acquire a locked module and have obtained the cipher key for it, the module is then unlocked in the main window: Open the module, which will probably appear blank, then using the right-click context menu, choose "Unlock This Module."

#### Module Maintenance

##### Module Maintenance

Module Maintenance

Several maintenance functions are available: Removal, archival, index, and index deletion.

Removal disposes of a module entirely. There is no recovery of the module unless you have previously archived a copy of it.

Archival is available for any module, although it is provided with personal commentaries specifically in mind. A *.zip of the module is left in the directory ~/.sword/zip. Archival prior to removal of personal commentaries is recommended, in order to be available for future re-install if the subject matter of the personal commentary becomes important again.

Indexing is provided so that the underlying Sword search support can create the index needed for the "lucene" multi-word fast-search functions. If the index is not created, multi-word search will still be available, but it will be much slower. With the index in place, searches through an entire Bible can take just a few seconds.

Indexes may be deleted as well.

### Installing Non-Standard Modules

Some resource modules in Sword Project format are available from sources other than Crosswire and not from a module manager-ready repository. Necessarily, installing such a module is a manual task.

Modules are normally packaged as *.zip files; they contain a configuration file plus a number of data files. Installation of such a module is done by cd'ing to your personal Sword (not Xiphos) configuration directory, ~/.sword, and unzipping the file there. The configuration file will be left in "mods.d", and the module's data files will go into a subdirectory of "modules". Alternatively, if you have write access to the system Sword directory, typically /usr/share/sword, you may cd there instead before unzipping.

Restart Xiphos after installing such a module, so that a fresh instance of the program can notice the new module in place.

## The Search Function

### Simple Searches

To conduct a quick search within the current Bible or commentary module, the Search Bar in the Sidebar should usually be adequate. Click either in the menu bar Edit->Search or in the Sidebar Modules->Search to access it.

#### The Search Bar

The Search Bar

The Search Dialog consists of the following parts:

- Search Key Entry box

- Search Module Selector

- Search Type Selector

- Search Options Checkbox

- Search Scope Selector

- Search Results View

#### Search Key Entry Box

Allows entry of the key for which you would like to search. The search key can be a word, part of a word, several words, a phrase, or a regular expression depending on the type of search selected. When the search key is entered and all other selections in the search dialog are complete, click the Find button to begin the search.

This search uses the optimized search method (see next section) if the module has previously been indexed, and will use AND semantics by default (verses must contain all words you entered).

#### Search Module Selector

Allows selection of which modules you would like to search. Select Bible to search Bible versions or Commentary to search commentaries. Only the currently active module will be searched.

#### Search Type Selector

Allows selection of the type of search. There are three search types available:

Multi word

  This type will match any verse that has all the words in the search key, regardless of where they appear in the verse.

Regular expression

  This search uses a regular expression as a search key. A regular expression is a pattern used to match a string of text. A regular expression can be used to find verses with words that match a particular pattern. For example the regular expression `[a-z]*iah` will match verses that contain the words Aiah, Ahaziah, Athaliah and Amariah.

  A complete discussion of regular expressions is beyond the scope of this manual, but more information can be found in the grep man page.

Exact phrase

  This type will match the search key exatly as entered. If the search key is `it is good`, this search would match a verse which contains "it is good," but would not match a verse which contains " good, and doeth it not, to him it is sin."

#### Search Options Checkbox

Allows selecting of search options. The only available option is Match case. Check this box to make the search case sensitive.

#### Search Scope Selector

Allows defining the range within the specificed module that will be searched. There are three search scopes available:

No scope

  This button causes the search to to include the entire module.

Use bounds

  Selecting this button produces two dropdown selector boxes marked Lower and Upper. Select the first book to search in the Lower box and the last book to search in the Upper box. The search will begin with the Lower book and end with the Upper book and include all books in between.

  Chapter and verse numbers can be entered into the search bound boxes as well to further narrow the search.

Last search

  Select this button to do a new search including only the verses returned as a result of the last search. Use this with a new search key to narrow the search further.

#### Search Results View

This shows a list of the current search results for previewing, navigation, or saving.

Preview

  To preview the search result, simply click on an individual result. The entry will show in the preview pane.

Navigation

  Navigation to the search result can be done in two ways. To open the result in a new tab, middle-click the mouse. To open the result in the current tab, double-click the result.

Save Results

  You may save your results as a list of bookmarks. To do this, right-click and select Save List. You will be prompted to enter a name for the folder that your results will be saved to. After you have saved the results, you may view them by going to your bookmarks and finding the folder you just named.

### Advanced Searches

More complicated searches might require the use of the advanced search functions, found under Edit->Advanced Search.

#### The Advanced Search Dialogue

The Advanced Search Dialog

In Advanced Search, much more complex queries can be constructed, involving custom search ranges, custom lists of modules over which to search, regular expression matching (see next section), and attribute-based searches such as are found in footnotes or Strong's Hebrew and Greek dictionary references.

The default search is multi-word, a somewhat slow and blunt search through module text. Also available is an optimized search based on the Lucene indexing and search library. In order to use the optimized search, the index must be constructed beforehand: Please see the preceding section on the Module Manager regarding the Maintenance functions, including indexing. A web search will provide several references to the syntax needed to put to use the power of optimized Lucene search. A few examples follow:

Simple Searches: just type in the words you want to search for. To return only verses that include all of the words, prefix the word with "+". So, in the KJV, you could find Psalm 23 by searching for "+Lord +shepherd +want". To search for an entire phrase, surround the entire phrase with quotes, like "maketh me to lie down" (note that quotes are unnecessary in all of the other examples).

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

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

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

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

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

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

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

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

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.

### Search Syntax using Regular Expression

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 "righteous", "righteousness", "unrighteous", "upright" and even "bright". 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 "shall not".

The power of Regular Expressions is in the patterns (or templates) used to define a search. A pattern consists of ordinary characters and some special characters that are used and interpreted by a set of rules. Special characters include .\[^*$?+. 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.

Example: the pattern "i. love\." will find sentences that end with "his love" or "in love" or "is love" followed by a period. The first period in "i. love\." is a special character that means allow any character in this position. The backslash in "i. love\." means that the period following it is not to be considered a special character, but is an ordinary period.

#### Rules for Regular Expression Search Requests

- . The period matches any character.

- * The asterisk matches 0 or more characters of the preceding: set, character or indicated character.

- + The plus sign matches 1 or more characters of the preceding: set, character or indicated character.

- ? The question mark matches 0 or 1 character of the preceding: set, character or indicated character.

- [ ] Square brackets match any one of the characters specified inside [ ].

- ^ A caret as the first character inside [ ] means NOT.

- ^ A caret beginning a pattern anchors the beginning of a line.

- $ A dollar at the end of a pattern anchors the end of a line.

- | A vertical bar means logical OR.

- ( ) Parentheses enclose expressions for grouping. Not supported!

- \ A backslash can be used prior to any special character to match that character.

- \ A backslash can be used prior to an ordinary character to make it a special character.

##### The Period

The Period "." will match any single character even a space or other non-alphabet character. s.t matches sit, set, sot, etc., which could be located in sitting, compasseth and sottish b..t matches boot, boat and beat foot.tool matches footstool and foot tool

##### The Asterisk

The asterisk "*" matches zero or more characters of the preceding: set, character or indicated character. Using a period asterisk combination ".*" after a commonly found pattern can cause the search to take a very long time, making the program seem to freeze. be*n matches beeen, been, ben, and bn which could locate Reuben and Shebna.

##### The Plus Sign

The Plus Sign "+" matches one or more characters of the preceding: set, character or indicated character. Using a period and plus sign combination ".+" after a commonly found pattern can cause the search to take a very long time, making the program seem to freeze. be+n matches beeen, been and ben, but not bn.

##### The Question Mark

The Question Mark "?"matches zero or one character of the preceding: set, character or indicated character. be?n matches ben and bn but not been. trees? matches trees or tree.

##### The Square Brackets

The Square Brackets "[]" enclose a set of characters that can match. The period, asterisk, plus sign and question mark are not special inside the brackets. A minus sign can be used to indicate a range. If you want a caret "^" to be part of the range do not place it first after the left bracket or it will be a special character. To include a "]" in the set make it the first (or second after a special "^") character in the set. To include a minus sign in the set make it the first (or second after a special "^") or last character in the set. s[eia]t matches set, sit, and sat, but not sot. s[eia]+t matches as above but also, seat, seet, siet, etc. [a-d] matches a, b, c, or d. [A-Z] matches any uppercase letter. [.;:?!] matches ., ;, :, ?, or ! but not a comma. [ ]^-] matches ] or ^ or -

##### The Caret first in Square Brackets

If the Caret is the first character after the left bracket ("[^") it means NOT. s[^io]t matches set, sat, etc., but not sit and sot.

##### The Caret as Start of Line Anchor

If the Caret is the first character in a pattern ("^xxx") it anchors the pattern to the start of a line. Any match must be at the beginning of a line. Because of unfiltered formatting characters in some texts, this feature does not always work, but may if a few periods are placed after the caret to account for the formatting characters. ^In the beginning matches lines that start with "In the beginning". (May need to use: ^.....In the beginning)

##### The Dollar Sign as End of Line Anchor

If the Dollar Sign is the last character ("xxx$") in a pattern it anchors the pattern to the end of a line. Any match must be at the end of a line. Because of unfiltered formatting characters in some texts, this feature does not always work, but may if a few periods are placed before the dollar sign to account for the formatting characters. Amen\.$ matches lines that end with "Amen." (May need to use Amen\....$, Amen\..........$, or even Amen\....................$)

##### The Vertical Bar

The Vertical Bar "|" between patterns means OR. John|Peter matches John or Peter. John .*Peter|Peter .*John matches John ... Peter or Peter ... John. (.* slows a search) pain|suffering|sorrow matches pain, or suffering, or sorrow.

##### The Parentheses

The use of Parentheses "( )" is not supported!

##### The Backslash Prior to a Special Character

The Backslash prior to a special character ("\*") indicates that the character is not being used in its special meaning, but is just to match itself. amen\. matches amen. but not ament and will not locate firmament.

##### The Backslash Prior to an Ordinary Character

The Backslash prior to an ordinary character ("\o") indicates that the character is not being used to match itself, but has special meaning.

- \b if use outside [ ] means word boundary. If used inside [ ] means backspace. \brighteous\b matches righteous but not unrighteous or righteousness

- \B means non-word boundary. \Brighteous\B matches unrighteousness and unrighteously but not righteous, unrighteous or righteousness.

- \d means digit; same as [0-9].

- \D means non-digit, same as [^0-9].

- \s means space.

- \S means not a space.

- \w means alphanumeric; same as [a-zA-Z0-9_].

- \W means not alphanumeric; same as [^a-zA-Z0-9_].

## The Studypad

### Using The Studypad

The Studypad can be opened by choosing File->Open Studypad

This is what the Studypad typically looks like:

#### The Studypad

The Studypad

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.

Toolbar 1

- Font Size and Environment

- Font Type

- Bold, Italics, Underscored, Crossed Out

- Left, Centre and Right Bound

- Shift Paragraph Right or Left

- Colour Selector

Toolbar 2

- New, Save, Delete and Print

- Cut, Copy, Paste and Undo

- Find and 'Find and Replace'

- Spellcheck

In order for spellcheck to be available, one of the languages under Edit->Current Languages must be set.

## The Personal Commentary

To build up a personal commentary you will need to install the editable 'Personal' sword module from the English Commentaries section. Right click it and choose Edit->Note->Personal in the menu.

An editor window similar to the Study Pad will appear. Edit your comment and save it; in the future it will appear as your comment to the relevant verse.

### The Personal Commentary Editor

The Personal Commentary

Locationbar

- Synchronise Button

- Bible Book, Chapter and Verse Selectors

- Location Summary

Use the Synchronise Button to quickly change location of your editor to that of the underlying Bibletext or use the Book, Chapter, and Verse selectors to choose to edit your comment to one particular verse.

Toolbar 1

- Font Size and Environment

- Font Type

- Bold, Italics, Underscored, Crossed Out

- Left, Centre and Right Bound

- Shift Paragraph Right or Left

- Colour Selector

Toolbar 2

- Save, Delete and Print

- Cut, Copy, Paste and Undo

- Find and 'Find and Replace'

- Spellcheck

In order for spellcheck to be available, one of the languages under Edit->Current Languages must be set.

To create a link to other verses right click the text and choose Link... In the pop-up window enter the link location and the module linked to.

It is possible to rename a personal commentary to suit a particular subject of study for that commentary. Thus, multiple personal commentaries may be installed: Rename the existing personal commentary, and then re-install another instance of the personal commentary if desired. Personal commentary names can consist only of letters and digits, and cannot duplicate an existing module's name. Rename is accessible off the right-click menu.

If the study embodied in a particular personal commentary is no longer needed, archival is available in the module manager, prior to removal, for possible future re-installation. See the module manager's Remove/Archive page. Any module may be archived, not just personal commentaries.

Although there are 31,102 verses in standard versification, it is unlikely that more than a tiny fraction of all verses will have personal commentary attached to them. A verse list showing where personal commentary notes exist is available from Right Click Dump Pers.Comm..

The created commentary page will be attached to an individual verse only. To write commentary pages from within Xiphos, attached to longer stretches of text use the Link.. function to link several pages together

## Journals and Prayer Lists

Xiphos supports user-created and -editable modules to contain general content. Initially conceived as simple prayer lists, they have expanded to include daily journals and topic-outline content. The user can maintain prayer lists, or prepare sermons, or write any structured content desired.

To enable prayer list and journal support, see the Preferences dialog as previously described. There, in General->Misc, check the item labeled Enable Prayer Lists. You will see a new item appear at the bottom of the sidebar's module list for "Prayer Lists/Journals".

Right-click on this entry, and you will be offered a context menu to create new modules. All the offered options are of the same type, but what is offered is a variety of templates from which to work. There are 5 templates at this time.

### Creating a journal or prayer list

New journal or prayer list

Their structure is the same, but the offered templates provide a variety of hints regarding ways to organize content. Simple is trivial, and can be considered a mental Post-It note. Subject is useful as a more organized version. Monthly provides a per-month structure in which to track needed content. Daily Journal is a full 365-day calendar in which to track a personal journal or ongoing prayer needs. And finally, Outlined Topic is a full, expandable outline suitable for topics and subtopics.

Journals and prayer lists have the structure of a general book: If simply selected for display from the module list, they will appear in the usual subwindow for general books.

Editing a journal or prayer list is done by right-clicking the module name to get its context menu, whose middle item is Open in Editor. The sections and subsections will be listed in the left margin. Click one, and the editor navigates to that section. The context menu on right-click of section keys provides for adding, deleting, and editing the names of sections and subsections.

If the general book subwindow is currently displaying the journal or prayer list being edited, it will synchronize with new content when Save is used.

As mentioned, these user-edited modules are in effect general books. This means they can be viewed in any Sword Project application. Thus, you can use these modules immediately in BibleTime, for example; or from the Module Manager's Maintenance page, you can archive a zip file to copy to a Windows system where you can then install the zip content as a module for the Windows user interface. Few other Sword Project applications provide for editing these modules, however, meaning that they will appear in such other applications as just ordinary general books.

In the future, it is planned that a module sharing facility will become available, by which user-edited modules such as these can be uploaded to become available to a wide audience. The current install repository facility will be expanded to provide upload as well as the existing download capability in order to support this. Thus, users will be able to share their sermons, Bible studies, and other personally-authored content with other Sword application users.

## Getting Help Online

### Users Mailing List

One way you can get help with Xiphos is using our low-traffic users' mailing list. You can sign up by clicking this link. Once you are signed up, you can email the list with any problems you are having and other users or the developers will respond, typically within a day.

### Live Chat

Another way to get help is with online chat. Xiphos has an IRC channel on freenode, #xiphos. If you don't know what that means, it's ok. Just click this link (it will open your web browser), type a nickname or accept the default, and click "Click to join chatroom". This will take you to a chatroom where the developers and other users are available to help you with issues you may be having. Although many times someone will answer your question immediately, sometimes you may have to wait a few minutes or longer.

## Original Language Research

### Installing Needed Modules

Xiphos is ideally suited for studying the original Greek and Hebrew. To get started, you will want the following modules:

From Crosswire Repository:

- StrongsHebrew Dictionary (or get StrongsRealHebrew from the Xiphos Repository)

- StrongsGreek Dictionary (or get StrongsRealGreek from the Xiphos Repository)

- Robinson Dictionary

- KJV Bible

From Xiphos Repository:

- StrongsRealGreek Dictionary (same as StrongsGreek, but with Greek characters, B-Greek transliteration, and self-referencing links)

- StrongsRealHebrew Dictionary (same as StrongsHebrew, but with Hebrew characters and self-referencing links)

- InvertedStrongsRealGreek (key in or copy actual Greek word, rather than number)

### Setting Up

While still in the module manager, create indexes for all of the modules you just installed. Then close the module manager and open Edit Preferences and go to Modules Misc. Set your Hebrew and Greek lexicons according to what you installed. Close preferences and open the KJV module. Turn on the module options Right Click Module Options Show Strongs and Right Click Module Options Show Morphology. You should see the Bible text change to show Strongs numbers underneath the appropriate English words. Hover over the numbers (or letters for morphology) with the mouse and you will see the definition displayed in the previewer pane. Click on the link and the definition will show in the dictionary pane. If you are using StrongsRealGreek or StrongsRealHebrew, you can click on any other number referenced in the definition and you will be taken to that entry.

### Searching for Strongs Numbers

Choose Edit Advanced Searchor press F3. Under Search Type, select Optimized ("Lucene"). Click on the Attribute Search tab, and make check the box that says Strongs Numbers. Now click in the entry field at the top and search for the number you are looking for preceded by "lemma:" and "G" for Greek or "H" for Hebrew. So to look for the Hebrew word tsad-deek (6662), enter "lemma:H6662". Once the search is done, the results pane will be shown. Notice that when you click on a result, it will show the result in the preview pane, and the strong's numbers will show as well, following immediately after the words they match. Also note that hovering over these numbers will show the definition in the main preview pane.

### Additional Modules

For more advanced research, the following modules are also available:

- 2TGreek (Xiphos Repository) : This module contains the entire Bible in Greek. It combines the LXX and Tischendorf8 NT into one easy-to-use module. In addition, it contains Strongs, Morphology,Greek Accents, and primary/secondary readings. As with all modules that include Strongs, Xiphos displays 2TGreek in beautiful interlinear form.

- Elzevir Textus Receptus (Crosswire Beta Repository as of this writing) : 1624 edition with Strongs and Morphology

- LXX (Crosswire Repository) : the Septuagint with Strongs, Morphology, and footnotes

- MorphGNT (Crosswire Beta Repository as of this writing) : This is derived from the morphologically parsed GNT provided by UPenn's CCAT. It was reformatted and error-corrected by James Tauber. It includes Greek accents and Morphology.

- TR (Crosswire Repository) : This is the Textus Receptus with Strongs and Morphology

- TischMorph (Xiphos Repository) : As described above, this has Strongs, Morphology, accents, and alternate readings.

- WHNU (Crosswire Repository) : Westcott-Hort of 1881 with Strongs and Morphology

- GreekHebrew (Crosswire Repository) : This is a dictionary keyed to Strongs. It contains words in the LXX that are also found in the New Testament. In addition, it contains the equivalent Hebrew words also keyed to Strongs.

- Didache (Crosswire Beta Repository as of this writing) : This is an early Christian treatise in Greek dated to the late first or early second century. It includes Strongs, Morphology, and Greek accents.

## Authors

This manual was written by:

- Andy Piper

- Pierre Benz

- Dr Peter von Kaehne

- Karl Kleinpaste

- Dominique Corbex

- Matthew Talbert

Please send all comments and suggestions regarding this manual to Xiphos Development list xiphos-developers@lists.sourceforge.net. Comments may also be submitted via the project trackers at SourceForge.

For more information on Xiphos, please visit the project website at http://xiphos.sf.net. Bug reports should be made using the Bug Tracker at the project development site http://www.sourceforge.net/projects/xiphos

## License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 or any later version as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

         	Free Software Foundation, Inc.
         	51 Franklin St, Fifth Floor,
         	Boston, MA 02110-1301
         	USA