/usr/share/bibledit-gtk/site/gtk/reference/menu/tools/generate-word-lists.html is in bibledit-gtk-data 4.9-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<link href="../../../../bibledit.css" rel="stylesheet" type="text/css" /><!--
Copyright (©) 2003-2011 Teus Benschop and Contributors to the Wiki.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU
Free Documentation License" in the file FDL.
-->
<title></title>
</head>
<body>
<div id="menu">
<ul>
<li>
<a href="../../../../home.html">1 Bibledit</a>
</li>
<li>
<a href="../tools.html">Tools</a>
</li>
<li style="list-style: none; display: inline">
<hr />
</li>
<li>
<a href="bible-notes-mass-update.html">Bible notes mass update</a>
</li>
<li>Generate Word lists
</li>
<li>
<a href="transfer-project-notes-to-text.html">Transfer Project Notes to text</a>
</li>
</ul>
</div>
<div id="content">
<h1>
Generate Word lists
</h1>
<h3>
<a name="TOC-Introduction" href="" id="TOC-Introduction"></a>Introduction
</h3>
<p>
The dialog to generate the word lists is available through the menu, Tools, Generate word lists.
</p>
<p>
It generates a general word list, a list of Hebrew words, and one of Greek words.
</p>
<p>
It goes through all the data in the project, collects the entries which have been marked, and then inserts the lists at a location defined by the user. Thus it can generate a glossary or topical index.
</p>
<h3>
<a name="settings" href="" id="settings"></a>Settings
</h3>
<p>
There are three possible lists: a general word list, a Hebrew word lists, and a Greek word list.
</p>
<p>
For each of these lists there are some options that the user can set:
</p>
<p>
- Process word list: whether to process this particular word list.
</p>
<p>
- Add an asterisk to each entry, see below.
</p>
<p>
- Add the asterisk only to the first time this particular entry occurs in the section, see below.
</p>
<h3>
<a name="operation" href="" id="operation"></a>Operation
</h3>
<p>
Generating word lists is simple assuming that the right markers are already in the data: Just set the options, click button OK, and wait till it is through.
</p>
<h3>
<a name="entries" href="" id="entries"></a>Entries
</h3>
<p>
The word list generator uses the entries that are in the data to collect the words to insert in the list.
</p>
<p>
An entry for the general word list is inserted between the \w and the \w* markers. The Hebrew and Greek word lists use similar markers. See the <a href="javascript:void(0);">USFM</a> documentation for full details
</p>
<p>
When the word list generator runs, it will remove any asterisks (*) that were appended to the word. When the option "Add an asterisk to each word entry" has been selected, it will then add an asterisk after the word. If the option "the first time it occurs in a section" has been selected also, it will only add the asterisk where this particular entry occurs for the first time in the section. In this case, if for example the word "talent" occurs several times in a section, it will be given as "talent*" the first time, with the asterisk, and as "talent" the other times, without an asterisk. The section headings define the size of a section.
</p>
<h3>
<a name="lists" href="" id="lists"></a>Lists
</h3>
<p>
The lists of words can be inserted once or more than once in the data. The general word list will be inserted between the markers \zopenwordlist and \zclosewordlist. These markers ought to be on a separate line. If this couple of markers occurs in several places, the word lists will be inserted in several places too. If it occurs once, only one list will be generated, and if it does not occur at all, no list will be generated.
</p>
<p>
Any entries that are already between those markers will be preserved. If there are entries between those markers, and there is no corresponding entry in the text, this entry will be commented out.
</p>
<p>
List of usfm markers that indicate the position of a word list:
</p>
<pre>
\zopenwordlist<br />\zclosewordlist<br />\zopengreekwordlist<br />\zclosegreekwordlist<br />\zopenhebrewwordlist<br />\zclosehebrewwordlist
</pre>
<p>
The markers that open and close a word list will need to be manually typed in the text at the right location. They are not part of the stylesheet.
</p>
<h3>
<a name="example" href="" id="example"></a>Example
</h3>
<p>
Consider the following situation:
</p>
<p>
The text contains the following general word list entries: Hallelujah, Rabi, Pentecost.
</p>
<p>
At some place of the data, the list should be inserted, but it already contains some entries:
</p>
<pre>
\zopenwordlist<br />\p Hallelujah: Praise the Lord<br />\p Rabi: Teacher<br />\p Mamon<br />\zclosewordlist
</pre>
<p>
After running the word list generator, it will look so:
</p>
<pre>
\zopenwordlist<br />\p Hallelujah: Praise the Lord<br />\rem Mamon<br />\p Pentecost<br />\p Rabi: Teacher<br />\zclosewordlist
</pre>
<p>
Note the following: (1) the existing entries have been preserved, (2) a new one has been added, (3) one has been commented out, and (4) the entries have been sorted alphabetically.
</p>
<p>
Note also that any text before the first colon (:) is considered to be the actual entry. If there is no colon, then the whole text will be considered the entry.
</p>
</div>
</body>
</html>
|