Языковые установки

В этом разделе:

·	Важное примечание: Пожалуйста заметьте, что поддержка Unicode включена в только Профессиональную версию Help & Manual 4.

Help & Manual 4 вводит полную поддержку Unicode, что означает, что он может теперь использоваться, чтобы редактировать и компилировать файлы справки фактически на всех языках, включая двубайтовые языки с больше чем 255 символами как китайский язык, тайский язык и так далее. В дополнение к установкам в Help & Manual, эти языки также имеют специальные требования конфигурации Windows. Если Вы производите справку на одном из этих языков, пожалуйста изучите главу Языки и Unicode в секции Справочной информации перед продолжением.

Даже если Вы работаете на английском языке или любом другом западноевропейском языке, важно проверить, что языковые установки вашего проекта являются правильными, чтобы гарантировать, что Вы не будете иметь никаких проблем с вашим выводом, например с отображением специальных символов и с сортировкой в Указателе ключевых слов.

См. Языковые установки в секции Свойства проекта справки для большего количества деталей относительно конфигурации

Где находить языковые установки:

·	Найдите Проект > Свойства проекта > Общие > Языковые установки, чтобы рассмотреть и редактировать языковые установки для вашего проекта.

·	См. Языковые установки в секции Свойств проекта справки для деталей.

·	Если Вы планируете генерировать PDF файл, Вы также должны установить Режим шрифта CID для правильной установки языка, который Вы используете.

Английский и западноевропейские языки:

Версия Windows и конфигурация:

Если Вы работаете на английском языке или любом другом западноевропейском языке, Вы можете редактировать, компилировать и отображать вашу справку на любой версии Windows 98 или позже. Язык версии Windows, которую Вы используете, не должен соответствовать языку вашей справки.

Языковые установки в Свойствах проекта:

Найдите Проект > Свойства проекта > Общие свойства > Языковые установки:

Язык файла справки:	Настройка по умолчанию является Английской (Соединенные Штаты). Это не должно быть изменено для английского и западноевропейских языков, если Вы не испытываете проблемы с сортировкой в Указателе ключевых слов.
Набор символов шрифта:	Настройка по умолчанию - ANSI_CHARSET. Это не должно быть изменено для английского и западноевропейских языков. Любая другая установка вероятно вызовет проблемы.
Заданный по умолчанию шрифт:	Это не заданный по умолчанию шрифт вашего проекта справки! Эта опция определяет только шрифт, используемый в Содержании и диалоговых окнах Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. и Справке HTML. Значение по умолчанию - MS Sans Serif,8,0. Winhelp и Справка HTML проектированы, чтобы работать с этим шрифтом и размером шрифта , и установка будет работать правильно на всех языках. Никогда не изменяйте это, если Вы полностью не понимаете последствия!
Режим Unicode на Windows 2000 и ХР:	Если Вы работаете на Windows 2000 или ХР, Вы можете использовать эти установки, чтобы получить больше управления кодированием текста в вашем выводе. Настройка по умолчанию должна кодировать в ANSI или Unicode автоматически, в зависимости от символов, которые Вы используете. Однако, Вы можете также назначить принудительно ANSI или Unicode, чтобы преодолеть проблемы кодирования в вашем выводе. См. Языковые установки для большего количества деталей.

Режим шрифта CID для внедрения шрифта PDF:

Перейдите Проект > Свойства проекта > Adobe PDF > Внедрение шрифтов:

Режим шрифта CID - специальный режим для того, чтобы внедрить шрифты Unicode в файлы PDF более эффективно. Это не обязательно для не-Unicode языков и должно вообще установлено CID Off, если Вы не используете специальные шрифты Unicode. См. Режим CID для шрифтов Unicode для подробностей.

Опция вывода UTF-8 в Параметрах экспорта HTML:

Найдите Проект > Свойства проекта > Справка HTML> Параметры экспорта HTML:

Help & Manual поддерживает кодирование Unicode UTF-8 для всех HTML-основанных выходных форматов (Справка HTML, Броузерная справка, eBook и Справка Visual Studio / MS Help 2.0). Эта опция уместна только для Unicode-основанных языков и нужно снять выделение для английского и западноевропейских языков (если Вы не используете шрифты Unicode с некоторой специальной целью).

Заметьте, что все опции в этой секции Свойств проекта используются всеми HTML-основанными выходными форматами (Справка HTML, Броузерная справка, eBook и Справка Visual Studio / MS Help 2.0). К опциям можно обратиться в соответствующих секциях в Свойствах проека, но они - те же во всех местоположениях. Вы не можете ввести другие установки опций для других выходных форматов.

Восточноевропейские языки, греческий, русский язык, турецкий язык и т.д:

Эта группа языков определена как языки со специальным набором символов, которые не требуют Unicode.

Версия Windows и конфигурация:

Если Вы работаете на Восточноевропейском языке, русском языке, греческом языке, турецком языке или любом другом языке со специальными символами, который не требует Unicode, Вы можете редактировать, компилировать и отображать вашу справку на любой версии Windows 98 или позже. Язык версии Windows, которую Вы используете, не должен соответствовать языку вашей справки.

Языковые установки в Свойствах проекта:

Найдите Проект > Свойства проекта > Общие свойства> Языковые установки:

Язык файла справки:	Эта установка должна указывать язык, на котором написана ваша справка. Это важно и для надлежащей сортировки в Указателе ключевых слов, и для надлежащей идентификации языка системой.
Набор символов шрифта:	Эта установка должна указывать правильный набор символов, чтобы отобразить язык, используемый в вашем файле справки.
Заданный по умолчанию шрифт:	Это не заданный по умолчанию шрифт вашего проекта справки! Эта опция определяет только шрифт, используемый в Содержании и диалоговых окнах Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. и Справке HTML. Значение по умолчанию - MS Sans Serif,8,0. Winhelp и Справка HTML проектированы, чтобы работать с этим шрифтом и размером шрифта , и установка будет работать правильно на всех языках. Никогда не изменяйте это, если Вы полностью не понимаете последствия!
Режим Unicode на Windows 2000 и ХР:	Если Вы работаете на Windows 2000 или ХР, Вы можете использовать эти установки, чтобы получить больше управления кодированием текста в вашем выводе. Настройка по умолчанию должна кодировать в ANSI или Unicode автоматически, в зависимости от символов, которые Вы используете. Однако, Вы можете также назначить принудительно ANSI или Unicode, чтобы преодолеть проблемы кодирования в вашем выводе. См. Языковые установки для большего количества деталей.

Режим шрифта CID для внедрения шрифта PDF:

Перейдите Проект > Свойства проекта > Adobe PDF > Внедрение шрифтов:

Опция вывода UTF-8 в Параметрах экспорта HTML:

Найдите Проект > Свойства проекта > Справка HTML> Параметры экспорта HTML:

Help & Manual поддерживает кодирование Unicode UTF-8 для всех HTML-основанных выходных форматов (Справка HTML, Броузерная справка, eBook и Справка Visual Studio / MS Help 2.0). Эта опция уместна только для Unicode-основанных языков и нужно снять выделение для Восточноевропейских языков и всех других языков, не требующих Unicode, даже если они имеют специальные наборы символов.

Языки на основе Unicode:

Эта группа включает все языки, которые требуют Unicode, что означает языки с больше чем 255 символами, требующими двух байтов для хранения каждого символа. Например, это включает большинство азиатских языков, как китайский, японский и тайский язык.

Версия Windows и конфигурация:

Редактирование проектов:

Проекты Help & Manual, написанные на Unicode-основанных языках, могут быть отредактированы только на Windows 2000, Windows ХР или позже с установленной поддержкой для языка, который Вы используете.

Компилирование проектов:

·	Вы можете компилировать проекты в Unicode в Броузерную справку, RTF MS Word, eBook и Справку Visual Studio / MS Help 2.0 с любой версией Windows 2000, Windows ХР или позже с установленной поддержкой для языка, который Вы используете.

Чтобы компилировать проект в Unicode в Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. или Справку HTML Вы должны также установить "системную локаль" вашей конфигурации Windows в соответствие с языком вашего проекта.

Как изменять системную локаль:

Заметьте, что системная локаль и пользовательская локаль являются разными! Просто установка отображения и/или языка ввода данных не изменяет системную локаль!

1.	Войдите в Windows c учетной записи пользователя с привилегиями администратора.

2.	Откройте секцию Язык и региональные стандарты в Панели управления Windows и выберите вкладку Дополнительно. (Эта вкладка отображена, только если Вы имеете привилегии администратора!)

3.	Выберите язык вашего проекта в установке Язык для не-Unicode программ и перезапустите Windows, чтобы применить установку.

Просмотр компилируемой справки:

Выходные файлы компилируемого Unicode Help & Manual могут быть рассмотрены на большинстве версий Windows, на которых установлена надлежащая поддержка языкам Unicode. Некоторые особенности Unicode Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. и Справки HTML (Полнотекстовой поиск, Указатель ключевых слов, сортировка) будут работать должным образом, только если язык версии Windows будет соответствовать языку файла справки. Например, все функции китайского файла Справки HTML будут работать правильно только на китайской версии Windows.

·	Смотрите в Поддержка Unicode H&M большее количество деталей относительно этого.

Языковые установки в Свойствах проекта:

Найдите Проект > Свойства проекта > Общие свойства> Языковые установки:

Язык файла справки:	Эта установка должна указывать язык, на котором написана ваша справка. Это важно и для надлежащей сортировки в Указателе ключевых слов, и надлежащей идентификации языка системой. В Unicode-основанных языках эта установка также говорит Help & Manual обрабатывать текст в вашем проекте, как Unicode.
Набор символов шрифта:	Эта установка должна указывать правильный набор символов, чтобы отобразить язык, используемый в вашем файле справки. Это также особенно важно для надлежащего обрабатывания Unicode. Вы должны иметь надлежащий набор символов для вашего языка, установленного для Help & Manual, чтобы быть в состоянии обработать и компилировать язык правильно.
Заданный по умолчанию шрифт:	Это не заданный по умолчанию шрифт вашего проекта справки! Эта опция определяет только шрифт, используемый в Содержании и диалоговых окнах Winhelp и Справке HTML. Значение по умолчанию - MS Sans Serif,8,0. Winhelp и Справка HTML проектированы, чтобы работать с этим шрифтом и размером шрифта , и установка будет работать правильно на всех языках. Никогда не изменяйте это, если Вы полностью не понимаете последствия!
Режим Unicode на Windows 2000 и ХР:	Если Вы работаете на Windows 2000 или ХР, Вы можете использовать эти установки, чтобы получить больше управления кодированием текста в вашем выводе. Настройка по умолчанию должна кодировать в ANSI или Unicode автоматически, в зависимости от символов, которые Вы используете. Однако, Вы можете также назначить принудительно ANSI или Unicode, чтобы преодолеть проблемы кодирования в вашем выводе. См. Языковые установки для большего количества деталей.

Режим шрифта CID для внедрения шрифта PDF:

Перейдите Проект > Свойства проекта > Adobe PDF > Внедрение шрифтов:

Опция вывода UTF-8 в Параметрах экспорта HTML:

Найдите Проект > Свойства проекта > Справка HTML > Параметры экспорта HTML:

Если UTF-8 не будет выбран для Unicode-основанного проекта, то все символы вне стандартного набора символов американского ASCII экспортируются как кодированные символы в выводе HTML (&#1234 и т.д). Это будет вообще отображаться должным образом, но может вызвать проблемы с поиском по всей Справке, и сделает просмотр исходного кода трудным или невозможным.

1.	Тестовая компиляция азиатских языков на неазиатском Windows:

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

·	Найдите Инструменты > Настройки > Компиляторы и активизируйте опцию .

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

См. также:

Языки и Unicode (Справочная информация)

Языковые установки (Свойства проекта)