6. Параметры программы

Список параметров программы, которые указываются в консоли или во внешнем файле параметров. Если для параметра указаны варианты значений, то следует указывать параметр, затем равно и значение (-PARAM=VALUE).

Значения можно указывать в кавычках, которые будут проигнорированы при использовании значения. Кавычки могут понадобиться при использовании пробелов в значении. Пример использования -SOURCEDIR="c:\My documents\Example"

Кавычки в начале и в конце значения будут игнорироваться, поэтому следует добавить дополнительные кавычки, если значение параметра должно их содержать. Например для -TEXTALLOW="""""" значением будет считаться «""».

В описании сначала указаны параметры, затем для некоторых из них, под ними с отступом перечислены варианты значений.

При указании значениями параметров не ASCII (0..127) символы, например кириллицу для регулярных выражений, используйте замену кодами. Для регулярных выражений указывается как \x00.

Все регулярные выражения должны быть оформлены в формате VisualBasic.

Для использования параметра во всех ярлыках сразу и при всех вызовах программы, следует такой параметр добавить в файл user.params.

6.1. Исходные файлы

-SOURCEWRITE
Разрешает перезапись исходных файлов. Если параметра нет, то исходные файлы не будут изменены.
-FILEWRITE=значение
Параметр влияющий на перезапись исходных файлов. Если значение параметра ONLYTEMP, то вместо перезаписи исходных файлов будут создаваться новые с добавлением в конец названия «.tmp»
-SOURCEDIR=значение
Каталог с исходными файлами (учитываются все подкаталоги). Пример: -SOURCEDIR="с:\work\source"
-SOURCEFILE=значение
Исходный файл. Пример: -SOURCEFILE="с:\work\source\example.ini"
-SOURCEDROP=значение
Исходный файл или каталог. Для указания каталогов следует использовать -DROPDIRECTORYALLOW. Параметр имитирует «брошенный» файл/каталог на ярлык. Пример: -SOURCEDROP="с:\work\source\example.ini"
-DROPCOUNT=значение
Количество «бросаемых» на ярлык файлов. Возможные значения 1 и 2.
-SOURCEDROP1=значение
Исходный файл. Параметр имитирует «брошенный» файл на ярлык, при использовании параметра -DROPCOUNT. Пример: -SOURCEDROP1="с:\work\source\example.ini"
-SOURCEDROP2=значение
Исходный файл. Параметр имитирует «брошенный» файл на ярлык, при использовании параметра -DROPCOUNT. Пример: -SOURCEDROP2="с:\work\source\example.ini"
-SOURCEFILEIGNOREREGULAR=регулярное выражение

Игнорировать файлы по следующему регулярному выражению присутствующему в полном названии файла. Служит для игнорирования служебных и временных файлов, например для игнорирования специальных каталогов SVN — см. пример. Примеры:

  • пример для служебного каталога svn: -SOURCEFILEIGNOREREGULAR=[\/\\]\.svn[\/\\]
  • пример исключения ряда каталогов: -SOURCEFILEIGNOREREGULAR=[\/\\](\.svn|\.git|Temp|debug)[\/\\]
  • пример исключения ряда каталогов с учетом их вложенности в каталог source: -SOURCEFILEIGNOREREGULAR=[\/\\](source[\\\/]Temp|source[\\\/]debug)[\/\\]
-FILEPATHREPLACE-REGULAR=регулярное выражение
Заменяет в названии файла регулярное выражение на текст указанный в -FILEPATHREPLACE-NEWTEXT. Пример: -FILEPATHREPLACE-REGULAR=^.{0,}[\/\\]source[\/\\]
-FILEPATHREPLACE-NEWTEXT=значение
Заменяет в названии файла регулярное выражение из -FILEPATHREPLACE-REPLACE на указанный текст. Пример: -FILEPATHREPLACE-NEWTEXT=..\
-GETTEXTFROMCLIPBOARDALLOW
Разрешает получение данных из буфера. При наличии в списке исходных файлов с названием {clipboard} заменяет содержимое «файла» содержимым буфера.
-CODEPAGEDEFAULT
Устанавливает значение кодовой страницы по умолчанию с используемой в системе на указанную в параметре. Можно указывать не только числовые значения (1251, 1252,..) но и utf-8.
-CODEPAGEFORCE
Заменяет используемые кодовые страницы на указанную в параметре. Можно указывать не только числовые значения (1251, 1252,..) но и utf-8.
-DROPDIRECTORYALLOW
Разрешает «бросок» на ярлык каталогов. По умолчанию запрещено «бросание» каталогов.

6.2. Форматы исходных файлов

-SOURCETYPETRANSLATE=значение1.значение2.значение3

Указывается тип исходного кода, а также уточнение какую часть (формы/код/настройки) переводить и что именно (все/константы/ресурсы). Параметр можно указывать многократно. Описание:

значение1
тип исходного кода проекта
значение2
компонент проекта
значение3
что именно переводить Пример: Delphi7.Form.All — означает проект Delphi7 (1), только формы в проекте (2), все текстовые фрагменты в формах(3).

6.3. Настройки программы

-PAUSEIFERROR
Пауза при ошибке в работе программы.
-PAUSE
Пауза при завершении работы программы.
-? , -H , -HELP
Выводит в консоль программы ссылки на справочную информацию.
-APPDIR=значение
Изменение используемого каталога программы. Предназначен для использования различных файлов настроек для проектов. По умолчанию используется каталог программы. Значение игнорируется при чтении ключа/blacklist программы. Пример: -APPDIR="c:\work"
-FILEPARAMS=значение
Загружает файл параметров программы, каждая строка которого считается как дополнение к строке параметров. Примечание: строки обрабатываются отдельно; кодировка файла должна быть UTF8. Пример: -FILEPARAMS="c:/work/myparams.param"
-ERRORCODE=значение
Код завершения программы при ошибке. Значение по умолчанию 1. Пример: -ERRORCODE=1
-ENABLEGC
Разрешает программе вызывать сборщик мусора памяти (GC).
-USEGCTOCSSLOG_MINLENGTH=значение
Использовать чистку памяти (GC) при применении CSS для логов больше длины указанной в параметре. По умолчанию значение 100000. Необходимо использовать совместно с -ENABLEGC
-USEENCODINGUTF8WITHOUTBOM
Запрет метки BOM при чтении и сохранении файлов в формате UTF8.

6.4. Орфография

-SPELLCHECKUSE=значение

Используемый компонент проверки орфографии. Пример: OOO — используется OpenOffice. Варианты значений:

OOO
Использовать установленный OpenOffice. Требуется установленный OpenOffice.
HUNSPELL
Использовать библиотеку NHunspell. Требуются файлы NHunspell расположенные в каталоге программы.
DEFAULT
Проверяет наличие установленных компонентов и выбирает доступный для использования компонент в следующем порядке: HUNSPELL, OOO.
-SPELLCHECKLANGDEFAULT=значение
Язык по умолчанию. Значение должно быть из четырех букв указывающих на язык, например «ruRu».
-LANGMAIN=значение
Язык для проверки исходного текста.
-LANGMAINSEC=значение
Второй язык для проверки исходного текста.
-LANGTRAN=значение
Язык для проверки переведенного текста.
-LANGTRANSEC=значение
Второй язык для проверки переведенного текста.
Варианты значений параметров LANGMAIN, LANGMAINSEC, LANGTRAN, LANGTRANSEC:
ruRU_enUSignore
Русский и игнорирование английского
ruRUyo_enUSignore
Русский(Ё) и игнорирование английского
ruRU
Русский
ruRUyo
Русский(Ё) — учитывается буква «Ё»
ruRUfirefox
Русский(Firefox) — большой словарь из Firefox
enUS
Английский
enUSignore
Английский(игнорировать)
enAU
Английский(Австралия)
enCA
Английский(Канада)
enGB
Английский(Великобритания)
enZA
Английский(ЮжнаяАфрика)
frFR
Французский — все правила
frFRclassic
Французский(Классический)
frFRmodern
Французский(Современный)
frFRreform1990
Французский(Реформа1990)
ukUA
Украинский
beBY
Белорусский
deDE
Немецкий
-SPELLCHECKLANGEN=значение

Язык для символов английского алфавита. Варианты значений:

enUS
Четыре буквы указывающие на язык. Можно использовать другой язык.
IGNORE
Игнорировать.
DEFAULT
Язык как и для основного, указанного в -SPELLCHECKLANGEN.
-SPELLCHECKSETTINGS=значение

Параметры проверки орфографии. Значения можно указывать через пробел или в отдельных параметрах (они будут объединены), т.е. -SPELLCHECKSETTINGS="param1 param2" можно записать как -SPELLCHECKSETTINGS="param1" -SPELLCHECKSETTINGS="param2"

_asNOTHING
Знак подчеркивания будет игнорироваться при проверке орфографии — например «П_ример» будет считаться как «Пример». Без этого параметра подчеркивание считается пробелом.
CHECKONLYYO
Проверять только на ошибки орфографии с буквой Ё (chk(YO)), все остальные ошибки орфографии игнорировать.
-DISABLESPELLCHECK_RU_YO
Отключение проверки буквы «Ё».
-DISABLESPELLCHECKREMARK
Отключение проверки ремарок.
-SPELLCHECKLENGTHMIN=число
Указывает минимальное число символов в текстовом фрагменте, при котором он проверяется на ошибки орфографии.

6.5. Словари орфографии

-FILESPELLCHECKDICTIONARYREAD=значение
Загружает слова исключения (позитивный словарь) для орфографии из указанного файла. Пример: -FILESPELLCHECKDICTIONARYREAD="c:/work/mydictionary.sld"
-DISABLESPELLCHECKDICTIONARYOOO
Отключает использование пользовательских словарей OpenOffice.
-DISABLESPELLCHECKDICTIONARYDEFAULT
Отключает использование основного словаря программы локализации defaultdictionary.sld

6.6. Перевод

-LANGNAME=значение
Название языка перевода. Пример: -LANGNAME=english
-LANGNAMESHORT=значение
Короткое название языка перевода. Пример: -LANGNAMESHORT=en
-REMARKTOTRANSLIT
Транслитерация ремарок в исходном коде (ISO 9, система Б).
-TRANSLATE=значение

Тип перевода. В зависимости от значения, позволяет по разному выполнять перевод. Если параметра нет, то перевод выполняется по основному типу. Пример: -TRANSLATE=TRANSLIT

TRANSLATE
Перевод по словарю (po/csv-файл), это основной вид перевода. Пример: -TRANSLATE=TRANSLATE
TRANSLIT
Транслитерация (ISO 9, система Б). Пример: -TRANSLATE=TRANSLIT
TRANSLITSHORT
Транслитерация (упрощенная ISO 9, система Б) специально упрощенная до однобуквенного представления, чтобы точно по длине фраз соответствовать оригиналу. Пример: TRANSLATE=TRANSLITSHORT
SYMBOL=X
Замена букв/цифр на символ замены, указанный после SYMBOL, например SYMBOL=X заменит все на X, а SYMBOL=z заменит все на z. Вариант символа для значения лежит в диапазоне A..Z a..z 0..9 Служит для проверки, все ли элементы программы доступны для перевода. Пример: TRANSLATE=SYMBOL=X
ALLSYMBOL=X
Замена всех' символов на символ замены указанный после 'ALLSYMBOL, например ALLSYMBOL=X заменит все на X, а ALLSYMBOL=z заменит все на z. Вариант символа для значения лежит в диапазоне A..Z a..z 0..9 Служит для проверки, все ли элементы программы доступны для перевода. Пример: TRANSLATE=ALLSYMBOL=X
-TEXTALLOW=регулярное выражение
Разрешает перевод текста, только при наличии в нем регулярного выражения (VB.NET). Пример: -TEXTALLOW=[А-Яа-я] При передаче через командную строку кириллица может быть искажена, поэтому предлагаю использовать ее коды. Простым решением, для поиска слов с кириллицей, будет указание поиска любых символов не в диапазоне ASCII (0..127), -TEXTALLOW=[^\x00-\x7F]. Для указания содержания в тексте именно кириллицы можно использовать -TEXTALLOW=[\u0410-\u044F\u0401\u0451] см. Таблица Unicode. Значение по умолчанию -TEXTALLOW=\S
-TEXTDENY=значение
Регулярное выражение (VB.NET) при нахождении которого текстовый фрагмент запрещается к переводу. Примечание: проверка производится после -TEXTALLOW. Пример: -TEXTDENY=[\{\}]
-DICTIONARYUSEFILENAMEINMSGCTXT
Добавляет в контекст слова название файла. Используется для анализа словарей с совпадающими словами.

6.7. Использование контекста для перевода

-ENABLETEXTCONTEXT
Включить использование контекста (например, msgctxt для po-файлов)
-TEXT-CONTEXT-FILE=значение

Использование в качестве контекста название файла. По умолчанию YES.

NO
Не использовать.
YES
Использовать. Будет использовано значение NAMEEXT, см. далее.
NAMEEXT
Название файла с расширением (без указания пути).
NAME
Название файла без расширения (без указания пути).
PATHNAMEEXT
Название файла с расширением и указанием пути к файлу.
-TEXT-CONTEXT-REGION=значение

Использование в качестве контекста регионы/области в тексте файла, например REGION в VB.NET или resourcestrings в Delphi. По умолчанию YES.

NO
Не использовать.
YES
Использовать.
-TEXT-CONTEXT-OBJECT=значение

Использование в качестве контекста название объектов в тексте файла, например Form1.Label1.Caption для формата dfm(Delphi). По умолчанию YES.

NO
Не использовать.
YES
Использовать.

6.8. Файлы переводов

-FILELANGMAINREAD=значение
Загрузка основного словаря из po-файла. Данный файл загружается без перевода, а словари перевода уже сопоставляются ему. Если в основном файле нет слова, то в словаре перевода оно будет удалено, если же слово из основного словаря отсутствует в словаре перевода, то будет добавлено в него. Примечание: это позволяет синхронизировать словари для всех языков. Пример: -FILELANGMAINREAD=c:\work\example\russian.po
-FILELANGTRANREAD=значение
Загрузка словаря перевода из po-файла. Данный файл загружается только переводы для слов присутствующих в основном словаре (paramFILELANGMAINREAD). Если в основном файле нет слова, то перевод игнорируется. Пример: -FILELANGTRANREAD=c:\work\example\english.po
-FILELANGMAINWRITE=значение
Сохранение основного словаря в po-файл. Пример: -FILELANGMAINWRITE=c:\work\example\russian.po
-FILELANGTRANWRITE=значение
Сохранение словаря перевода в po-файл. Пример: -FILELANGTRANWRITE=c:\work\example\english.po
-FILELANGTRANNOINFOWRITE=значение
Сохранение словаря перевода в po-файл без информации о названиях файлов проекта и пр. Пример: -FILELANGTRANNOINFOWRITE=c:\work\example\english.po
-FILELANGTRANONLYPRESENTWRITE=значение
Сохранение из словаря перевода в po-файл только присутствующих в коде слов без отметки fuzzy. Пример: -FILELANGTRANONLYPRESENTWRITE=c:\work\example\english.po
-FILELANGCSVREAD=значение
CSV-файл словаря для чтения. Пример: -FILELANGCSVREAD=c:\work\example\english.csv
-FILELANGCSVWRITE=значение
CSV-файл словаря для записи. Пример: -FILELANGCSVWRITE=c:\work\example\englishnew.csv

6.9. Отчеты

-DISABLESLOWADDITIONALREPORTS
Отключает медленные дополнительные (не основные) отчеты, не влияющие на перевод программы, а отвечающие за дополнительную статистику. Такие отчеты отмечены в логе программы как отключенные.
-GENERATEONLYOPENREPORTHTML
Генерировать только открываемый отчет HTML-отчет. Параметр относится только к отчетам HTML. См. OPENREPORTHTML.
-RESULTHTMLDIR=значение
Каталог для записи HTML-отчетов. Пример: -RESULTHTMLDIR=c:\work\example\htmlreports Если не указан каталог, то расчет таких отчетов не производится.
-OPENREPORTHTML=значение
Запустить HTML-отчет после выполнения программы. Пример: -OPENREPORTHTML=developer В значении указывается название отчета. Список названий доступен в открывающемся списке.
-FILEJUNITWRITE=значение
Файл для записи XML-отчета (Основной язык) в формате JUnit. Пример: -FILEJUNITWRITE=c:\work\example\russian.xml
-FILEJUNITTRANWRITE=значение
Файл для записи XML-отчета (Язык перевода) в формате JUnit. Пример: -FILEJUNITTRANWRITE=c:\work\example\english.xml
-LINKFILE=ссылка;описание
Ссылка на файл из testcase files.links.html Формат значения — ссылка, точка с запятой в качестве разделителя, описание.
-USECSSTOLOGMAXLENGTH=значение
Ограничение CSS-оформления для логов превышающих значение данного параметра. Значение по умолчанию 50000000.

6.10. Оптимизация кода

SOURCEOPTIMIZELEVEL=значение

Уровни оптимизации кода, включающие от отключено и объединения текстов, до преобразования текстовых фрагментов и переменных в вызовы функций форматирования. См. оптимизация кода.

NO
Отключено
SIMPLE
Простой. Как правило простое объединение текста ("1" & "2" будет "12")
BASE
Базовый
EXTENDED
Расширенный
MAXIMUM
Максимальный
ALL
Разрешено все

6.11. Информация

-AUTHOR=значение
Автор коммита, отчета, пр. по усмотрению пользователя. Пример: -AUTHOR=IvanPetrov
-BUILD=значение
Номер сборки(BUILD) на сервере сборки. Примечание: значение цифровое — 0..999999999. Пример: -BUILD=100
-REVISION=значение
Номер ревизии исходного кода из системы контроля версий. Примечание: значение цифровое — 0..999999999, по умолчанию равно 0. Пример: -REVISION=100
-VERSION=значение
Номер версии программы. Пример: -VERSION=1.0.5

6.12. Графы

-GRAPHDEFAULTFONTNAME=значение
Указывает название шрифта для графа. Например: -GRAPHDEFAULTFONTNAME=Verdana.
-GRAPHHEADERFONTSIZE=значение
Указывает размер шрифта для заголовка графа. При значении 0 заголовок не выводится. Подзаголовок с информацией о количестве слов и пр. выводится с размером 50% от основного.
-GRAPHSETTINGS=значение

В значении указываются вспомогательные параметры для настройки графов. При указании данного параметра несколько раз его значения будут сложены (через пробел). Для параметров можно указать название лога-графа к которому они применяются. Без указания названия лога они применяются ко всем логам-графам (не все значения, см. ниже). Для разделения параметров следует использовать пробел. Для данного параметра используются значения по умолчанию (см. maintemplate.tpl, раздел graph, параметр graph.settings.default) к которым будут добавляться значения данного параметра. Например: files.graph.translate.dot=VIEW files.graph.translate.dot=VIEWFILENAME Значения:

VIEW
создает граф для лога. Примечание: используется только с названием лога.
CHECKTRANSLATE
учитывает информацию о переводе. Примечание: используется только с названием лога.
CHECKORPHO
учитывает информацию об орфографии. Примечание: используется только с названием лога.
VIEWFILENAME
показывает названия файлов.
COLORFILENAME
использует цвета для указания ошибок/замечаний в файлах.
VIEWWORDS
показывает слова (окружности) для файлов.
VIEWFILEWITHNOWORDS
показывает файлы в которых нет слов для перевода/орфографии.
SIZEGRAYCIRCLEWORDSX0
скрывает серые окружности (слова).
SIZEGREENCIRCLEWORDSX0
скрывает зеленые окружности (слова).
SIZEREDCIRCLEWORDSX2
увеличивает размер красных окружностей (слов) в 2 раза.
SIZEREDCIRCLEWORDSX4
увеличивает размер красных окружностей (слов) в 4 раза.
SIZEREDCIRCLEWORDSX8
увеличивает размер красных окружностей (слов) в 8 раз.
USEREDCIRCLEASGREEN
все красные окружности (слова) указаны зелеными, в том числе учтены как зеленые в общем количестве в заголовке.
-GRAPHCREATEFROMDICTIONARY
Указывает на использование в качестве файловой структуры исходных файлов, ссылки на файлы загруженные из словаря.
-GRAPHREFERENCEFROMCONTEXT
Использование в качестве ссылок и названий исходных файлов — контекст слов.
-GRAPHREFERENCECLEANREGULAR=регулярное выражение
Удаляет из контекста, по которому происходит постройка графа, фрагмент по регулярному выражению.
-DISABLEGRAPH
Отключение построения графов.
-GRAPHNODESEDGESLIMIT=значение
Ограничение логов на количество объектов/граней. Ограничение необходимо из-за возможного зависания внешней программы, например, GraphViz при очень больших объемах логов, а также из-за самих логов, объемы которых могут достигать сотен мегабайт, при, например, 1 млн проверяемых фраз. Значение по умолчанию 100000.

6.13. DEBUG

Параметры для тестирования программы разработчиком.

-UPDATE
Проверка новых версий на сайте.
-DEBUG:TIME
Добавляет в вывод сообщений программы, метки времени выполнения различных функций.
-NEXTPARAMSIGNORE
Игнорирование всех параметров после этого параметра.
-LOGDEBUGCONSOLEVERBOSE_LEVEL=Значение
Уровень подробности подробного лога (console.verbose). Чем выше значение, тем больше подробностей пишется в лог, вплоть до вызова каждой функции и каждого проверяемого слова. Значение по умолчанию 3. Диапазон значений 1..10.
-LOGDEBUGCONSOLEVERBOSE_LENGTH=Значение
Длина/объем подробного лога (console.verbose). При превышении длины лога, превышающей объем текста удаляется из начала лога. Значение по умолчанию 10000.
-LOGDEBUGCONSOLEVERBOSE_LENGTHBUFFER=Значение
Буфер лога (console.verbose) при его заполнении. Влияет только на скорость его заполнения, а также на выделяемую память для лога, не влияет на сам лог. Значение по умолчанию 100000.
-MEMORYLIMIT=Значение

Указывает лимит памяти выделяемой программе. Если значение равно нулю, то параметр игнорируется. Значение указывается в байтах или указанной ниже размерности. Пример:

-MEMORYLIMIT=100
100 байт
-MEMORYLIMIT=100B
100 байт
-MEMORYLIMIT=100K
100*1024=102,400 байт
-MEMORYLIMIT=100M
100*1024*1024=104,857,600 байт
-MEMORYLIMIT=100G
100*1024*1024*1024=107,374,182,400 байт

6.14. Разное

/
Отключает параметр при указании перед параметром. Пример: /-PAUSE
\
Отключает параметр при указании перед параметром. Пример: \-PAUSE

6.15. Значения параметров

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

Например -RESULTHTMLDIR={LOCALAPPDATADIR}\mytemp значение {LOCALAPPDATADIR}\mytemp может быть заменено на C:\Documents and Settings\Ilya\Local Settings\Application Data/SourceLocalizer\mytemp

{AppDir}
Название каталога (с путем к нему) программы локализации. Пример: c:\Program Files\SourceLocalizer
{ResultHtmlDir}
Название каталога (с путем к нему) в который будут сохранены HTML-отчеты. См. параметр -RESULTHTMLDIR. Пример: c:\work\html
{Drop1}
Заменяется названием первого файла «брошенного» на ярлык программы. См. параметр -DROPCOUNT
{Drop2}
Заменяется названием второго файла «брошенного» на ярлык программы. См. параметр -DROPCOUNT
{LocalAppDataDir}
Название каталога (с путем к нему) в временного каталога Windows, обычно расположенного в Documents and Settings. Пример: C:\Documents and Settings\Ilya\Local Settings\Application Data/SourceLocalizer
{clipboard}
Для такого файла в качестве содержимого будет использовано содержимое буфера обмена. Работает только при наличии параметра -GETTEXTFROMCLIPBOARDALLOW

6.16. В разработке

-ENABLESPELLCHECKCACHE
Включает кеширование орфографии. На данный момент кеширование орфографии мало эффективно, поэтому рекомендую не включать его. На больших объемах данных может привести к значительному снижению скорости проверки орфографии. По умолчанию кеширование отключено.
Site      PDF      Content