Základní informace o MDK
MDK (Module Development Kit) je sada programů pro konverzi vstupních textů do binárních modulů pro Davar4.
Při instalaci Davar4 je třeba vybrat, aby byl MDK nainstalován. Veškeré soubory budou nainstalovány do poadresáře \mdk\ v hlavním datovém adresáři Davar4, např. jako C:\ProgramData\Davar4\mdk\
MDK se skládá z několika programů:
- D4DBK.EXE: Program pro vytváření modulů knih (*.dbk), např. Bible
- D4LEX.EXE: Program pro vytváření modulů lexikonů (*.lex). Lexicony jsou SQLite3 databázové soubory a knihovna sqlite3.dll musí být přítomna v adresáři, kde běží tento program.
- D4DIC.EXE: Program pro vytváření modulů slovníků (*.dic). Slovníky jsou SQLite3 databázové soubory a knihovna sqlite3.dll musí být přítomna v adresáři, kde běží tento program.
- D4DWR.EXE: Program pro vytváření modulů spisů (*.dwr). Spisy mají poměrně flexibilní formát, který může být použit jak pro data knih - struktura typu kniha-kapitola-verš (Bible), tak pro slovníková data s klíčem dle slov, rovněž pro slovníky, Strongovy indexy, gematrii, poznámky a další data. Spisy jsou SQLite3 databázové soubory a knihovna sqlite3.dll musí být přítomna v adresáři, kde běží tento program.
- D4DWRTXT.EXE: Program pro vytváření modulů spisů (*.dwr), které mají organizaci kontejneru pro celou knihovnu textů, uložených v jednom souboru. Například moduly "Extra Biblical texts" nebo "The Early Church Fathers" jsou knihovny textů, uložených v jednom souboru, přičemž texty nemají strukturu kniha-kapitola-verš. Program slouží pro přípravu těchto druhů spisů, knihovna sqlite3.dll musí být přítomna v adresáři, kde běží tento program.
Každý z těchto programů potřebuje dva textové vstupní soubory. Oba musí být kódovány v UTF-8 a bez BOM značky na začátku souboru:
info.txt - textový soubor, kde jsou uloženy nejrůznější informace o vytvořeném modulu. Např. popis modulu, informace o autorských právech, URL, jazyku modulu, seznam použitých tagů a další informace.
data.txt - textový soubor, kde je vlastní text modulu. Může to být buď prostý text a nebo můžou být přidány dodatečné informace ve formě TAGŮ. Např. Strongův index je do textu vložen jako sekvence |RH403|Rh.
Na autorovi modulu je připravit tyto dva texty pro konverzi. Zatímco soubor info.txt je snadné modifikovat na základě hotových modulů, příprava souboru data.txt je náročnější, zejména pokud je v něm použito více tagů. Celý následující text je vlastě návod, jak připravit tento soubor.
Doporučené nástroje, které můžete použít pro práci s MDK:
- Textový editor pro práci s prostým textem, umožňující pracovat rychle i s velkými soubory: Notepad++ (freeware) nebo PSPad (freeware). Oba programy jsou výborné textové editory, které umí zaznamenávat makra - tato funkce vám může mnohonásobně urychlit přípravu textů.
- Multifunkční Unicode editor BabelPad (freeware) pokud plánujete pracovat s hebrejskými texty nebo s jazyky mimo latinku. BabelPad umí provádět mnoho textových konverzí a zobrazit i tisknout jednotlivé Unicode jazyky ve zvolených fontech. Zvládá dobře práci s R2L texty (zprava doleva).
- Pokud potřebujete provádět některé složité úpravy a převody textů (např. exporty z jiných programů či stažené webové stránky), AWK je vynikající nástroj, který je poskytován zadarmo. Jedná se o interpretovaný programovací jazyk, navržený pro zpracování textů a obvykle se používá pro získání a výpis požadovaných informací z textů.
- Nástroje pro práci s SQLite3 databázemi. Kromě knih jsou všechny ostatní moduly soubory SQLite3 databáze. Znamená to, že můžete vytvořit tyto soubory nejen pomocí MDK nástrojů, ale i pomocí libovolného nástroje pro práci s databází. Občas je také vhodné si strukturu databáze prohlédnout pomocí prohlížeče. Pro tyto účely můžete použít například tyto free programy:SQLite Database Browser, SQLite Spy, SQLite Studio a další.
Uspořádání adresáře MDK
Pokud jste se rozhodli povolit při instalaci MDK (obvykle do \ProgramData\Davar4\mdk\), uvidíte následující strukturu adresářů a souborů:
1. Adresáře kde jsou umístěny jednotlivé programy a knihovna sqlite3.dll (pokud je nutná). Můžete sem zkopírovat odpovídající soubor info.txt a data.txt a spustit exe soubor pro start konverze a vytvoření modulu.
D4DBK
D4DIC
D4DWR
D4DWRTXT
D4LEX
2. Adresáře s příklady, všechny soubory jsou již připravené a stačí pouze spustit exe program:
Example1 - KJV+ as DBK
Example2 - LXX+ as DBK
Example3 - HE-EN dictionary as DIC
Example4 - STRIPD_HE as DWR
Example5 - Imitation of Christ as DWR text
Example6 - Thompson Chain Topics as LEX
3. Specifikace všech souborů modulů, seznam tagů, kódování morfologie, struktura databází apod...
D4-specification.txt
4. Krátký soubor readme v angličtině
readme.txt
5. Zipované zdrojové kódy pro všechny konvertory, napsané v C. Můžete je přeložit v libovolném ANSI C překladači jako konzolový program. Všechny programy v MDK byly přeloženy v GCC, pomocí otevřeného vývojového prostředí Code::Blocks.
src.zip
