Web-узел rusconv -- руководство пользователя.

[RUSSIAN] [ENGLISH] [BACK] [AUTHOR'S HOME]

rusconv v.3.11.
Руководство пользователя.

Назначение.

Программа rusconv служит для преобразования русскоязычных текстов - перевода их в кодировки: альтернативную (кодовая страница 866, для DOS), koi8 (для UNIX и Русской Сети), Windows (кодовая страница 1251), Macintosh и latinica (russkij tekst latinskimi bukvami). Возможен перевод из DOS/windows-формата текстовых файлов в UNIX-формат и обратно. Один файл можно переводить сразу в несколько кодировок, можно переводить сразу несколько файлов. Разработан для использования из командной строки и из командных файлов. Windows-версия понимает длинные имена файлов и сетевые файлы.

Описание.

Способы запуска:

rusconv (-h|--help)

rusconv [options] -(alt|koi|mac|win) +(alt|koi|mac|lat|win) [--] <file_list> [output_dir]

rusconv [options] -(cr2crlf|crlf2cr) [--] <file_list> [output_dir]

1. rusconv (-h|--help)

Выводит на экран текст помощи.

2. rusconv [options] -(alt|koi|mac|win) +(alt|koi|mac|lat|win) [--] <file_list> [output_dir]

Программа переводит содержимое файлов в списке <file_list> из кодировки -xxx в кодировку +xxx. Результаты сохраняются в файлах с теми же именами, но с другими расширениями. Они создаются в директории [output_dir], либо, если выходная директория не задана, в текущем каталоге.
Необходимо указывать ровно одну кодировку, из которой надо переводить. Для этого используются флаги:

   флаг           кодировка
   -alt     -  альтернативная (DOS)
   -koi     -  КОИ-8 (UNIX)
   -mac     -  Macintosh
   -win     -  Windows

Можно переводить сразу в несколько кодировок. Для этого надо дать не менее одного из флагов:

   флаг           кодировка
   +alt     -  альтернативная (DOS)
   +koi     -  КОИ-8 (UNIX)
   +lat     -  latinica
   +mac     -  Macintosh
   +win     -  Windows

По умолчанию к именам файлам добавляются такие расширения:

расширение        для кодировки
   .alt     -  альтернативной (DOS)
   .koi     -  КОИ-8 (UNIX)
   .lat     -  latinica
   .mac     -  Macintosh
   .win     -  Windows

Чтобы задать свои расширения для файлов с результатами перевода, используйте команды:

расширение для файлов,  содержащих текст в кодировке
   -aext расширение     -  альтернативной (DOS)
   -kext расширение     -  КОИ-8 (UNIX)
   -lext расширение     -  latinica
   -mext расширение     -  Macintosh
   -wext расширение     -  Windows

При переводе только в одну кодировку можно использовать команду

   -ext расширение

В зависимости от кодировки, в которую происходит преобразование, это воспринимается как одна из команд '-aext расширение', '-kext расширение', '-lext расширение', '-mext расширение' или '-wext расширение'.

Флаг '-o' используется для перезаписывания. Вместо того чтобы создавать новые файлы, rusconv изменяет содержимое переводимых файлов.

Кроме преобразования кодировок, rusconv позволяет изменять тип строк. В DOS и windows конец строки кодируется двумя символами, в UNIX - одним. Для перевода из одного формата в другой предназначены флаги

  -cr2crlf  -  из UNIX-формата текстовых файлов в DOS/windows-формат
  -crlf2cr  -  из DOS/windows-формата текстовых файлов в UNIX-формат

DOS и windows-версии по умолчанию разговорчивые. В UNIX-версии по умолчанию выводятся только предупреждения и сообщения об ошибках. Чтобы задать режим работы, используйте флаги

   '-s'  -  работа без вывода на экран любых сообщений
   '-v'  -  вывод на экран всех сообщений

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

   '-close'    -  завершаться сразу после окончания перевода файлов
   '-noclose'  -  не закрывать окно с отчетом, по умолчанию

Флаги '-close' и '-noclose' имеют смысл только в windows-версии. В DOS и UNIX-версиях они игнорируются.

Сочетание символов '--' служит для указания конца флагов. Все, что стоит после него, является списком файлов.

3. rusconv [options] -(cr2crlf|crlf2cr) [--] <file_list> [output_dir]

В данном случае изменяется только тип строк, преобразования кодировок не происходит. В DOS и windows конец строки кодируется двумя символами, в UNIX - одним.

  -cr2crlf  -  из UNIX-формата текстовых файлов в DOS/windows-формат
  -crlf2cr  -  из DOS/windows-формата текстовых файлов в UNIX-формат

Расширения по умолчанию для создаваемых файлов:

расширение        формат текстового файла
   .cr     -  UNIX-формат
   .crlf   -  DOS/windows-формат
   .crl    -  DOS/windows-формат, используется в DOS-версии

Для установки своего расширения можно дать команду

   -ext расширение

Остальные флаги используются аналогично пункту '2'.

Для полноценного переноса русских файлов между наиболее популярными операционными системами достаточно использовать флаги

  -dos2unix (или -d2u)  -  из DOS в UNIX
  -win2unix (или -w2u)  -  из Windows в UNIX
  -unix2dos (или -u2d)  -  из UNIX в DOS
  -unix2win (или -u2w)  -  из UNIX в Windows

Они являются всего лишь сокращениями. При разборе командной строки они заменяются:

  -dos2unix (или -d2u)   на   '-alt +koi -crlf2cr'
  -win2unix (или -w2u)   на   '-win +koi -crlf2cr'
  -unix2dos (или -u2d)   на   '-koi +alt -cr2crlf'
  -unix2win (или -u2w)   на   '-koi +win -cr2crlf'

Примеры использования.

1. Пример для windows.

Файлы file1.txt и file2.txt из кодировки КОИ-8 переводятся во все остальные кодировки. Результат сохраняется в файлах с именами file1.alt, file1.koi, file1.lat, file1.mac, file1.win, file2.alt, file2.koi, file2.lat, file2.mac, file2.win в директории e:\txt.

E:\EX>rusconv -koi +alt +koi +win +mac +lat file1.txt file2.txt e:\txt\
** rusconv -- convertor of Russian codepages, v.3.11.
** (c)w_re -- Oleg A. Paraschenko  http://beta.math.spbu.ru/~prof/w_re/
.\file1.txt -> e:\txt\file1.alt, e:\txt\file1.koi, e:\txt\file1.mac, e:\txt\file1.lat, e:\txt\file1.win: ok.
.\file2.txt -> e:\txt\file2.alt, e:\txt\file2.koi, e:\txt\file2.mac, e:\txt\file2.lat, e:\txt\file2.win: ok.
2 file(s) converted.

2. Пример для windows.

Тип концов строк текстовых сетевых файлов \\server\d\files\*.txt преобразуется из UNIX-формата в DOS/windows-формат.

E:\EX>rusconv -cr2crlf -o \\server\d\files\*.txt
** rusconv -- convertor of Russian codepages, v.3.11.
** (c)w_re -- Oleg A. Paraschenko  http://beta.math.spbu.ru/~prof/w_re/
\\server\d\files\EC-1845.TXT -> \\server\d\files\rcB180.TMP -> \\server\d\files\EC-1845.TXT: ok.
\\server\d\files\HUMOR_PR.TXT -> \\server\d\files\rcB181.TMP -> \\server\d\files\HUMOR_PR.TXT: ok.
\\server\d\files\NON_PAS.TXT -> \\server\d\files\rcB183.TMP -> \\server\d\files\NON_PAS.TXT: ok.
3 file(s) converted.

3. Пример для UNIX.

Содержимое .html-файлов из директории win/ переводится из windows-версии русского текста в UNIX-версию. Результат сохраняется в файлах с теми же именами в директории koi/.

rusconv -v -win2unix -ext html win/*.html koi/
** rusconv -- convertor of Russian codepages, v.3.11.
** (c)w_re -- Oleg A. Paraschenko  http://beta.math.spbu.ru/~prof/w_re/
win/faq.html -> koi/faq.html: ok.
win/feedback.html -> koi/feedback.html: ok.
win/index.html -> koi/index.html: ok.
3 file(s) converted.

Код возврата.

Количество переведенных файлов.

manual.html
Документ создан Паращенко Олегом
Последние изменения - 15 ноября 1998 года
[email protected]