File: preferences.xml

package info (click to toggle)
xiphos 4.1.0.1%2Bdfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 18,572 kB
  • sloc: ansic: 25,543; cpp: 13,223; python: 12,684; xml: 2,951; sh: 144; makefile: 42
file content (286 lines) | stat: -rw-r--r-- 11,218 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
<!-- Preferences -->


<!-- Introduction -->
	<sect2 id="preferences-introduction">
  		<title>Introduction To Preferences</title>
		<figure>
			<title>The Preference Dialog</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences.png" format="PNG" /> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Preferences Dialog</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>
                </figure>
               </sect2>
	
<!-- General Settings -->
	<sect2 id="general-settings">
		<title>General Settings</title>
		<sect3 id="tab-pane2">
			<title>Locale, General Preferences and StudyPad directory</title>
		<figure>
			<title>Locale, General Preferences and StudyPad directory</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences_general-misc.png" format="PNG" />
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_general-misc.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>General Preferences and StudyPad directory</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
		<para>
                If you wish <application>Xiphos</application> to display its interface in a language other than the default, you may select
                one here.  A restart will be required, so that the locale can be initialized.
		</para>
		<para>
                If you enable <guilabel>Default Dictionary</guilabel>, then that named dictionary (see <guimenuitem>Special</guimenuitem>
                below) module will always be used when double-clicking a word anywhere in <application>Xiphos</application>.
		</para>
		<para>
		Certain dictionary-style modules are <guilabel>Daily Devotionals</guilabel> 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 <application>Xiphos</application>
		display today's selection during startup.
		</para>
		<para>
		If you enable <guilabel>Resize images</guilabel>, <application>Xiphos</application> will automatically resize image
		content in commentaries, general books, and dictionaries so as to fit the subwindow which contains them.
		</para>
		<para>
		<guilabel>Highlight current verse</guilabel>, if enabled, will cause <application>Xiphos</application> to substitute
		mere current verse colorization with a high-contrast alternate color scheme on the current verse.  The colors used may be
		chosen from the color selector pane (see below).
		</para>
		<para>
                <guilabel>Highlight user annotations</guilabel> uses inverted highlight color choices when marking user-annotated
                verses.
		</para>
		<para>
                By default, <guilabel>Cross-references</guilabel> go into the Previewer.  Selecting this checkbox puts them into the verse
                list instead.
		</para>
		<para>
                Verse number display can be offset in several ways provided by the checkboxes.
		</para>
                </sect3>
	</sect2>
	
<!-- General Settings -->
	<sect2 id="biblesync">
		<title>BibleSync Settings</title>
		<sect3 id="tab-bsp">
			<title>Controls for BibleSync</title>
		<figure>
			<title>Controls for BibleSync</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences_general-biblesync.png" format="PNG" />
	    </imageobject>
	    <textobject> 
	      <phrase>BibleSync Settings</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
		<para>
		BibleSync is a shared navigation protocol using LAN multicast.  It is useful for a single person when running Bible programs on
		multiple machines or devices, all of which you wish to navigate through the Bible together, or for a group working closely together,
		such as translators.  Also, it has a "lecture" mode, where a speaker's Bible program induces the audience's programs to follow along.
		The difference in the modes regards who transmits and who receives navigation.  In Personal mode, BibleSync navigation is both
		transmitted and received; as Speaker, it transmits only; as Audience, it receives only.
		</para>
		<para>
		To enable BibleSync, select a mode from the radio buttons.  Also, choose whether to accept navigation directly, so that Xiphos moves
		immediately to a specified verse, or whether incoming navigation is instead sent to the verse list, where you can decide whether to
		follow.
		</para>
		<para>
		If you use a firewall, you must punch a hole in it for UDP port 22272.
		</para>
		<para>
		If you run more than one BibleSync-compatible program on your computer and do not wish your activity among them to be shared on the
		local net, you can use Personal mode combined with the Private checkbox.  This will tell <application>Xiphos</application> not to
		broadcast outside your system.
		</para>
		<para>
		You can send a verse list from the sidebar search or Advanced Search window via BibleSync; see the context (right-click) menu.  A
		particularly good use case for this is when using a simpler Bible program, such as on a mobile device, with another such as
		<application>Xiphos</application> that has significant search capability: Do searches in <application>Xiphos</application> and send
		the resulting verse list to the mobile device.  Be aware that size limitations on the protocol are small, and though a search may
		generate hundreds of results in the verse list, at most a few dozen will pass in the protocol to the receivers.  For
		<application>Xiphos</application>, receipt of multi-references always induces indirect verse list navigation.
		</para>
		<para>
		<application>Xiphos</application> is the first Bible program with a BibleSync implementation; as such, its utility may be limited for
		now.  But a number of other programs' authors and support organizations have indicated their intention to support BibleSync as well,
		including Laridian, theWord, BibleAnalyzer, and Accordance, as well as other Sword Project applications.
		</para>
                </sect3>
	</sect2>
	
<!-- Fonts And Colors -->
	<sect2 id="fonts-and-colors">
		<title>Fonts And Colors</title>
		<sect3 id="font-color">
			<title>Setting Font Colors</title>
			<figure>
			<title>Font Colour Settings</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences_fonts-color.png" format="PNG" />
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/image.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Font Colour Settings</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>

                </figure>
		<para>
		The <guibutton>Invert color pairs</guibutton> buttons are provided to make it easy, for example, to move the main window
		into "night mode," with white text on black background.
		</para>

                </sect3>
		
		<sect3 id="font-misc">
			<title>Miscellaneous Font Settings</title>
			<figure>
			<title>Miscellaneous Font Settings</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences_fonts-misc.png" format="PNG" /> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_fonts-misc.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Miscellaneous Font Settings</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>
                </figure>

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

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

		<para>
                The font name and size used for display is chosen from this order:
		</para>
                <itemizedlist>
                        <listitem>
                                <para>
                                The selection made via the context menu for the specific module, under <guimenuitem>Module
                                Options</guimenuitem>.
                                </para>
                        </listitem>
                        <listitem>
                                <para>
                                The per-language selection made under Preferences, here.
                                </para>
                        </listitem>
                        <listitem>
                                <para>
                                The module's own default selection, in its configuration file.
                                </para>
                        </listitem>
                        <listitem>
                                <para>
                                The application default.
                                </para>
                        </listitem>
                </itemizedlist>

		</sect3>
	</sect2>
	
<!-- Module Settings -->
	<sect2 id="module-settings">
		<title>Module Settings</title>
		<figure>
			<title>Parallel Preferences</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences_modules-parallel.png" format="PNG" /> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_modules-parallel.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Parallel Preferences</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>

                </figure>
                <figure>
			<title>Various preferences Modules </title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/preferences_modules-misc.png" format="PNG" /> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_modules-misc.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Various Preferences Modules</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
	</sect2>