Руководство пользователя

ЦИТАТА ИЗ БИБЛИИ 4.0

РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
"... Притом же ты из детства знаешь священные писания, которые могут умудрить тебя во спасение верою во Христа Иисуса. Все Писание богодухновенно и полезно для научения, для обличения, для исправления, для наставления в праведности, да будет совершен Божий человек, ко всякому доброму делу приготовлен" (2Тим.3:15-17).

_____________________________________

Bible Quote © BibleRussia.org, http://biblerussia.org/software
THTMLViewer © David Baldwin, http://www.pbear.com

1. Коротко о программе "Цитата из Библии"
2. Требования к ресурсам компьютера
3. Использование программы "Цитата из Библии"

   ... | Список клавиш быстрого доступа
   | Просмотр отрывков
   | Поиск по словам и фразам
   | Цитирование
   | Закладки
   ... | Личные заметки
   ... | Параллельные места
   ... | Быстрый доступ к любимым модулям
   | Общая навигация: окна и журнал работы
   | Распечатка на принтере
   | Сохранение, открытие файлов HTML
   | Звуковое сопровождение текстов Библии

4. Организация данных в программе "Цитата из Библии"
5. Создание дополнительных подключаемых модулей
6. Благодарность; контактные адреса
7. Подписка на получение сообщений о выходе новых версий
8. P.S: Для программистов - компонент TBible

_____________________________________

## 1. Коротко о программе "Цитата из Библии"

Программа "Цитата из Библии", была разработана для быстрого доступа к текстам Библии, для их цитирования и последующего вставления в другие документы, редактируемые на компьютере. Впоследствие она была развита до системы просмотра, поиска и изучения не только текстов Библии, но и других книг, тексты которых достаточно просто можно подключать к программе в виде модулей (см. раздел о создании модулей). Читая эти тексты, Вы можете оставлять свои заметки, ставить закладки на любимых местах или возвращаться к уже посещенным местам через механизм "журнала работы". Журнал запоминает открытые Вами места в течение достаточно продолжительного времени. Для текстов Библии работает система параллельных (гипер)ссылок, которая идентична ссылкам в печатной Библии. Переход по этим ссылкам осуществляется с помощью механизма гиперссылок, похожих на ссылки в Интернете.

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

Программа развивается благодаря советам пользователей. Дополнительные модули создаются также пользователями и могут распространяться либо через наш сайт, либо через сайты самих пользователей. Благодаря открытости своей системы данных программы "Цитата из Библии", модули может создавать практически любой пользователь.

В содержание

## 2. Требования к ресурсам компьютера

На компьютере должна быть установлена 32х-разрядная операционная система Windows. Это может быть любой из следующих вариантов: Windows 95, Windows 98, Windows NT 4.0 или Windows 2000 и последующие за ней версии. К оперативной памяти и скорости процессора у нас нет особых требований - но желательно иметь Pentium 100 с 16 Мбайтами оперативной памяти. Для размещения стандартного модуля Библии (с параллельными местами) на жестком диске понадобится примерно 4,5 Мбайта. Для самой программы и документации - около 800 Кбайт. Каждый новый модуль библейского перевода или какой-либо другой книги займет у Вас дополнительное место на диске. Однако программа умеет работать с компакт-дисками, и Вы можете хранить часть книг на жестком диске, а часть на компакт-диске, с которого Вы будете считывать время от времени дополнительные книги.

В содержание

## 3. Использование программы "Цитата из Библии"

Авторы старались сделать максимально простой интерфейс для программы "Цитата из Библии", так что опытный пользователь Windows может даже не читать документацию. :о) Доступ ко всем функциям осуществляется через меню программы, через кнопки панели управления и т.д. К пунктам диалоговых окон есть подробные подсказки. Однако в следующих абзацах мы все же подробно расскажем о возможностях программы и о некоторых тонкостях интерфейса, которые помогут Вам эффективно использовать нашу программу.

### 3.0. Список клавиш быстрого доступа

F1 | Помощь - показ этой документации
F2, Ctrl+G (Go) | Выбор отрывка
Ctrl+R (Random) | Открыть случайное место - качество не гарантируем :о)
Ctrl+F1, Ctrl+Z (previouZ) | Назад на одну главу
Ctrl+F2, Ctrl+X (neXt) | Вперед на одну главу
F3, Ctrl+F (Find) | Поиск по словам и фразам
F4, Ctrl+N (New) | Создать новое окно просмотра
Ctrl+F4, Ctrl+W (Wipe) | Закрыть текущее окно просмотра
Ctrl+Tab, Shift+Ctrl+Tab | Переход между окнами (слева направо и обратно)
F5, Ctrl+C (Copy) | Копировать выделенное в буфер обмена Windows
F6, Ctrl+B (Bookmarks) | Выбрать закладку из сохраненных
Ctrl+F6, Ctrl+D (Define bookmark) | Создать закладку на текущий отрывок
F7 | Показать/спрятать личные заметки
F8 | Показать/спрятать параллельные места (в Библии)
F10, Ctrl+H (History) | Журнал работы
Ctrl+F10, Ctrl+L (Listen) | Прослушать звукозапись (если есть)
F11, Ctrl+P (Print) | Распечатать на принтере
Ctrl+F11, Ctrl+V (preView) | Предварительный просмотр печати
F12, Ctrl+S (Save) | Сохранить в файл
Ctrl+F12, Ctrl+O (Open) | Открыть HTML-файл

В содержание

### 3.1. Просмотр отрывков

При нажатии на эту кнопку (или при выборе соответствующего пункта меню "Операции") появляется диалоговая панель для выбора книги и главы. Для текстов Библии есть возможность быстро ограничить список книг до рамок "Ветхого Завета", "Нового Завета" или "Неканонических книг". Также можно вводить короткие адреса отрывка, например, "Быт.1", "Ин.3:16", "1Кор.15:1-11" и т.д. Программа понимает различные варианты сокращения названий книг (варианты задаются составителем модуля).

Внимание: диалоговая панель выбора отрывка "всплывает" во время работы при нажатии на любую буквенную клавишу. Эта опция предусмотрена для более быстрого доступа к этой часто используемой панели.

Горячие клавиши: F2 и Ctrl+G

В содержание

### 3.2. Поиск по словам и фразам

Эта кнопка вызывает диалоговую панель поиска. Человеческая память не долговечна, поэтому нам нужно часто прибегать к функции поиска, чтобы найти, где встречается то или другое слово или конкретная фраза. Например, введя фразу "не видел того глаз" и нажав кнопку "Найти", мы найдем одно единственное место в Синодальной Библии, где написано: "не видел того глаз, не слышало ухо, и не приходило то на сердце человеку, что приготовил Бог любящим Его". (1-е Коринфянам 2:9)

В диалоговой панели поиска можно увидеть разные варианты уточнения того, что Вы ищете. Если Вы уверены, что запомнили правильно фразу (как в предыдущем случае), Вы можете уверенно ставить параметры "слова идут в заданном порядке" и "выражения не могут быть частями слов". В ином случае оставьте все опции неотмеченными и только ограничьте диапазон поиска. Программа может также вывести либо все результаты поиска, либо первые 100, первые 200 или первые 300 результатов. Отметим тот факт, что при количестве результатов, превышающем 1000, окно просмотра будет работать медленно и вероятность того, что Вы сможете разобраться в большом количестве выданных программой ссылок, не велика. Поэтому мы советуем Вам использовать эти ограничители на 100, 200 или 300 результатов.

Результаты поиск выдаются в страницу с гиперссылками на найденные стихи, чтобы Вы могли перейти в содержащие их отрывки, чтобы понять стихи в контексте. Текст стихов включается в выдаваемые результаты, чтобы Вы могли сразу копировать их (в другую программу, например). При нажатии на гиперссылку Вы попадаете в другое место в модуле. Чтобы вернуться на страницу результатов, можно использовать первый пункт контекстного меню (правая кнопка мышки) - "Вернуться к предыдущей странице" или "Журнал работы".

Горячие клавиши: F3 и Ctrl+F

В содержание

### 3.3. Цитирование

Наша программа называется "Цитата из Библии" не потому что, что это сборник цитат - как думали в первое время некоторые пользователи :о) - а потому что программа в основном используется нами для извлечения отрывков из Библии и вставления их в другие документы, редактируемые одновременно на компьютере.

При наличии выделенного мышкой текста, кнопка копирования просто копирует текст в буфер обмена Windows так, как это делают все другие программы. Но если отмеченного текста нет, то производится "специальное" копирование отрывка, с соединением всех стихов в один абзац и присоединением координат, сообщающих, "откуда это было взято".

Можно также использовать контекстное меню правой кнопки мышки для того, чтобы скопировать отдельно взятый стих или скопировать отрывок, который был предварительно выделен мышкой. Программа умеет определять, к какому отрывку принадлежит выделенный текст, поэтому для того, чтобы через контекстное меню скопировать отрывок, скажем от стиха 3 до стиха 5, нужно выделить лишь часть стиха 3, весь стих 4 и часть стиха 5.

В меню конфигурации вариантов копирования можно выбрать: копировать ли номера стихов, вставлять полные названия книг или только их сокращения, а также другие параметры. Горячие клавиши: F5 и пункты контекстного меню (правая кнопка мышки). Кроме этого работают стандартные комбинации Windows: Ctrl+C, Ctrl+Insert.

В содержание

### 3.4. Закладки

Как и при чтении обычных книг, в программе "Цитата из Библии" Вы можете оставлять закладки на местах, к которым Вы хотите позднее вернуться. Это можно сделать либо через контекстное меню, поставив закладку на конкретный стих, либо поставить закладку на весь текущий отрывок через пункт меню "Операции - Поставить закладку на текущий отрывок".

При нажатии на кнопку "Закладки" Вы увидите список всех существующих на данный момент закладок. Если их пока нет, то нажатие на кнопку ничего не даст. В открытом списке закладок можно удалить закладку, которая Вам больше не нужна, нажав на клавишу Delete.

Маленький секрет: кнопка "Закладки" также используется для быстрого добавления закладки на текущий отрывок. Придерживая клавишу Shift, нажмите на эту кнопку. Откроется диалоговое окно для введения описания Вашей закладки. По умолчанию программа вставляет в это окно несколько слов из выбранного места. Однако Вы можете вставлять туда свои предложения, например: "Это нужно прочитать еще раз!", "Здесь хорошо написано о любви Бога...", и т.п.

Горячие клавиши: F6, Ctrl+F6 и пункты контекстного меню (правая кнопка мышки).

В содержание

### 3.5. Личные заметки

Кроме закладок, о которых мы говорили в предыдущем пункте, Вы можете также оставлять свои личные заметки или помечания к местам, которые Вы читаете. Это можно сделать через контекстное меню, выбрав пункт "Редактировать заметку..." После добавления, заметка появится в тексте, будучи выделенной особым цветом. Включать и выключать показ заметок можно через клавишу F7 или через соответствующий пункт главного или контекстного меню "Личные заметки".

Чтобы удалить введенную ранее заметку, нужно встать на то место и включить редактирование заметки. После этого в окне редактирования нужно стереть ранее введенный текст.

Горячие клавиши: F7 (вкл/выкл) и пункты меню.

В содержание

### 3.6. Параллельные места

Параллельные места в Библии, указывающие из одного стиха в другой стих Библии, являются сами по себе гипертекстовой системой подобно Интернету. Поэтому в нашей программе мы реализовали их в виде гиперссылок, появляющихся после каждого стиха, к которому есть параллельное место в Библии. Для включения и выключения отображения параллельных ссылок нажмите F8 или выберите пункт из меню "Операции", или же из контекстного меню. Горячие клавиши: F8 (вкл/выкл) и пункты меню.

В содержание

### 3.7. Быстрый доступ к любимым модулям

Вызвав пункт "Выбрать любимые модули" из меню "Любимые модули", Вы можете назначить модули, которое можно будет включать по 10 клавишам Ctrl+1, Ctrl+2, ..., Ctrl+0. А теперь самое интересное. Присвоив, к примеру, комбинацию Ctrl+1 модулю русской Библии, а Ctrl+2 - модулю Библии английской, Вы сможете, находясь в некотором отрывке русской Библии быстро посмотреть английский перевод, нажав Ctrl+2, а потом посредством Ctrl+1 вернуться обратно. Таким образом, "Цитата" как бы становится Вашим очень быстрым библейским переводчиком. :о)

Мы надеемся, что скачав дополнительные модули с нашего сайта или создав свои собственные, у Вас будет достаточно много модулей, чтобы назначить любимые этим 10 клавишным комбинациям: Ctrl+1, Ctrl+2, ..., Ctrl+0.

В содержание

### 3.8. Общая навигация: окна и журнал работы

В нашей программе мы используем не многооконный интерфейс, а многостраничный, где все окна-страницы равноправны. Такие же страницы Вы видите в разных диалогах настройки Windows. Создание, закрытие окно просмотра осуществляется нажатием на соответствующие кнопки на панели или на клавиши Ctrl+N (создать) и Ctrl+W (удалить). В любое окно можно открыть текст из любого модуля или же из файла HTML на диске. Навигация между окнами-страницами осуществляется нажатием на соответствующем "ушке", или же комбинациями Ctrl+Tab, Ctrl+Shift+Tab.

Во время работы программа протоколирует Ваши действия, сохраняя адреса последних 200 отрывков или файлов, которые Вы открыли. Нажав на кнопку истории или клавишу F10, Вы можете попасть в журнал работы, где можно выбрать нужный отрывок. Список отсортирован в обратном порядке, самые новые адреса храняться вверху для удобства.

Горячие клавиши: F10 (история) и Ctrl+N, Ctrl+W, Ctrl+Tab, Ctrl+Shift+Tab (окна просмотра).

В содержание

### 3.9. Распечатка на принтере

Текст, открытый в нашей программе, можно распечатать на Вашем принтере. В программе также предоставляется функция предварительного просмотра.

Горячие клавиши: Ctrl+P, F11 (печать) и Ctrl+V, Ctrl+F11 (предварительный просмотр).

В содержание

### 3.10. Сохранение, открытие файлов HTML

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

Горячие клавиши: Ctrl+S, F12 (сохранение) и Ctrl+O, Ctrl+F12 (открытие файла).

В содержание

### 3.11. Звуковое сопровождение текстов Библии

Вы можете приобрести у авторов вариант на компакт-диске с аудио-записями Библии, прочитанными диктором. Такой способ слушания Слова Бога может очень помочь в те моменты, когда Вы физически устали или не настроены на работу за компьютером, или же когда Вы хотите сосредоточиться только на Слове, а не на красивом оформлении компьютерных программ. Если у Вас есть компакт-диск или звуковые файлы, сохраненные на жестком диске, то при нажатии на кнопку прослушивания, а также при нажатии на Ctrl+F10 или Ctrl+L, Вы можете прослушать звук к главе, которая в данный момент открыта на экране. Для проигрывания, "Цитата из Библии" использует аудио-плейер, установленный по умолчанию в Вашем компьютере.

Горячие клавиши: Ctrl+L, Ctrl+F10

В содержание

_____________________________________

## 4. Организация данных в программе "Цитата из Библии"

Комплект программы "Цитата из Библии" 4.0 состоит из файлов bibleqt4.exe, файлов russian.lng + english.lng для переводов меню и системных сообщений, xref.dat (база данных о параллельных местах) + файлы в папке help (документация). Модули находятся в поддиректориях той папки, где находится bibleqt4.exe. Часть модулей может находиться по дополнительному пути, который можно задать через меню "Настройки" - это может либо другая папка на компьютере, либо компакт-диск. По тому пути, в поддиректориях находятся модули так же, как они находились бы в директории самой программы. Данные о размерах окна программы, о цветах и о других пользовательских настройках хранятся в файле bibleqt.ini в системной директории Windows. Другие данные, а именно закладки, личные заметки и журнал работы хранятся в файлах под именами bible_bookmarks_.ini + bible_memos_.ini + bible_history_.ini, где вместо стоит то имя, под которым Вы зарегистрированы в системе Windows. Если же на компьютере операционная система зарегистрирована только на одного пользователя, то вместе стоит "default".

В содержание

## 5. Создание дополнительных подключаемых модулей

Как мы уже говорили, каждый модуль находится в своей директории. Файлы модуля должны быть в текстовом виде, но расширение может быть любым, например, TXT или HTM. Модуль может быть либо одной большой книгой (как в случае Библии), либо собранием книг одного автора. В любом случае, каждая часть модуля содержится в отдельном файле, внутри которого есть разбиение на главы и стихи (абзацы, если это не Библия).

Для того, чтобы "Цитата" могла опознать модуль, в директории модуля должен быть файл bibleqt.ini. Опытные пользователи могут просто заглянуть в любой из таких файлов, поставляемых с нашими модулями, чтобы понять, "что к чему". Здесь мы на примере файла для модуля русской Библии разберем все параметры, которые прописываются в этом файле.

    BibleName = Русский Синодальный текст (современная редакция)
    BibleShortName = RST

BibleName определяет полное название модуля, а BibleShortName - его сокращение при показе на "ушках" окон просмотра.

    Bible = Y
    OldTestament = Y
    NewTestament = Y
    Apocrypha = Y

Эти параметры сообщают, является ли модуль переводом Библии или нет, а также, если это перевод Библии, то есть ли в нем Ветхий Завет, Новый Завет и Апокрифы (неканонические книги). В случае отрицательного ответа, значение параметра равно N (от слова No).

    HTMLFilter = <img

Здесь можно прописать дополнительные тэги, которые будут активны в этом модуле. Благодаря этому параметру, можно даже заставить "Цитату" показывать изображения (иллюстрации) в тексте модуля! "Цитата из Библии" по умолчанию показывает HTML-тэги заголовков, выделения жирным или наклонным шрифтом. Внимание, если это не закрывающийся тэг типа <a href... то надо писать:

    HTMLFilter = <a </a>

Маленький секрет: таким образом, можно ссылаться из одного модуля в другой. Например:

    Автор говорит: Бог сотворил небо и землю.
    (ср. <a href="go russian 1 1 1>Быт.1:1</a>)

Следующий параметр это набор букв национального альфавита:

    Alphabet = АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя

Это буквы используются при поиске, другие будут игнорироваться.

    //DesiredFontName=Comic Sans MS
    DesiredFontCharset=204

В некоторых модулях, например, Библия на корейском языке, это жизненно важно, потому что изменение шрифта недостаточно. А точнее, нужно в принципе только изменение кодовой страницы, чтобы система подставила нужный шрифт. Для книг и переводов Библии на русском или английском языке, можно уверенно ставить кодовую страницу 204 (RUSSIAN_CHARSET).

    ChapterSign = A NAME
    VerseSign = <SUP>

Здесь вся изюминка программы "Цитата из Библии", а точнее ее открытого механизма подключения модулей. У каждого модуля может свой признак разбиения на главы и на стихи (абзацы). Главное, чтобы во всех файлах модуля разбиение было однотипным. Тогда в bibleqt.ini Вы можете прописать эти признаки. Будьте внимательны, т.к. если описывать не точно, то признак стиха может быть частью признака главы или наоборот, например

    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 это количество глав в книге.

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

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

В содержание

## 6. Благодарность; контактные адреса

В первую очередь мы благодарим Бога и Господа нашего Иисуса Христа за все! Только благодаря Ему мы можем использовать все наши способности для нетленной цели. Мы также благодарим всех авторов христианских программ, творчество которых вдохновило нас на создание своей программы. Особенно, это касается Larry Pierce (Online Bible) и Kevin Rintoul (God's Word for Windows). Мы также благодарим Алексея Руденко, дистрибутора Online Bible в России за ранее предоставляемое нам место на сайте http://www.bible.ru. Теперь мы имеем свой адрес http://biblerussia.org. Посещайте христианские проекты BibleRussia.org! Например, по адресу http://biblerussia.org/music находится другой наш проект - христианские песни в электронном виде, с нотами и словами, а также MIDI архив. А по адресу http://biblerussia.org/forums находятся форумы, где Вы можете обсудить вопросы духовной жизни и получить ответы на интересующие Вас вопросы.

Наш адрес электронной почты software@biblerussia.org. Мы будем очень рады принять Ваши замечания и предложения!

В содержание

## 7. Подписка на получение сообщений о выходе новых версий

Для получения сообщений о выходе новых версий или других программ, написанных нами, напишите пустое письмо по адресу: BibleSoftware-subscribe@listbot.com. Почтовый сервис ListBot пошлет Вам письмо с просьбой (на английском языке!) о подтверждении подписки. Для подтверждения достаточно нажать кнопку Reply (Ответить) в почтовой программе и отправить этот ответ, ничего не добавляя. Получив такой Ваш ответ, сервер автоматически добавит Вас в список для рассылки новостей. Мы обещаем не использовать Ваши адреса для других целей, кроме как рассылки новостей об обновлении программы. Если Вы зарегистрировались в списке рассылки, но затем решили выйти из него, то пошлите пустое письмо на адрес BibleSoftware-unsubscribe@listbot.com.

А ТЕПЕРЬ...

ВСЕГО ХОРОШЕГО!

БОЛЬШЕ ВСЕГО МЫ ЖЕЛАЕМ ВАМ ВЕРОВАТЬ В НАШЕГО БЛАГОГО ГОСПОДА ИИСУСА ХРИСТА И ОБРЕСТИ ВЕЧНУЮ ЖИЗНЬ В НЕМ. ПУСТЬ СЛОВА БИБЛИИ, КОТОРЫЕ НЕСЕТ ЭТА ПРОГРАММА, ДАДУТ ВАМ ДУХОВНЫХ БЛАГ В ЭТОЙ И В ВЕЧНОЙ ЖИЗНИ. АМИНЬ.

В содержание

## 8. P.S: Для программистов - компонент TBible

По адресу http://biblerussia.org/software/tbible.zip находится созданный нами компонент TBible, который отвечает за извлечение текста из модулей и поиск в них. Структура компонента достаточно простая, но если у Вас возникнут вопросы, пишите нам. Мы также будем рады принять предложения по его улучшению и оптимизации.

В содержание

P.P.S. Если Вы обнаружили ошибки в документации, пожалуйста, простите нас за оплошность и сообщите нам об этом :о) Спасибо!