[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-версия понимает длинные имена файлов и сетевые файлы.

 

  Описание.

    Способы запуска:
  1. rusconv (-h|--help)
  2. rusconv [options] -(alt|koi|mac|win) +(alt|koi|mac|lat|win) [--] <file_list> [output_dir]
  3. rusconv [options] -(cr2crlf|crlf2cr) [--] <file_list> [output_dir]
  4. rusconv [options] -(dos2unix|win2unix|unix2dos|unix2win|d2u|w2u|u2d|u2w) [--] <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'.

 

4. rusconv [options] -(dos2unix|win2unix|unix2dos|unix2win|d2u|w2u|u2d|u2w) [--] <file_list> [output_dir]

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

  -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 года
prof@beta.math.spbu.ru