Каждый модуль содержится в отдельной директории.
Файлы модуля должны
быть в текстовом виде, а
расширение может быть HTML
(*
.htm, *
.html) либо текстовые файлы
(*
.txt).
При этом нужно учитывать, что
кодировка такого файла должна
быть 65001
(UTF-8).
Модуль может быть либо одной большой книгой (как в случае
Библии), либо собранием книг одного автора. Каждая часть модуля содержится в отдельном файле, внутри
которого есть разбиение на главы и стихи
(абзацы, если это не Библия).
Правила создания BibleQt.ini
Чтобы "Цитата" могла опознать модуль, в директории
модуля нужно создать файл
bibleqt.ini.
На примере
файла для модуля русской Библии разберем
все параметры, которые указываются в
bibleqt.ini.
BibleName = Русский Синодальный текст 77 книг (современная
редакция кб)
BibleShortName = RSTN
Copyright =
Bible = Y
OldTestament = Y
NewTestament = Y
Apocrypha = Y
ChapterZero = N
StrongNumbers = Y
StrongsDirectory = StrongsRSTN
SoundDirectory = SoundsRSTN
HTMLFilter = <a </a> <font </font>
// Language = Русский
DefaultEncoding = utf-8
DesiredFontName=Microsoft Sans Serif
ChapterSign = <A NAME
VerseSign = <SUP>
BookQty = 77
PathName = 01.htm
FullName = Бытие
ShortName = Быт. Быт Бт. Бт Бытие Ge. Ge Gen. Gen Gn. Gn
Genesis
ChapterQty = 50
BibleName - содержит полное название модуля.
1) Начинайте с указания языка, на котором модуль
2) Старайтесь, чтобы полное название не превышало 5-7 слов
BibleShortName - сокращенное название модуля, которое
используется при показе в истории просмотра, на закладках и
вкладках окна просмотра.
1)
ВНИМАНИЕ! Используйте только английские буквы
2) Старайтесь, чтобы параметр не превышал 7-8 символов
Copyright =
Copyright.htm
Здесь
указывается файл содержащий информацию об авторских правах
данного модуля. Файл необходимо создать в директории модуля.
Bible = Y
OldTestament = Y
NewTestament = Y
Apocrypha = Y
Эти параметры сообщают, является ли модуль переводом Библии
или нет. Есть ли в нем Ветхий Завет, Новый Завет и
Апокрифы (неканонические книги).
В случае отсутствия значения, параметру присваивается
значение N.
ChapterZero = N
Некоторые модули, например комментарии к Библии, имеют в
каждой книге главу "ноль", которая по
сути является комментарием ко всей книге, а уже после главы
"ноль" следуют комментарии к главам.
Примечание:
Этот параметр влияет на отображение номеров глав в панели
управления и на синхронизацию при
переходе между модулями.
StrongNumbers = Y
StrongsDirectory = StrongsRSTN
Эти параметры помогут модулю в работе с номерами Стронга
.
StrongNumbers - этот параметр сообщает программе, есть
ли в модуле номера Стронга
StrongsDirectory - здесь указывается директория, в
которой размещена симфония с номерами Стронга.
Примечание:
Для одного модуля можно
использовать только одну директорию
с номерами Стронга.
SoundDirectory = SoundsRSTN
Этот параметр говорит, в какой директории размещены звуковые
файлы к модулю. О том, как создать такую директорию читайте
в разделе
Как подключить озвученные книги к BibleQuote.
HTMLFilter = <font </font> <a </a>
"Цитата из Библии" по умолчанию
показывает HTML теги заголовков, выделения жирным или
наклонным шрифтом. Другие теги вы можете прописывать
самостоятельно для каждого модуля.
ВНИМАНИЕ! Не забывайте, что
"Цитата из Библии" не Microsoft
Internet Explorer и не использует его компонент, так
что поддержки всех "преимуществ" HTML 4, а тем более
скриптов не ожидайте.
Если хотите, чтобы отображалось форматирование шрифтов
(размер, цвер, гарнитура), отличающиеся от основного, для
вывода отдельных фрагментов, то используйте фильтры:
<font
</font>
Чтобы отображались гиперссылки и закладки укажите фильтр:
<a </a>
Если хотите, чтобы отображались рисунки, карты, тогда
используйте:
<img
Хотите разбить абзац на строки внутри абзаца (если признак
абзаца не
<BR>!). Это удобно для разбивки на подстихи в
поэтических книгах Библии. Используйте фильтр
<BR>
!!!Маленький секрет:
Таким образом, можно ссылаться из одного
модуля в другой. Например: "Автор говорит: Бог сотворил небо и землю."
(ср. a href="go rststrong 1 1 1" Быт.1:1 /a)
Язык, на котором отображается модуль
Language = Русский
Это параметр понадобится при
составлении отчета о установленных модулях.
Alphabet =
АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя
DesiredFontCharset = 204
В BibleQuote 6 Unicode
эти параметры стали неактуальны, т.к. она понимает все языки
поддерживаемые юникодом. Модуль создается в кодировке
Unicode, поэтому строку с параметром
DesiredFontCharset
следует заменить на:
DefaultEncoding = utf-8
В этом случае программа
будет "понимать" текст на нескольких языках. Если Вы
пользуетесь комментарием к Новому Завету, в котором
используется русский, греческий и еврейский, то программа
легко сможет осуществить поиск на любом языке, используемом
в модуле. Например: Комментарий к Иоан.1:41 "мы нашли Мессию
(греч. μεσσιας от евр. המשיח), что значит: Христос (греч.
χριστος); Еврейское слово משיח - машиах, помазанник
происходит от слова משח - машах, помазать.
Задав поиск по
любому из слов используемых в этом комментарии, программа
легко найдет искомое слово.
Если же Вы захотите изменить шрифт отображаемого текста,
воспользуйтесь параметром:
DesiredFontName = Microsoft Sans Serif
В этом
случае нужно учитывать, что
DesiredFontName совпадает не только с
названием шрифта, но и названием
файла, где этот шрифт (без указания расширения TTF), то
программа автоматически подгрузит нужный
шрифт при обращении к модулю. Поэтому файл со специальным
шрифтом при создании модуля можно
называть по имени шрифта (с добавлением расширения TTF).
Кроме того, следует указывать шрифты поддерживающие
Unicode: Arial, Comic Sans MS, Courier
New, Microsoft Sans Serif, Times New Roman.
ChapterSign = <A NAME
VerseSign = <SUP>
Здесь вся изюминка программы "Цитата из Библии", а точнее ее
открытого механизма подключения
модулей. Программе все равно, как были составлены модули и в
каком формате хранятся данные. Важно
только правильно задать эти признаки. У каждого модуля может
быть свой набор признаков разбиения
на главы и на стихи (абзацы). Главное, чтобы во всех файлах
в рамках одного модуля разбиение было
одинаковым. Будьте внимательны, т.к. если описывать не точно,
то признак стиха может быть частью
признака главы или наоборот, например:
ChapterSign
= <P H1
VerseSign = <P
В таком случае, программа будет путать главы со стихами,
и это сделает модуль нечитабельным.
Описание книг модуля.BookQty = 77
PathName = 01.htm
FullName = Бытие
ShortName = Бт. Бт Быт. Быт Бытие Ge. Ge Gn. Gn Gen. Gen
Genesis
ChapterQty = 50
Сначала указывается
BookQty, т.е. количество книг
(частей) в
модуле, а потом один за другим
описываются эти книги (части).
PathName здесь указывается название файла,
в котором книга содержится.
FullName это
полное название книги, а
ShortName это список ВСЕХ возможных
сокращений. Именно эти сокращение
принимает программа в диалоговой панели открытия отрывка.
Например, введя "Быт. 1:1" или "Ge 1:1",
Вы попадаете на один и тот же стих благодаря этому параметру
в конфигурационном файле модуля.
ChapterQty это количество глав в книге.
Мы надеемся, что это описание поможет Вам без проблем
создать свой модуль. Если Вы
создали модуль для подключения, смело
связывайтесь с нами и посылайте эти модули по электронной
почте.