|
О внутреннем коде HTML |
    |
|
О внутреннем коде HTML |
|
Функция Вставить > Простой код HTML позволяет Вам включать простой код HTML в любом пункте в ваших разделах и экспортировать его неизменным во все HTML-основанные выходные форматы (Справка HTML, Броузерная справка, eBook и Справка Visual Studio / MS Help 2.0).
Простой код HTML в eBook:
Отметьте, что, хотя простой HTML экспортируется в eBook, только простой форматирующий код будет фактически работать в этом формате. Вы не можете использовать сценарии или DHTML, потому что простое приложение средства просмотра, включенное в eBook, не интерпретирует никаких сценариев.
Когда использовать простой код HTML:
Есть в основном две ситуации, где Вы можете хотеть использовать простой код HTML:
| · | Когда Вы хотите добавить особенности к вашему HTML-основанному выводу с динамическим HTML и сценарием. |
| · | Когда Вы хотите написать ваш собственный код HTML, чтобы достигнуть результатов форматирования, которое Вы не можете создать непосредственно с Help & Manual. |
Начиная со введения в Help & Manual 4 динамических стилей и другими радикально улучшенных возможностей форматирования, Вы будете вероятно иметь намного меньше причин использовать простой HTML для форматирования. Однако, это очень полезно для опытных пользователей, которые хотят "украсить" вывод любым количеством путей.
Функция Вставить > Простой код HTML также предпочтительна для использования ссылок JavaScript для того, чтобы вставить более сложный код JavaScript в ваши страницы. Так как код вставлен в странице, Вы можете также включить ссылки, и Вы имеете больше свободы форматирования вашего кода, потому что Вы не ограничены синтаксисом вставки ссылки.
Как вставляется простой код HTML:
Простой код HTML вставляется непосредственно в текущей позиции курсора в вашем тексте раздела. Он вставлается точно так, как Вы пишете его, без любых изменений, и не анализируется или проверяется никаким путем. Единственные исключения - некоторые ссылки файла рисунка в ваших шаблонах раздела HTML, которые анализируются и экспортируются с вашим выводом.
Это означает, что Вы на 100 % ответственны за то, что удостоверились, что Вы пишете допустимый код!
Так как все содержимое раздела всегда вставляется между тэгами <BODY> и </BODY> шаблона раздела HTML, простой код HTML, который Вы вводите, также всегда вставляется после начального тэга <BODY>, даже если Вы вводите его прямо наверху страницы раздела. Важно помнить это, если Вы вставляете сценарии, которые должны быть в секции <HEAD>.
Если ваш код содержит сценарии, которые функционируют, только если они находятся в секции <HEAD> или другой секции страницы выше секции <BODY>, лучше вставить код в шаблон HTML для раздела. См. ниже для деталей.
Добавление HTML кода к шаблонам HTML:
Вы не можете использовать Вставить > Простой код HTML, чтобы добавить код вне тэгов <BODY> и </BODY> страниц вывода HTML. Если Вы должны сделать это, Вы должны добавить код к шаблону HTML, который используется, чтобы генерировать весь код раздела вне тэгов <BODY> и </BODY>.
Код, который Вы добавляете к шаблону HTML, будет включен в каждый раздел, сгенерированный с шаблоном. Если Вы добавляете код к шаблону Main, это означает, что код будет добавлен почти к каждому разделу во всем вашем проекте, потому что Main - заданный по умолчанию шаблон.
Добавление кода шаблона только к выбранным разделам
Если Вы хотите включить код только в определенные разделы, просто создайте дополнительный тип справочного окна и добавьте ваш дополнительный код к шаблону HTML для этого типа окна. (Каждый тип справочного окна имеет собственный шаблон раздела HTML.) Тогда код будет включен только в разделы, связанные с этим типом справочного окна.
| · | Чтобы назначить тип справочного окна на раздел, выберите имя типа справочного окна во вкладке Опции раздела, в области Окно справки:. |
Ссылка на функции сценария в простом коде HTML:
Если код, который Вы вставляете в ваши разделы с Вставить > Простой код HTML, содержит обращения в функции JavaScript, которые Вы написали, Вы можете или должны включить эти функции во внешние файлы сценария .JS или в секцию <HEAD> ваших страниц раздела. Есть два способа сделать это:
| · | Добавьте ваш отдельный файл сценария .JS к секции Багажа, чтобы включить его в ваш вывод. Потом редактируйте шаблон HTML для ваших разделов и добавьте включение для файла сценария .JS в соответствующем местоположении в файле шаблона. |
| · | Редактируйте шаблон HTML для ваших разделов и вручную добавьте сценарий с функциями к секции <HEAD> шаблона. Отметьте, что это будет включать код сценария в каждую страницу раздела, даже те страницы, где функции не нужны (см. выше для деталей относительно того, как избежать этой проблемы). |
См. также: