Davar4: MDK - Příprava modulů lexikonů (LEX) |
Lexikony jsou moduly, které používají jako klíčová slova texty (Latinka, Hebrejština, Řečtina) nebo Strongovy indexy nebo gematrické hodnoty.
V popisné části může mít lexikon až 10 záhlaví, kde můžou být použity různé tagy (např. Hebrejské a Řecké texty, Strongovy indexy, reference, PDF reference atd.)
Pod záhlavími následuje popisná textová část, kde můžou být rovněž použity tagy.
Moduly lexikonů jsou soubory databáze SQLite3. Soubor lexikonu .lex můžete rovněž otevřít v prohlížečích/editorech databáze a případně ho modifikovat.
DŮLEŽITÉ:
Doporučujeme použít oblast prvního záhlaví k zadání klíče lexikonu (např. s popisem "Word", jak je ukázáno na obrázku níže)
Program konvertoru d4lex.exe opět vyžaduje dva soubory:data.txt a info.txt.
Soubor info.txt obsahuje definice struktury lexikonu (počet a typy záhlaví apod.) a tato definovaná struktura musí být následně dodržena v souboru data.txt.
Většina položek ze souboru info.txt byla vysvětlena v části přípravy knihy, prostudujte ji.
Toto je příklad, který najdete v adresáři MDK. Po úspěšném zkompilování modulu můžete přesunout připravený lex soubor do datové složky, nastartovat Davar4 a otevřít tento modul.
Nyní společně projdeme soubory info.txt a data.txt a okomentujeme nejdůležitější části.
Příklad TCT lexikonu: Klíčové slovo (latinkou) je použito rovněž v 1. záhlaví (AARON), pod ním je popisná část s tagy referencí
Example of info.txt file used in Example6 - Thompson Chain Topics as LEX (blue, bold) , next line (red) is commentary and explanation (not a part of file!). All red commentaries also starts here by ; character - thus you can copy and paste to editor all section below and use it as template for your module.
;THIS FILE MUST BE UTF-8, Little Endian, without Byte Order Mark. New line is CR+LF pair ; pokud je znak ; použit jako první znak na řádku, celý řádek je ignorován (uživatelská poznámka) D4_Version_Major=1 ; hlavní a vedlejší verze. Toto je důležité v případě vydání opravených verzí modulů D4_OutputFile=tct.lex ; jméno finálního výstupního souboru modulu, tct.lex
D4_Title=Thompson Chain Topics D4_Info=Topical references are from R. A. Torrey's New Topical Textbook D4_Copyright=Frank Thompson's 1934 "The New Chain-Reference Bible". Copyright May 24 1934, US. registration number A72501; not renewed; became public domain material in 1962. Spellings Anglicisied. Errors in cross-references corrected. Material keyed and proofed by Paul Houghton. This material contains information that is a proper subset of the material distributed by B.B. Kirkbride under the trademark of "Thompson Chain-References". The errors in the cross-references that Kirkbide have been published in all their editions of the Thompson's Bibles have been corrected. Copyright expired. ; Informace o autorských právech textu v modulu. Pokud potřebujete vložit nový odstavec, použijte tag |C . Max. 4095 znaků. D4_URL= ; URL kde může uživatel získat info o modulu nebo novější verzi. Max. 255 znaků.
D4_BooksNumber=66
;Type of key or headers:0=Latin,1=HE,2=GR texts, D4_KeyType=0 ; zde je typ globálního klíče = 0, což dle definic nahoře je text latinky ;specification of main language and sublanguage. We use standard Windows
D4_Headers=1 ; počet záhlaví. Je doporučeno mít alespoň JEDNO záhlaví, které je kopií klíče - aby klíče lexikonu nebyly vidět pouze v levém okně seznamu klíčů, ale také v hlavním okně lexikonu. TCT má proto jedno záhlaví. ;here can be used 0-9 headers. Not used can be omitted ; typ záhlaví s číslem 0 má hodnotu =0 - což je text latinky D4_HeaderLabel0=Word: ;1.st param: HEADER IS VISIBLE (1=yes, 0=no), ;HEADER IS VISIBLE: výchozí hodnota 1 (ano). Je ale možné vytvořit NEVIDITELNÉ záhlaví a to potom použít ve vyhledávání (viz níže) ;INSERT NEW LINE AFTER HEADER: pokud je nastaveno na 1 (ano), další záhlaví bude vloženo na nový řádek. Záhlaví je lépe čitelné, ale za cenu více místa v okně. ;USE THIS HEADER FOR SEARCHING: pokud je nastaveno na 1 (ano), pokud Davar prohledává, tak je toto záhlaví zahrnuto k prohledávání. Důležité zvláště pro záhlaví se Strongovými indexy
D4_Tags=1 ;Tag flags: 0=tag not used,1=tag is used and default visible,3=tag is used and default invisible | ; seznam všech tagů, použitých v Davar4. Použijte pouze hodnoty 0 nebo 1 (zbytek ještě není funkční). 1= tag je použitý, 0= tag není použitý. ; POZNÁMKA: TCT lexikon používá dva tagy, tučné písmo a reference => proto D4_BooksNumber je použito a část D4_Books= je vyplněna pro všech 66 knih Bible, která je použita v TCT referencích.
D4_JumpInside=1 ; pokud kniha obsahuje reference, nastavení na 1 znamená, že dvojklik na tuto referenci synchronizuje všechny ostatní moduly a i v tomto modulu dojde k odskoku na příslušnou referenci, pokud to lze provést. Nastavení na 0 znamená že VŠECHNY OSTATNÍ moduly budou synchronizovány (pokud to lze), ale pozice v tomto modulu zůstane nezměněna.
D4_Books=
; velmi důležitá sekce. Tento blok obsahuje informace o všech knihách, které jsou zařazeny v modulu, v případě lexikonu jsou tyto knihy použity v referencích. První řádek: ;D4_Books= ;je ihned následován popisy, každá kniha na jeden řádek. Počet řádků MUSÍ BÝT PŘESNĚ STEJNÝ JAKO POČET KNIH, udaných dříve v sekci D4_Books= ;Každá kniha má následující parametry (např. pro řádek 1,OTGen,Genesis,Gen): ;1 = číslo knihy. Od 1 do D4_Books ;OTGen = jedinečný synchronizační název pro tuto knihu (Genesis). Úplný seznam najdete v souboru D4-specification.txt v MDK v sekci Reserved synchro names. ;Genesis = název knihy, která bude zahrnuta v modulu. Znamená to, že pro reference na začátku veršů v data.txt můžete použít prakticky libovolné názvy, protože bude použit zde uvedený název. ;Gen = zkratka knihy, která bude použita v modulu.
|
V případě lexikonu, soubor data.txt musí dodržovat strukturu, která byla definována v souboru info.txt. Takto může autor modulů flexibilně definovat nejrůznější typy lexikonů.
Níže je první záznam z TXT lexikonu (pamatujte, každý ze záznamů je na jednom řádku a stejně tak i následující blok je jeden řádek v souboru data.txt)
|SKAaron|Sk|SH0|TBAARON|Tb|Sh0 |Cson of Amram, the first high priest.|C |C(1) General References to-|C |RROTExod:4:14|Rr; |RROTExod:5:20|Rr; |RROTExod:6:20|Rr; |RROTExod:7:1|Rr,|RROTExod:7:7|Rr,|RROTExod:7:12|Rr; |RROTExod:12:1|Rr; |RROTExod:16:34|Rr; |RROTExod:17:12|Rr; |RROTExod:19:24|Rr |RROTExod:24:14|Rr; |RROTExod:28:12|Rr; |RROTExod:30:10|Rr; |RROTExod:32:2|Rr; |RROTLev:10:6|Rr; |RROTNum:12:1|Rr; |RROTNum:16:11|Rr |RROTNum:17:3|Rr; |RROTNum:20:25|Rr,|RROTNum:20:28|Rr |C(2) FACTS CONCERNING|C |CMade spokesman for Moses-|C |RROTExod:7:1|Rr |CWith Hur, supports Moses' hands during a battle-|C |RROTExod:17:12|Rr |CMade the High Priest-|C |RROTExod:28:1|Rr |CBroke the covenant and made the Golden Calf-|C |RROTExod:32:2|Rr-|RROTExod:32:4|Rr |CExcluded from the Promised Land-|C |RROTNum:20:12|Rr |CDied on Mount Hor-|C |RROTNum:20:28|Rr
|
|SKAaron|Sk - toto je text klíčového slova "Aaron" vloženého do párového tagu klíčových slov |SK|Sk
|SH0|TBAARON|Tb|Sh0 - toto je první záhlaví. Veškerý text uvnitř tagu prvního záhlaví |SH0|Sh0 je zpracován jako tagovaný text k zobrazení. V tomto případě jsme použili tagy pro tučné písmo |TB|Tb do kterého je vloženo klíčové slovo: AARON. Pamatujte, že v souboru info.txt jsme definovali jedno záhlaví a název D4_HeaderLabel0=Word: - tento název je tedy použit před klíčovým slovem AARON.
|Cson of Amram, the first high priest.|C |C(1) General References to-|C |RROTExod:4:14|Rr; |RROTExod:5:20|Rr; |RROTExod:6:20|Rr; |RROTExod:7:1|Rr,|RROTExod:7:7|Rr,|RROTExod:7:12|Rr; |RROTExod:12:1|Rr; |RROTExod:16:34|Rr; |RROTExod:17:12|Rr; |RROTExod:19:24|Rr |RROTExod:24:14|Rr; |RROTExod:28:12|Rr; |RROTExod:30:10|Rr; |RROTExod:32:2|Rr; |RROTLev:10:6|Rr; |RROTNum:12:1|Rr; |RROTNum:16:11|Rr |RROTNum:17:3|Rr; |RROTNum:20:25|Rr,|RROTNum:20:28|Rr |C(2) FACTS CONCERNING|C |CMade spokesman for Moses-|C |RROTExod:7:1|Rr |CWith Hur, supports Moses' hands during a battle-|C |RROTExod:17:12|Rr |CMade the High Priest-|C |RROTExod:28:1|Rr |CBroke the covenant and made the Golden Calf-|C |RROTExod:32:2|Rr-|RROTExod:32:4|Rr |CExcluded from the Promised Land-|C |RROTNum:20:12|Rr |CDied on Mount Hor-|C |RROTNum:20:28|Rr
- toto je popisná část pro klíčové slovo Aaron. Můžete si všimnout použití tagu |C pro nový řádek. POZNÁMKA: |C tag je dlouhý 2 znaky pro snadnou konverzi znaků nového odstavce CR+LF (hexadecimálně 0x0d + 0x0a) na |C bez změny délky textu.
Rovněž můžete vidět mnoho referencí, např. první reference: |RROTExod:4:14|Rr je složena z následujících částí:
|RR|Rr - tagy pro referenci. Uvnitř je text reference.
OTExod - jedinečný synchronizační název pro Exodus, jak jej můžete najít v části D4_Books souboru info.txt a musí být použit přesně dle definice v souboru D4-specification.txt v MDK.
: - dvojtečka je použita k oddělení synchronizačního názvu knihy a čísla kapitoly
4 - číslo kapitoly
: - dvojtečka je použita k oddělení čísla kapitoly a čísla verše
14 - číslo verše
DŮLEŽITÉ: soubory použité v příkladu (data.txt a info.txt) nejsou částí MDK. Protože je ale modul STRIPD_GR součástí instalace Davar4, můžete otevřít tento lexikon a potom provést export ve formátu "Zdrojový kód pro MDK" se zatrženou volbou "Vytvořit i soubor info.txt". Exportujte modul jako soubor data.txt do zvoleného adresáře. Pro více informací se podívejte do sekce Export.
Příklad lexikonu STRIPD_GR: Řecký text je použitý jako klíčové slovo a následuje 6 záhlaví s různými tagy, pod nimi je popisná textová část
;All Davar4 MDK import files are UTF-8, Little Endian, without Byte Order Mark. New line is CR+LF pair D4_OutputFile=stripd_gr.lex D4_Version_Major=1 ;všimněte si, že v modulu nejsou žádné knihy, protože tento modul nemá reference
;Type of key or headers:0=Latin,1=HE,2=GR texts ;typ klíče je 2 = ŘECKÝ text, viz poznámky výše ;specification of main language and sublanguage. We use standard Windows ;primární jazyk je Řečtina, 0x08 D4_Headers=6 ;jak je vidět na obrázku nahoře, máme 6 záhlaví ;here can be used 0-9 headers. Not used can be omitted D4_HeaderType0=2 ;1. záhlaví (počítáno od 0) je řecký text (=2), popiska je "Word:", viditelné záhlaví, po záhlaví je vložen nový řádek a TOTO ZÁHLAVÍ JE POUŽITO PRO HLEDÁNÍ D4_HeaderType1=0 ;2. záhlaví je text latinky (=0), popiska je "Pronounc:", viditelné záhlaví, po záhlaví je vložen nový řádek a toto záhlaví není použito ke hledání D4_HeaderType2=12 ;3. záhlaví je Řecký Strongův index (=12), popiska je "Strong:", viditelné záhlaví, po záhlaví je vložen nový řádek a TOTO ZÁHLAVÍ JE POUŽITO K PROHLEDÁVÁNÍ (protože jde o řecký lexikon) D4_HeaderType3=0 ;4. záhlaví je text latinky (=0), popiska je "Orig:", viditelné záhlaví, po záhlaví je vložen nový řádek a toto záhlaví není použito ke hledání D4_HeaderType4=0 ;5. záhlaví je text latinky (=0), popiska je "Use:", viditelné záhlaví, po záhlaví je vložen nový řádek a toto záhlaví není použito ke hledání D4_HeaderType5=11 ;6. záhlaví je Hebrejský Strongův index (=11), popiska je "HE Strong:", viditelé záhlaví, po záhlaví je vložen nový řádek a toto záhlaví NENÍ použito pro hledání (protože jde o řecký lexikon) ;DŮLEŽITÁ POZNÁMKA: Když je záhlaví použito pro hledání, znamená to HLEDÁNÍ PRO SYNCHRONIZACI (např. po dvojkliku). V tomto případě, některá záhlaví jsou zahrnuty a některá ne. Ale v případě fulltextového hledání je prohledán VEŠKERÝ TEXT, včetně všech záhlaví. D4_Tags=1 ;Tag flags: 0=tag not used,1=tag is used and default visible,3=tag is used and default invisible D4_Synchronize=1 |
(pamatujte, každý ze záznamů je na jednom řádku a stejně tak i následující blok je jeden řádek v souboru data.txt)
|SKΑβελ|Sk|SH0|TGΑβελ|Tg|Sh0|SH1|TIab'-el|Ti|Sh1|SH2|RG6|Rg|Sh2|SH3of Hebrew origin |RH1893|Rh; Abel, the son of Adam:--Abel. |RH01893|Rh|Sh3|SH4 |TRTDNT-*,2|Tr Proper Name Masculine|Sh4|SH5|RH1892|Rh|Sh5|TL Abel = "vanity (that is: transitory)" |TL |TL 1) the second son of Adam, murdered by his brother Cain
|
|SKΑβελ|Sk - Řecké klíčové slovo Abel je vloženo do tagů |SK|Sk. Není potřeba použít tagy |TG|Tg pro řecký text, protože D4_KeyType byl nastaven na 2 (Řečtina)
|SH0|TGΑβελ|Tg|Sh0 - 1. záhlaví, uvnitř tagů |SH0 a |Sh0. Zopakováno řecké klíčové slovo Abel, ale teď už musí být tagy |TG a |Tg pro řecký text použity
|SH1|TIab'-el|Ti|Sh1 - 2. záhlaví, uvnitř tagů |SH1 a |Sh1, výslovnost je zobrazena kurzívou, proto jsou ještě použity tagy |TI a |Ti
|SH2|RG6|Rg|Sh2 - 3. záhlaví, Řecký Strongův index 6 je vložen pomocí tagu: |RH6|Rh
|SH3of Hebrew origin |RH1893|Rh; Abel, the son of Adam:--Abel. |RH01893|Rh|Sh3 - 4. záhlaví, zde je zobrazen Hebrejský Strongův index, např. |RH1893|Rh
|SH4 |TRTDNT-*,2|Tr Proper Name Masculine|Sh4 - 5. záhlaví, párový tag pro zvýšený text (horní index) uvnitř |TR a |Tr
|SH5|RH1892|Rh|Sh5 - 6. záhlaví, opět Hebrejský Strongův index, |RH1892|Rh
|TL Abel = "vanity (that is: transitory)" |TL |TL 1) the second son of Adam, murdered by his brother Cain - zde je popisná část pro dané klíčové slovo. Nový odstavec (zalomení řádků) je zde pomocí tagu |TL, ale stejného efektu může být dosaženo pomocí tagu |C