Цитата из Библии  

BQT.ru: ОписаниеФорматаМодулей ...

Главная | Каталог | Изменения | НовыеКомментарии | Пользователи | Регистрация | Вход:  Пароль:  


Скопировано из документации самой программы «Цитата из Библии» (нажмите 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 это количество глав в книге.


Мы надеемся, что это описание поможет Вам без проблем создать свой модуль. Следите за обновлениями на сайте, т.к. в ближайшем будущем мы хотим выпустить программу для более-менее автоматизированного процесса создания модулей. И, если Вы создали модуль для подключения, смело связывайтесь с нами и посылайте эти модули по электронной почте.


Успешного Вам творчества!


 
Файлов нет. [Показать файлы/форму]
Один комментарий. [Показать комментарии/форму]