dcd 1.5.8 — Документация

Copyright © 2000-2002 by Alexander Musayev

Содержание

Введение

dcd — это перекодировщик текстовых файлов. Понимает 8-битные кодировки русского (koi-8, win-1251, iso-8859-5, dos-866, Macintosh), украинского (dos, koi, iso, Macintosh, Windows), белорусского, болгарского, сербского и македонского (iso, Macintosh, Windows) языков, а так же Unicode. Есть возможность добавления любых других кодировок, для любых языков. Имеет две версии: GUI и консольную (обе включены в дистрибутив). Интерфейс — русский, украинский или английский, на выбор. Могут быть добавлены другие языки.

top

Интерфейс

top

Настройки

Настройки dcd можно изменить нажав кнопку Options. Все настройки сохраняются при выходе из программы и при следующем запуске будут восстановлены.

top

Параметры командной строки

Формат командной строки:

dcd [/параметры] <кодировка1>,<кодировка2> <файл> [новый файл]
[/параметры]
список параметров (описание см. ниже)

<кодировка1> и <кодировка2>
кодировки исходного и нового файлов соответственно.

<файл>
имя конвертируемого файла

[новый файл]
имя нового файла

Параметры:

b — сохранять копию оригинала в *.bak файл (<имя_исходного_файла>.<расширение>.bak). Если имя нового файла не указано, то этот параметр не обязателен — копия оригинала в любом случае будет сохранена в bak, а имя файла с новой кодировкой будет совпадать с именем изначального файла. Если же одновременно задано имя нового файла и этот параметр, то имя нового файла будет проигнорировано, и он опять же будет записан поверх старого.

o — в случае, если имя нового файла совпадает с именем уже существующего файла, то он будет без предупреждения перезаписан.

q — не выдавать на экран никаких сообщений при работе

t — вывести список всех возможных кодировок. Список имеет вид:
<кодировка1> = <описание кодировки>
<кодировка2> = <описание кодировки>
<кодировка3> = <описание кодировки>
...

Где <кодировкаX> — название кодировки, которое следует указывать в командной строке. Вот этот список для данной версии dcd:

                            1251 = Russian — win-1251
                             dos = Russian — DOS-866, OS/2
                             iso = Russian — iso 8859-5
                             koi = Russian — koi-8r
                             mac = Russian — Macintosh
                          ukrdos = Ukrainian — dos
                          ukrkoi = Ukrainian — koi
                          ukrmac = Ukrainian — mac
                          ukrwin = Ukrainian — win
                          cyriso = Cyrillic — iso 8859-5
                          cyrmac = Cyrillic — mac
                          cyrwin = Cyrillic — win
                         UNICODE = UNICODE
g — запустить GUI версию dcd (показать графический интерфейс). Аналогичного результата можно добиться если вообще не указывать параметры командной строки. При указании этого ключа, игнорируются все остальные параметры, за исключением n.

n — запретить запуск GUI версии dcd. Если вместе с этим ключём задан ключ g, программа прекратит работу не произведя никаких действий.

? — краткое описание параметров командной строки.

Чтобы использовать несколько параметров одновременно их нужно указать поочерёдно (в произвольном порядке) после символа '/', например /bqo .

Все параметры необязательны. Если параметры не указаны вообще, или среди них есть ошибочные, появится графический интерфейс dcd.

Примеры вызова dcd из командной строки:

dcd 1251,koi file.txt

Файл file.txt перекодируется из win-1251 в koi-8 с сохранением оригинала в file.txt.bak.

dcd /qo koi,unicode file.txt file.unicode.txt

file.txt перекодируется из koi-8 в unicode. Новый файл будет иметь имя file.unicode.txt. Если файл с таким именем уже существует, то он будет перезаписан без предупреждения. Никакие сообщения на экран не выводятся.

dcd /t

Вывод списка доступных кодировок.

top

Техническая информация

Файлы кодировок

Кодовые таблицы поддерживаемых кодировок содержатся в текстовых файлах с расширением tab в директории dcd. Эти файлы имеет следующую структуру:

Вот пример tab файла:

#Russian — win-1251
0410 C0
0411 C1
0412 C2 <- символ номер 3
0413 C3 ^^^^^^^^^^^^^^^^^ этот текст игнорируется
0414 C4 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ и этот тоже
;0415 C5           эти две строки
//0416 C6          закомментированы
0417 C7
...

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

top

Многоязычная поддержка

Как уже было сказано, интерфейс dcd имеет многоязыковую поддержку. Стандартным языком интерфейса является английский. Другие языки описаны в файлах с расширением lng в директории dcd (на данный момент есть только один дополнительный язык — русский). lng файлы имеют очень простую структуру — первая строка содержит название языка, а дальше, поочерёдно в каждой строке — надписи на элементах интерфейса и в диалоговых окнах. При переводе на другой язык, следует предусмотреть чтобы:

top

Значения %ERRORLEVEL%, возвращаемые dcd.exe

Значения %ERRORLEVEL%, возвращаемые dcd.exe

0 — нормальное завершение работы. Такой errorlevel бывает в следующих случаях: 1 — заданы неправильные параметры командной строки
2 — не заданы кодовые таблицы
3 — заданы несовместимые кодовые таблицы
4 — файл с заданной кодовой таблицей не найден
5 — исходный файл не существует
6 — ошибка чтения исходного файла
7 — ошибка записи нового файла
8 — ошибка чтения/записи во временный файл
9 — кодировки исходного и нового файла совпадают
10 — олшибка при попытке стереть .bak файл (чтобы записать поверх него новый с тем же именем)

top

Условия распространения

dcd распространяется как freeware и As Is. Автор не несёт никакой ответственности за возможные последствия работы программы.

top

Автор

Все предложения/отзывы/сообщения об ошибках можно слать мне по адресу alexmusayev@mailru.com или 2:5030/1387.21 в FIDO. Дополнительную информацию о dcd, и самую последнюю версию можно найти на моём сайте: http://alex.far.ru/soft/dcd/.

top

Благодарности

Большое спасибо за активное принятие участия в развитии dcd

А так же, спасибо всем тем, кто присылал мне багрепорты.

top