Emacs для начинающих

Manual


  

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]
  • 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 года


    Содержание раздела