Файл textobraile.dat

Введение, constants.ini, symbols.dat, Горячие клавиши, Ограничения, ошибки и недостатки текущей версии

Синтаксис

Каждая запись в этом файле имеет вид: "макрос=описание". Каждая запись должна обязательно начинаться с новой строки. Каждая запись должна начинаться со знака "\" (back slash) и с первой позиции строки. Строки с комментариями могут начинаться с любого символа кроме символа "\" (back slash). Комментарий должен находиться выше или ниже описываемого макроса и не может находиться на одной строке с макросом. При описании греческих букв, тригонометрических функций и т.д. надо использовать русские буквы. Если в этих ситуациях использовать латинские буквы, то при обработке перед ними будут поставлены признаки латинских букв. Файл должен быть в Windows кодировке.

Все записи можно разделить на три категории: простые подстановки, сложные подстановки, Заголовки.

Простые подстановки. Эта категория объединяет макросы, неимеющие аргументов. В брайлевском тексте их надо либо просто заменить на какой-нибудь брайлевский знак, либо вообще убрать из текста. К таким макросам относятся, например, названия тригонометрических функций, знак интеграла, суммы, произведения, логорифм и др.
Пример:
\sin=яс
\log=ял
\sum=|с
..........
Если какой-нибудь макрос требуется убрать из текста, надо после знака равенства поставить ключевое слово "IGNORE" (без кавычек, Обязательно заглавными буквами).
Пример:
\qquad=IGNORE
\,=IGNORE
..........

В эту же категорию можно отнести обработку шрифтовых выделений. В данной версии программы (1.0) признаки шрифтовых выделений не ставятся, А из исходного файла шрифтовые выделения просто убираются. Для этого существует ключевое слово "FONT".
Пример:
%убрать жирный шрифт:
\bf=FONT
Обработка заключается во-первых в удалении самого макроса "\bf", а во-вторых в удалении пары фигурных скобок, ограничивающих фрагмент текста. Этим же ключевым словом можно пользоваться в тех случаях, когда требуется удалить макрос, аналогичный по записи макросам шрифтов.
Пример:
Теорема Пифагора: {\bf сумма квадратов катетов равна квадрату гипотинузы}.

Сложные подстановки. Сюда относятся макросы с одним или несколькими аргументами. Описание таких макросов имеет вид:
макрос=[количество_аргументов]...#1///#2///#3//////
в квадратных скобках указывается количество аргументов. Максимально их может быть 9. После закрывающей квадратной скобки надо указать брайлевскую запись, эквивалентную исходному макросу. Вместо конкретных цифр, названий функций и т.д. используются сочетания символов: знак "#" (решётка) и номер аргумента (цифра от 1 до 9).
Пример:
\frac=[2];#1 ю#2$
\mathbin=[1]#1
Внимание! Описание этих макросов чувствительно к наличию пробелов: от знака равенства до закрывающей квадратной скобки пробелов не должно быть! От закрывающей квадратной скобки и до конца строки все пробелы, присутствующие в описании, будут присутствовать в выходном тексте.

Заголовки, нумерация формул и ссылки на них. В зависимости от объёма текста и его стиля он может состоять из одного раздела, из одного раздела с несколькими логически подчинёнными подразделами, или иметь сложную структуру с несколькими разделами первого уровня и несколькими логически подчинёнными подразделами более высоких уровней. обработка лразделов текста заключается в расстановке номеров разделов. Нумерация может быть абсолютной или логически подчинённой.
Пример:
\section=HEADER2(0)
Это означает, что разделу документа помеченному макросом \section присваивается второй логический уровень. число ноль в круглых скобках говорит о том, что нумерация разделов данного уровня будет абсолютной (сплошной) на протяжении всего документа. номера начинаются с "1" и заканчиваются номером "n".
Пример:
\subsection=HEADER3(2)
\subsubsection=HEADER4(23)
Здесь разделу, помеченному макросом \subsection, присваивается третий логический уровень. Число "2" в круглых скобках говорит о том, что нумерация этих подразделов подчинена нумерации разделов, имеющих второй логический уровень. То есть в каждом разделе \section нумерация подразделов \subsection начнётся с "1". Номер подраздела \subsection имеет вид:
1. Группы, кольца, поля. 1.1. Группы.
..........
1.2. Кольца
..........
1.3. Поля
..........
2. Ряды
2.1. Признаки сходимости
..........
2.2. Дифференцирование рядов
..........
..........
Если в круглых скобках стоят две или три цифры, то номер данного подраздела имеет вид:
1.1.1. Определение и основные свойства.
..........
1.1.2. Примеры полугрупп и групп
..........
1.1.3. Центр и централизатор группы
..........
..........

Нумерация формул и ссылки на них. В файле textobraile.dat обязательно должна присутствовать запись вида:
\label=LABEL(2)
Цифра в круглых скобках говорит, к какому логическому разделу документа привязана нумерация формул. В данном случае нумерация привязана к разделу \section, то есть в каждом таком разделе нумерация начинается с "1". Для расстановки ссылок используется ключевое слово REFERENCE (обязательно заглавными буквами).
\ref=REFERENCE.