ChiWriter to RTF Converter (Russian, Win-1251)

Конвертер файлов из ChiWriter в Microsoft Word

Инструкция к программе

0. Общие замечания
1. Что программа делает
2. Что программа умеет и чего не умеет
    2.1. Что программа умеет
    2.2. Чего программа не умеет
3. Описание шрифтов
    3.1. Общие замечания
    3.2. Описание формата файлов *.WIN
4. Комплект поставки
5. Разное

0. Общие замечания

0.1. Программа писалась для себя. Этим объясняются убогость диагностики и скудость комментариев в исходном тексте. C'est la vie.

0.2. Как все кайрайтерное, программа требует муторной настройки на шрифты. Cоветую не лениться: даже если в полученной Вами пачке файлов есть описания для шрифтов с Вашими именами - проверить еще раз, те ли это шрифты. В шрифтах от ChiWriter стандартности столько же, сколько в осколках от чашки: если не от одной и той же - никогда не подойдут, как бы похожи ни были.

0.3. Программа делалась для применения в конкретной задаче: перевод в приличный вид очень большого массива текстов по лингвистике. Отсюда - внимание к текстовому оформлению и небрежная работа со сложными индексами. Это несложно исправить; желающие - читайте исходный код.

0.4. Все замечания, предложения и т.п. просьба направлять мне - Николаю Григорьеву по адресу grig@iitp.ru. Вправду, не стесняйтесь, обращайтесь - буду рад. Ну а если кто-то вдруг решится добавить недостающие функции (обработку таблиц, составных символов и т.п.) - большая просьба поделиться исходным текстом.

0.5. (disclaimer). Вот Вам программа, вот Вам текст, делайте со всем этим что хотите. Но если что-нибудь случится - я не виноват! Единственная просьба: будете кому-нибудь ее давать - обязательно отдайте исходный текст и эту вот инструкцию.

1. Что программа делает

Программа по мере сил переводит файлы из формата ChiWriter 3.1* в формат RTF (в варианте Word 6.0 / Word 95 / Word 97). У командной строки - два аргумента: имя файла ChiWriter (обязательный) и имя выходного файла (необязательный). Никакого расширения по умолчанию для входного имени нет, так что расширение тоже надо указывать. Если имя выходного файла не задано, то оно делается из имени входного заменой его расширения на .RTF.

Для работы программы сам ChiWriter не нужен, но нужно описание используемых ChiWriter'ных шрифтов. Как его составить и куда положить - см. п. 3.

2. Что программа умеет и чего не умеет

2.1. Программа умеет:

переводить абзацы ChiWriter в абзацы RTF;

заменять символы ChiWriter на символы из TrueType-шрифтов в соответствии с файлом описания шрифта;

обрабатывать верхние и нижние индексы;

убирать мягкие пробелы;

обрабатывать переносы (при условии, что они сделаны через форматирование абзаца);

обрабатывать подстрочные сноски;

обрабатывать колонтитул по умолчанию (в частности, вставлять номер страницы);

обычно правильно определять межстрочный интервал в абзаце, отступ перед/после абзаца и центровку;

обрабатывать разрядку, сделанную с применением невидимых символов ChiWriter (вместо них можно вставить неразрывные пробелы).

2.2. Программа не умеет:

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

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

обрабатывать специальным образом таблицы, графику и многоэтажные формулы. Они обрабатываются так, как если бы они были составлены из обычных символов в соответствии с их описаниями; результат в большинстве случаев грубо неправильный. Особенно дико выглядят таблицы: если, как это часто бывает, таблица сделана на одной очень широкой строке, то все расположенное в одной колонке считается индексами и пишется в пресловутые скобки <! ... !>. Это настолько ужасно, что я рекомендую как-то препарировать таблицы, прежде чем отдавать их на съедение программе. Например, можно сделать каждую клетку таблицы отдельным абзацем, а потом в Word преобразовать соответствующую часть обратно в таблицу - благо, это можно сделать автоматически.

обрабатывать множественные колонтитулы (т.е. все, кроме общего);

отличать текст, выровненный по правому краю.

3. Описание шрифтов

3.1. Для шрифта с именем ABCXYZ файл описания должен называться ABCXYZ.WIN (т.е. приделывается расширение .WIN) и располагаться либо в текущей директории, либо в директории ChiWriter (т.е. обозначенной в переменной окружения CHIFILES). Если Вам надо просто перекодировать много файлов в одном месте - удобнее первое (поскольку в директории ChiWriter эти файлы потом не найдешь); если это постоянно надо делать в разных директориях - второе. По переменной PATH программа и не думает что-либо искать: если Вам надо - добавьте сами. Кроме того, нужно обязательно определить два вспомогательных файла описания шрифта: STANDARD.WIN (он же по совместительству файл стандартного шрифта) и LACKING.WIN (файл отсутствующего шрифта). Они нужны для аварийной работы.

STANDARD.WIN используется для борьбы с ошибкой ChiWriter'а, состоящей в том, что шрифт используется, а имя его в файл не записывается. Это довольно распространенное явление, хотя его трудно заметить, когда сидишь все время на одной машине с одним и тем же CONFIG.PAR. Если в ходе работы программы Вы получаете сообщение типа "Font F49 has no name; using STANDARD instead", то это как раз ваш случай. Если в Вашем тексте символов из F49 мало, можете проигнорировать сообщение; тогда вместо F49 подставится STANDARD. Если вам не все равно, чините Ваш ChiWriter'ный файл: откройте его ASCII-редактором и найдите в его начале строчки типа "\U! STANDARD". Просмотрите все строчки, начинающиеся на \U: нет ли среди них строчки, в которой не хватает имени шрифта. Если такое есть - впишите. (Номер шрифта можно выяснить самой программой перекодировки: она жалуется на такие случаи в порядке их появления в файле).

LACKING.WIN используется для борьбы с неописанными шрифтами (т.е. если ABCXYZ.WIN не найден). Сделайте его таким, чтобы потом легко найти все вхождения его результатов в готовом файле Word: см. имеющийся LACKING.WIN.

3.2. Формат файлов *.WIN

Файл описания шрифта - обычный ASCII файл. В нем бывает три типа строк:

комментарии;
параметры;
таблица перекодировки.

Комментарий - любая строка, начинающаяся с двух диезов (##).

Параметр - строка, имеющая вид: <имя> = <значение> Пробелов в начале строки быть не должно. Строчные и заглавные буквы не различаются.

Допустимые параметры и их возможные значения:

FONT=<имя шрифта Windows> [, <номер набора символов>]
Задает шрифт Windows, которым будут передаваться символы данного шрифта ChiWriter. После имени шрифта через запятую можно приписать номер символьного набора (charset); для русских шрифтов Windows номер набора = 204. Если charset не указан, то используется 0 (он же Western).

В Word 6.0/95 можно было не указывать номер набора для шрифтов типа Arial Cyr (т.е. определенных через Font Substitutes). К сожалению, Word 97 в этом месте содержит ошибку (игнорирует Font Substitutes), и обойтись без явного указания charset не удается. Поэтому рекомендуется приписывать 204 ко всем именам русских шрифтов.

ATTR=none ATTR=Bold ATTR=Italic ATTR=Underline ATTR=Shadow ATTR=Outline ATTR=Strike
Атрибуты шрифта Windows (кажется, ясно, какой где). Можно писать сразу несколько через запятую.

SIZE=<кегль шрифта Windows>
Размер шрифта (тот, который возникнет в Word)

INDEX_SIZE=<кегль шрифта Windows>
Размер шрифта для случая, когда символ возникает не в основной строчке, а в индексе. В ChiWriter сплошь и рядом индексы того же размера, что и основной текст; при переносе их можно сделать поменьше.

DEFSYMBOL=<символ>
Символ, используемый для всего, что не упомянуто в таблице перекодировки (см. ниже). Формат - тот же, что и для выходных символов в этой таблице.

Любая строка, не начинающаяся со знака комментария или ключевого слова-параметра, считается относящейся к таблице перекодировки. В ней должно быть записано одна или несколько пар перекодировки. Пара состоит из входного символа (того, который в ChiWriter) и выходного символа. Входной символ задается сам собой. Выходной можно написать либо прямо, либо в виде кода. Код должен содержать ровно три цифры, интерпретируемые как десятичное число (так, как это принято в файле описания принтера для ChiWriter). Есть также два специальных символа - пробел (SP или SPACE) и неразрывный пробел (NBSP или NONBREAK-SPACE).

Способ интерпретации файла описания следующий:

Если строка параметра указана в начале файла (т.е. раньше всех строк перекодировки), то параметр будет действовать по умолчанию для всех символов, для которых не указано иное. Параметр DEFSYMBOL действует только если он стоит до первой строки таблицы перекодировки, в противном случае (и при его отсутствии) код символа не меняется.

Если строка параметров встречается не в начале (т.е. выше ее есть строки перекодировки), то ее действие распространяется только на те символы, которые указаны в таблице перекодировки ниже ее.

Рекомендуется посмотреть, как сделаны файлы STANDARD.WIN (обычный латинский шрифт), BOLD__R.WIN (полужирная кириллица) и MATH.WIN (спецсимволы); многое станет ясно. Полезно также глянуть (и, если надо, переделать) LACKING.WIN.

Просматривать и редактировать эти файлы проще под Windows - через Notepad (Блокнот): под DOS'ом таблица перекодировки кириллицы читается с трудом, а под Windows имеет вполне прозрачную структуру. Кроме того, опыт показывает, что при составлении новых описаний приходится часто лазить в Character Map (Таблицу Символов).

4. Комплект поставки

В архиве Chi2Word.zip содержатся следующие файлы:

Chi2word.exe - сама программа (консольное приложение Win32);

Chi2word.c - исходный текст на C;

Chi2word.htm - инструкция (то, что Вы сейчас читаете);

несколько файлов с расширением *.WIN - описания шрифтов, сделанные до сих пор. Их полезно посмотреть, но доверять им не стоит - многие я сделал не имея самих шрифтов, просто для того, чтобы как-то прочесть нечитаемые файлы ChiWriter.

5. Разное

5.1. Если Вам часто приходится перекодировать файлы и Вы составили приличное описание Ваших шрифтов, то под Windows 95/NT 4.0 удобно бывает добавить конвертирование в контекстное меню Explorer (Проводника) для файлов ChiWriter, так чтобы вызывать конвертер правой кнопкой мышки. Те, кто не знает, как это делается - могут спросить у меня.

5.2. Программа написана на чистейшем С и откомпилирована Visual C++ 5.0 как консольное приложение Win32. Страдальцы, сидящие на 286 машинах под DOS, могут перекомпилировать его в Turbo C 2.0 (на котором эта программа во время оно и была создана): работать будет, я проверял. Не забудьте только раскомментировать #include <alloc.h>.