Russian:
Плагин подсвечивает ссылки на текст Библии с помощью гиперссылок на сайт Православной энциклопедии "Азбука веры" (http://azbyka.ru/biblia). Текст Библии представлен на церковнославянском, русском, греческом, еврейском и латинском языках. В настройках Вы можете переопределить эти гиперссылки на свой собственный сайт или даже отключить их. А также на толкования Святого Писания Святыми отцами и Учителями Церкви на сайте монастыря Оптина Пустынь (http://bible.optina.ru). В настройках Вы также можете включить отображение ссылок на параллельные места в Библии. Ссылки на параллельные места указаны в конце каждого стиха в фигурных скобках.
Плагин обрабатывает ссылки следующего формата:
- (Ин. 3:16), где «Ин.» - это название книги, 3 - это глава, а 16 - это номер стиха;
- (Ин. 3:16—18) (Книга. Глава: с этого [—] по этот стих);
- (Ин. 3:16—18, 21, 34—36) (Книга. Глава: с этого [—] по этот стих, этот стих, с этого [—] по этот стих);
- (Ин. 3:16—18, 4:4—6) (Книга. Глава: с этого [—] по этот стих, глава: с этого [—] по этот стих);
- (Ин. 3:16—4:6) (Книга. Глава: этот стих [—] по глава: этот стих);
- (Мф. 5—6) (Книга. С этой [—] по эту главу).
Допускается указание ссылок в квадратных скобках и без точки после наименования книги. При указании номера главы (сразу после названия книги) можно использовать запятую вместо двоеточия. Также допускается указывать несколько книг вподряд,используя точку с запятой в качестве разделителя (см.: Зах.4; 2Кор.1:21; 1Ин.2:27). Плагин поддерживает старую нотацию с римскими цифрами в обозначении книг и глав. Пробелы игнорируются.
В настройках плагина Вы можете выбрать языки, на которых будет отображаться текст Библии: церковно-славянский, русский, греческий, латинский и иврит. Для церковно-славянского языка можно также выбрать шрифт: церковно-славянский шрифт, русские буквы ("старый" стиль) или HIP-стандарт. Вы также можете указать, где открывать страницу с текстом Библии - в новом или текущем окне. Для настройки вида ссылок используйте класс bg_bibrefs. Вы можете изменить имя класса в настройках.
При наведении курсора мыши на ссылку отображается всплывающая подсказка содержащая стихи Библии. Вы можете выбрать язык отображения подсказки:
- церковно-славянский (Елизаветинская Библия)
- русский (Синодальный перевод)
- украинский (перевод И.И.Огиенко)
- белорусский (Новый Завет в переводе Библейской Комиссии при Белорусском Экзархате)
- английский (King James Version)
При отключении этой опции вместо стихов отображается номер главы и номера стихов. Вы можете выбрать язык отображения стихов Библии в настройках, по умолчанию устанавливается язык WP. Если Вам необходимо переопределить язык для отдельной заметки, создайте для заметки произвольное поле с именем bible_lang и присвойте ему двухбуквенное обозначение языка. В настройках можно включить опцию позволяющую показывать оригинальные номера стихов в скобках после номера стихов русского Синодального перевода в подсказках и цитатах. Стихи, помеченные звездочкой * отсутствуют в оригинальном переводе. * - отображаются всегда!
Для чтения файлов Библии используются PHP file_get_contents() или fopen() или cURL. Плагин пытается загружать файлы Библии этими методами в указанном порядке. Чтобы сделать загрузку более быстрой отключите лишние методы. Предупреждение: Некоторые методы могут быть недоступны на Вашем сервере. Если Вы разместили свой блог на медленном сервере попробуйте опцию "Предварительная загрузка стихов из Библии во всплывающие подсказки". Предупреждение: Вы можете иметь проблемы с ограничениями Ajax-запросов на сервере.
Если Вы включите опцию 'Преобразовывать ссылки к нормализованному виду', то ссылки на Библию будут заключены в круглые скобки, в них будут удалены лишние пробелы, а названия книг, обозначения глав и стихов будут приведены к стандартному виду, соответствующему восточной традиции.
Самозакрывающийся шорт-код [bible book='Mt' ch='2:3-6' type='verses' lang='ru' prll='on' /] выводит цитаты из Библии в тексте страницы. Здесь: book – обозначение книги, ch – номера глав и стихов, type – формат вывода, lang - язык текста Библии (по умолчанию, язык Библии поста), prll='on'|'off' - вкл.|выкл. отображение ссылок на паралельные места в Библии. Допускается вместо book и ch указать полную ссылку в параметре ref. В этом случае параметры book и ch игнорируются. Если ref='rnd', то выводится случайная цитата из перечня, представленного в файле quotes.txt. Если ref='days', то выводится цитата дня в соответствии с порядковым номером дня в текущем году. Если ref - любое целое число, то выводится цитата, с соответствующим порядковым номером. Вы можете также создать свой собственный перечень цитат в отдельном текстовом файле, разделяя ссылки любыми пробельными символами (пробел, табуляция, перевод строки и т.д.) и указать имя этого файла в настройках плагина. Если type=’book’, то отображаются наименование книги, заголовки глав и стихи, каждый отдельным абзацем, с указанием его номера. Если type=’verses’, то отображаются только стихи, каждый отдельным абзацем, с указанием номера главы и номера стиха. Если type=’b_verses’, то отображаются только стихи, каждый отдельным абзацем, с указанием короткого названия книги, номера главы и номера стиха. Если type=’t_verses’, то отображаются наименование книги и стихи, каждый отдельным абзацем, с указанием номера главы и номера стиха. Если type=’quote’, то отображаются только стихи без деления их на абзацы. Если type=’link’, то отображается ссылка на Библию. Ограждающий шорт-код [bible type='verses' lang='ru']...[/bible] преобразует все ссылки в содержимом в цитаты из Библии. При этом параметры book и ch игнорируются.
Шорт-код [bible_epigraph ref='rnd' lang='ru'] выводит на экран цитату в форме эпиграфа.
Шорт-код [bible_search context='Отче наш' type='verses' lang='ru' prll='on' /] выводит на экран результаты поиска указанной в параметре 'context' фразы. В поисковом запросе можно использовать специальные символы: "$" - 1 любая буква, "%" - 0 или 1 любая буква, "*" - несколько любых букв.
Шорт-код [bible_omnisearch lang='ru' page='{URL}'/] выводит на экран элемент формы, позволяющий пользователю вводить поисковый запрос (см. [bible_search]). В параметре 'page' необходимо указать URL страницы, на которой будут выведены результаты поиска (указан шорт-код [bible_search]). Если параметр 'page' не задан, то подразумевается эта же страница.
Шорт-код [references type='list' separator=', ' list='o' col=1 /] выводит список ссылок на Библию, встречающиеся в статье.
Здесь: type – формат отображения списка (по умолчанию 'list').
Если type=’string’, то список отображается в виде строки в тегах <p>...</p>, при этом используется дополнительный параметр 'separator', в котором указывается разделитель между ссылками (по умолчанию запятая и пробел).
Если type=’list’, то список отображается в виде списка, при этом если дополнительному параметру 'list' присвоено значение 'u', то это ненумерованный список, а если 'o', то - нумерованный(по умолчанию 'o'). В дополнительном параметре 'col' указывается количество колонок(по умолчанию 1).
Если type=’table’, то список отображается в виде таблицы, в дополнительном параметре 'col' указывается количество колонок(по умолчанию 1). Список ссылок выводится в таблице построчно.
Список ссылок выводится на экран в контейнере <div class=”bg_refs_list”>…</div>. Используйте класс bg_refs_list для задания свойств объектов списка.
Шорт-код [norefs]...[/norefs] запрещает подсветку гиперссылок на Библию в тексте, ограниченном этим шорт-кодом. Если необходимо запретить подсветку в заметке в целом создайте рубрику или метку с ярлыком norefs и поместите заметку в эту рубрику/метку, или создайте для заметки произвольное поле с именем norefs и присвойте ему произвольное значение.
Чтобы выделить текст стихов в подсказке для последующего копирования в буфер обмена просто щелките мышью в области стихов, например, по номеру стиха. А затем используйте Ctrl+C или контекстное меню для копирования.
Плагин содержит 3 виджета: * Виджет "Ссылки на Библию" позволяет разместить в сайдбаре форму для вывода текста цитат из Библии на странице Вашего сайта. * Виджет "Поиск в Библии" позволяет разместить в сайдбаре форму для поиска слова или фразы Библии. * Виджет "Цитата из Библии" выводит в сайдбаре Случайную Цитату или Цитату Дня из Библии, аналогично тому, как это делает шорт-код [bible_epigraph].
English:
The plugin will highlight references to the Bible text with links to site of Orthodox encyclopedia "The Alphabet of Faith" (http://azbyka.ru/biblia). The Bible is presented in Church, Russian, Greek, Hebrew and Latin. In the settings, you can redirect the hyperlink to your own website, or even turn off them. And also on the interpretation of Holy Scripture by the Holy Fathers and Doctors of the Church on the site of Optina Pustyn monastery (http://bible.optina.ru). In the settings you can also choose to display references to parallel passages in the Bible. Links to parallel passages are listed at the end of each verse in the curly brackets.
The plugin handles the references with the format:
- (Ин. 3:16), where «Ин.» - book title, 3 - chapter, а 16 - verse number;
- (Ин. 3:16—18) (Book. Chapter: from this verse [—] till this verse);
- (Ин. 3:16—18, 21, 34—36) (Book. Chapter: from this verse [—] till this verse, this verse, from this verse [—] till this verse);
- (Ин. 3:16—18, 4:4—6) (Book. Chapter: from this verse [—] till this verse, chapter: from this verse [—] till this verse);
- (Ин. 3:16—4:6) (Book. Chapter: this verse [—] till chapter: this verse);
- (Мф. 5—6) (Book. From this chapter [—] till this chapter).
You can specify the reference in brackets and without a point after the title of the book. If you specify a chapter (after the title of the book), you can use comma instead of colon. Also you can specify a few books in row using semicolon as the separator (см.: Зах.4; 2Кор.1:21; 1Ин.2:27). The plugin supports the old notation with Roman numerals in naming books and in chapters. Spaces are ignored.
In the plugin settings you can select the languages in which the text will be displayed Bible: Church Slavic, Russian, Greek, Latin and Hebrew. For the Church Slavonic language, you can also select a font: Church Slavic font, Russian letters (the "old" style) or HIP-standard. You can also specify where to open a page with the Bible text - in new or current window. To customize the appearance of reference links, use class bg_bibrefs. You can change the class name in the settings.
When you hover your mouse over the link displayed tooltip containing the Bible verses. You can select the language for tooltip:
- Church Slavic (Elizabeth Bible)
- Russian (Synodal translation)
- Ukrainian (translation by I.I.Ogienko)
- Belarusian (New Testament translated by Biblical Commission of the Belarusian Exarchate)
- English (King James Version)
If you disable this option, the number of the chapter and verse numbers will displayed instead of verses. You can change the language for display of the Bible verses in the settings (default - language WP). If you need to override the language for a single post, create a custom field for the post with a name bible_lang and set it two-letter language code. In the settings you can turn on the option allows you to show the original verse numbers in parentheses after the verse numbers of Russian Synodal Translation in the tooltips and quotes. Verses marked with asterisk '' are absent in the original translation. '' - always visible!
To read Bible files used PHP-functions cURL or file_get_contents() or fopen(). Plugin tries to read Bible files with one of this methods in the order listed. To do the reading faster, disable unnecessary methods in settings - you need one only. Warning: Some methods may not be available on your server. If you placed your blog on a slow server try the option "Preload Bible verses in tooltips". Warning: you can have problem with ajax-requests limiting on the server.
If you enable the 'Convert References to the normalized form', the Bible references will within brackets, there are removed extra spaces, and the book titles, chapters and verses will be have the standard form corresponding to the Eastern tradition.
Self-closing shortcode [bible book = 'Mt' ch = '2 :3-6 'type =' verses' lang='ru' prll='on' /] displays quotes from the Bible in the text of the page. Here: book - the designation of the book, ch - numbers of chapters and verses, type - the output format, lang - language of the Bible, prll='on'|'off' - turn on|off links to parallel passages in the Bible. Allowed instead of 'book' and 'ch' specify the full reference in the parameter 'ref'. In this case, the parameters 'book' and 'ch' are ignored. If ref = 'rnd', it displays a random quote from the list in the file quotes.txt. If ref = 'days', it displays the quote of the day according with the serial number of the day in the current year. If ref - any integer, it displays a quote with the appropriate serial number. Also you can create your own list of quotes in a text file, by separating references with any white spaces (space, tab, newline, etc.), and then specify filename in the plugin settings. If type = 'book', it displays the name of the book, chapter and verse in separate paragraph with verse number. If type = 'verses', it displays only the verses in separate paragraph with chapter number and verse number. If type = 'b_verses', it displays only the verses in separate paragraph with short book title, chapter number and verse number. If type = ’t_verses’, it displays the name of the book and verse in separate paragraph with chapter number and verse number. If type = 'quote', it displays only the verses without dividing them into paragraphs. If type=’link’, it displays Bible reference. Enclosing shortcode [bible type = 'verses' lang='ru'] ... [/ bible] converts all references in content to quotes from the Bible. The parameters of the book and ch ignored.
Shortcode [bible_epigraph ref = 'rnd' lang = 'ru'] displays the quote in the format of epigraph.
Shortcode [bible_search context = 'Our Father' type = 'verses' lang = 'ru' prll='on' /] displays the search results of phrase (parameter 'context'). In the search query you can use wildcards: "$" - 1 аny letter, "%" - 0 or 1 аny letter, "*" - more any letters.
Shortcode [bible_omnisearch lang = 'ru' page = '{URL}' /] displays a form element, allowing the user to enter a search query (see: [Bible_search]). In the parameter 'page' you must specify the URL of the page where search results will be displayed (specified shortcode [bible_search]). If the parameter 'page' is not set, it means the same page.
Shortcode [references type = 'list' separator = ',' list = 'o' col = 1 /] displays list of Bible references are finded in the article.
Here : type - list display format(default 'list').
If type = 'string', the list is displayed as string in tags <p>...</p>, the additional parameter 'separator' contains the separator between the references (default comma and space).
If type = 'list', the list is displayed as list, if the additional parameter 'list' is set to 'u', then this is an unordered list, and if it is 'o', then - numbered (default 'o'). Аdditional parameter 'col' specifies the number of columns (default 1).
If type = 'table', the list is displayed as table, additional parameter 'col' specifies the number of columns (default 1). List of links displayed in the table by line.
A list of references displayed in the container <div class="bg_refs_list"> ... </div>. Use bg_refs_list class to set the properties of list objects.
Shortcode [norefs]...[/norefs] prohibits highlighting the Bible references in the text enclosed with this shortcode. If you want to disable highlight of Bible references in the whole post, create a category or tag with a label norefs and place a post in this category/tag, or create custom field with name norefs for this post and set it any value.
To select verses text in tooltip for later copying to the clipboard click the left mouse button in the verse field, for example, on verse number. And then use Ctrl+C or the context menu for copy.
The plugin contains 3 widgets: * Bible References Widget allows you to place the form in the sidebar to display Bible quotes on the page of your site. * Bible Search Widget allows you to place the form in the sidebar to search for words or phrases in the Bible. * Bible Quote Widget in the sidebar displays a Random Quote or Day's Quote from the Bible the same way as it makes the shortcode [bible_epigraph].