Навигация:  Справочник свойств проекта > Броузерная справка >

Опции экспорта HTML

Печать этого раздела Предыдущая страницаВернуться к краткому обзору главыСледующая страница

Эти опции управляют многими ключевыми аспектами того, как ваше проектное содержимое преобразуется в код HTML для всех HTML-основанных выходных форматов, включая то, как стили, используемые в вашем проекте, экспортируются в файл CSS, как графические изображения преобразуются и экспортируются, и множество других важных установок.

Это - общая секция:

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

С несколькими маленькими исключениями (отмеченными в описаниях отдельных установок), все опции используются всеми выходными форматами.

Установки Опций экспорта HTML:

Расширение для файлов разделов HTML:

По умолчанию все файлы раздела HTML экспортируются с расширением .htm. Вы можете изменить это на .html, .asp или .php, но эти расширения поддерживаются только в Броузерной справке. Если Вы выберете .asp или .php, то стандартное .htm расширение будет использоваться в Справке HTML и MS Help 2.0.

Эта установка не относится к eBook.

Имя файла таблицы стилей CSS:

Эта установка позволяет изменить имя файла таблицы стилей, экспортирующего информацию стилей CSS. Заданное по умолчанию имя файла - default.css.

Так как таблица стилей не доступна в eBook, эта установка не относится к eBook.

Кодирование размера шрифта:

Эта установка позволяет Вам выбирать, как определены размеры шрифта в вашем выводе. Вы можете выбрать pt (пункты), px (пиксели), % (проценты) или em (где 1 em = 100 %). Установка, которую Вы выбираете, управляет тем, как отображены шрифты на экране пользователя, и может ли пользователь изменить размер шрифта.

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

Пункты:
Когда Вы экспортируете размер шрифта в пунктах, пользователь не может корректировать размер шрифта. Однако, размер шрифтов, отображенных на экране компьютера пользователя, изменится в зависимости от установки DPI экрана Windows и/или установок размера шрифта. Например, если Вы разрабатываете вашу справку на машине с установкой Windows на 96dpi (стандарт), ваше размещение текста может быть неправильным при установке компьютеров на 120dpi (шрифты выглядят слишком большими, текст в выступах может быть более широким, чем отступ и т.д). Поэтому размер шрифтов изменяется, но размер других элементов размещения (отступы, блокированные ячейки таблицы и т.д.) - нет.

Пиксели:
Это - единственная установка, которая гарантирует, что шрифты и размещение будут всегда отображаться так, как Вы видите их на вашей машине. Размер шрифта всегда использует то же число пикселей, таким образом он - всегда тот же размер относительно других элементов вашего размещения, как отступы, графика и так далее.

Процент или em:
Если Вы выберете процент или em, то пользователь будет в состоянии корректировать размер шрифта в справке, например, удерживая Ctrl и поворачивая колесо прокрутки мыши. Это может и нехорошо, потому что размер других элементов размещения (графика, отступы, блокированные ячейки таблицы и т.д.) не будет изменяться, таким образом пользовательские корректировки могут "нарушить" ваше размещение.

Размер шрифта стиля Normal:

Если Вы выбираете процент или em для кодирования размера шрифта (см. выше), Вы можете также использовать эти установки, чтобы определить размер стиля Normal относительно заданного по умолчанию шрифта броузера пользователя. Значение выражено в проценте, и заданное по умолчанию - 100 %. Это обычно предпочтительно, потому что большинство пользователей установит заданный по умолчанию шрифт в их броузерах по размеру шрифта, который они предпочитают.

Экспорт имен стиля:

Когда это выбранно, Help & Manual использует полные имена ваших стилей в таблице стилей. Это делает таблицу намного более легкой для чтения, если Вы когда-либо хотите рассмотреть или редактировать ее вручную.

Если Вы снимаете выделение этой опции, имена стиля преобразуются в алфавитно-цифровые коды, которые не настолько "благоприятны для человека". Это может сделать ваш проект немного меньшим, но не очень.

Экспорт списков как таблиц:

Эта установка рекомендуется. Когда она выбрана, нумерованные и маркированные списки преобразуются в таблицы в HTML-основанном выводе. Это - единственный способ сделать устойчивые списки, которые отображаются правильно во всех броузерах, используя отступы, которые Вы устанавливаете. Даже в Справке HTML, которая использует MS Internet Explorer для предоставления HTML, Вы найдете, что списки отображаются лучше как таблицы.

Если Вы снимете выделение этой опции, то списки экспортируются как стандартные <OL> и <UL> списки с элементами списка <LI>. Если Вы не используете очень простые списки, предоставление этих элементов будет неудовлетворительно во многих броузерах.

Экспорт UTF-8 кодированного HTML:

Когда эта опция выбрана, Help & Manual использует кодирование UTF-8, чтобы экспортировать полностью Unicode-послушный HTML. Это обычно не нужно для английского языка и других западноевропейских языков, даже для специальных символов. Это необходимо только для языков, как китайский и японский язык, которые абсолютно требуют Unicode, чтобы быть отображенными должным образом.

Так как кодирование UTF-8 использует два байта на символ, активизация этой опции может увеличить размер ваших выходных файлов. Используйте это, только если Вы действительно нуждаетесь в этом.

См. Википедия для превосходного фонового обсуждения UTF-8 и других методов кодирования Unicode.

Экспорт XHTML 1.1 компилированных HTML:

Если Вы выберете это, то Help & Manual генерирует код HTML согласно спецификации XHTML 1.1.

Это используется только в Броузерной справке (компилятор Справки HTML не может обработать XHTML-послушный код, и это также не уместно для eBook).

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

Если рисунок без заголовка, взять имя файла как подсказку:

Изображения га страницах HTML могут иметь атрибут ALT, который отображает маленький текст в "подсказке", когда пользователь наводит указатель на изображение.

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

Предпочтения конверсии для рисунков и изображений Impict:

Эти опции управляют тем, как преобразованы и экспортируются изображения в вашем проекте, когда Вы компилируете в HTML-основанные форматы.

То, какая опция предоставляет лучшие результаты, зависит от типа изображений в вашем проекте. GIF предоставляет наименьшие файлы лучшего качества для скриншотов с 256 цветами или меньше.

Скриншоты любого разрешения почти всегда выглядят ужасно, когда преобразованы в JPG, таким образом Вы должны всегда выбирать ваши установки, чтобы удостовериться, что этого не случится. Всегда используйте GIF и не больше, чем 256 цветов, для скриншотов.

JPG и полноцветный PNG действительно необходимы только для фотографий и графики с непрерывным спектром тонов. Чтобы уменьшить размер файла справки, удостоверьтесь, что все файлы имеют не больше, чем 256 цветов.

Отметьте, что Не конвертировать изображения вообще полностью подавляет вывод всей графики в вашем выводе.

Выходное качество для JPEG:

Вы можете уменьшить размер файла, уменьшая качество, но это также сделает просмотр изображений менее хорошим. Значение между 80 и 90 обычно приемлемо.

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

См. также:

Конфигурайия вывода

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

Броузерная справка (Форматы справки)