Скопировано из документации самой программы «Цитата из Библии» (нажмите F1 в программе)
Сила программы «Цитата», как уже показало время ее эксплуатации с 1998 года, состоит именно в возможности расширения базы текстов разными модулями. Среди модулей, которые доступны в Интернете, есть даже большие энциклопедические словари, наборы географических карт или целые фото-галереи. Здесь мы дадим краткие указания по тому, как можно создать собственный модуль.
Как мы уже говорили, каждый модуль находится в своей директории. Файлы модуля должны быть в текстовом виде, но расширение может быть любым, например, TXT или HTM. Модуль может быть либо одной большой книгой (как в случае Библии), либо собранием книг одного автора. В любом случае, каждая часть модуля содержится в отдельном файле, внутри которого есть разбиение на главы и стихи (абзацы, если это не Библия).
Для того, чтобы «Цитата» могла опознать модуль, в директории модуля должен быть файл bibleqt.ini. Опытные пользователи могут просто заглянуть в любой из таких файлов, поставляемых с нашими модулями, чтобы понять, «что к чему». Здесь мы на примере файла для модуля русской Библии разберем все параметры, которые прописываются в этом файле.
BibleName = Русский Синодальный текст (современная редакция)
BibleShortName = RST
BibleName определяет полное название модуля, а BibleShortName – его сокращение при показе в истории или на закладках окна просмотра.
Bible = Y
OldTestament = Y
NewTestament = Y
Apocrypha = Y
Эти параметры сообщают, является ли модуль переводом Библии или нет, а также, если это перевод Библии, то есть ли в нем Ветхий Завет, Новый Завет и Апокрифы (неканонические книги). В случае отрицательного ответа, значение параметра равно N (от слова No).
ChapterZero = N
Некоторые модули, например комментарии к Библии, имеют в каждой книге главу «ноль», которая по сути является комментарием ко всей книге, а уже после главы «ноль» следуют комментарии к главам. Этот параметр влияет на отображения номеров глав в панели управления и на синхронизацию при переходе между модулями.
HTMLFilter = <img
Здесь можно прописать дополнительные тэги, которые будут активны в этом модуле. Благодаря этому параметру, можно даже заставить «Цитату» показывать изображения (иллюстрации) в тексте модуля! «Цитата из Библии» по умолчанию показывает HTML-тэги заголовков, выделения жирным или наклонным шрифтом. Вниманию авторов: если это не закрывающийся тэг, как например <a href... то надо писать:
HTMLFilter = <a </a>
Маленький секрет: таким образом, можно ссылаться из одного модуля в другой. Например:
Автор говорит: Бог сотворил небо и землю. (ср. <a href="go rststrong 1 1 1">Быт.1:1</a>)
Следующий параметр это набор букв национального алфавита:
Alphabet = АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя
Это буквы используются при поиске, другие будут игнорироваться.
DesiredFontName=Comic Sans MS
DesiredFontCharset=204
Первый параметр говорит о нужном шрифте, а второй о кодовой странице текстов. В некоторых модулях, например, Библия на корейском языке, это жизненно важно, потому что изменение шрифта недостаточно. Если быть более точными, то в принципе нужно только изменение кодовой страницы, чтобы система Windows подставила нужный шрифт. Для книг и переводов Библии на русском или английском языке, можно уверенно ставить кодовую страницу 204 (RUSSIAN_CHARSET). Для западноевропейских языков (например, с умлаутами) ставьте 238. Для греческих и еврейских шрифтов советуем поставить Charset=1.
Маленький нюанс: Если DesiredFontName совпадает не только с названием шрифта, но и названием файла, где этот шрифт (без указания расширения TTF), то программа автоматически подгрузит нужный шрифт при обращении к модулю. Поэтому файл со специальным шрифтом при создании модуля можно называть по имени шрифта (с добавлением расширения TTF).
ChapterSign = A NAME
VerseSign = <SUP>
Здесь вся изюминка программы «Цитата из Библии», а точнее ее открытого механизма подключения модулей. Программе все равно, как были составлены модули и в каком формате хранятся данные. Важно только правильно задать эти признаки. У каждого модуля может быть свой набор признаков разбиения на главы и на стихи (абзацы). Главное, чтобы во всех файлах в рамках одного модуля разбиение было одинаковым. Будьте внимательны, т.к. если описывать не точно, то признак стиха может быть частью признака главы или наоборот, например
ChapterSign = <p><h1>
VerseSign = <p>
В таком случае, программа будет путать главы со стихами, что сделает модуль нечитабельным.
Далее идет описание самих книг модуля.
BookQty = 77
PathName = ru01.htm
FullName = Бытие
ShortName = Быт. Быт Бт. Бт Бытие Ge. Ge Gen. Gen Gn. Gn Genesis
ChapterQty = 50
....
Сначала описывается BookQty, т.е. количество книг (частей) в модуле, а потом один за другим описываются эти книги (части). PathName это название файла, в котором книга содержится. FullName это полное название книги, а ShortName это список ВСЕХ возможных сокращений. Именно эти сокращение принимает программа в диалоговой панели открытия отрывка. Например, введя «Быт. 1:1» или «Ge 1:1», Вы попадаете на один и тот же стих благодаря этому параметру в конфигурационном файле модуля. ChapterQty это количество глав в книге.
Мы надеемся, что это описание поможет Вам без проблем создать свой модуль. Следите за обновлениями на сайте, т.к. в ближайшем будущем мы хотим выпустить программу для более-менее автоматизированного процесса создания модулей. И, если Вы создали модуль для подключения, смело связывайтесь с нами и посылайте эти модули по электронной почте.
Успешного Вам творчества!