HTML как средство создания файлов помощи

Размещено на http://www.allbest.ru/

План

Введение

1. Общая характеристика возможностей HTML

2. Создание файлов помощи с использованием HTML

3. Пример создания файла помощи

Заключение

Литература

Введение

В работе рассматривается язык разметки гипертекста HTML (Hypertext Markup Language); первая спецификация этого универсального и общедоступного языка разметки - HTML была утверждена в 1991 году. HTML стал стандартом и одновременно «корнем» для всех разрабатываемых Web страничек.

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

Современные Web-страницы уже не обходятся одним только HTML. Его гармонично дополняют средства динамического HTML: скрипт языки JavaScript и/или VBScript, каскадные таблицы стилей(CSS), иногда присутствуют Java-апплеты. По сути дела, можно вывести для современной Web-страницы: Web-страница=HTML+DHTML(JavaScript/VBScript, CSS, Java-апплеты)+CGI То есть на любой странице должна присутствовать HTML-верстка - расположение элементов дизайна текста и необходимые скрипты - как расширение HTML в области расположения и описания свойств различных объектов. CGI-скрипты могут играть первостепенную роль, формируя всю страницу, наполняя ее необходимыми, обновленными данными или второстепенную роль, - включаясь в нее.

Цель работы состоит в общей характеристике языка разметки гипертекста HTML. В соответствии с поставленной целью задачи работы сформулированы следующие:

1. обзор основных возможностей HTML

2. анализ практического применения HTML (на примере создания файлов помощи).

1. Общая характеристика возможностей HTML

HTML - язык разметки гипертекста. Гипертекст - текст со вставленными в него словами (командами) разметки, ссылающимися на другие места этого текста, другие документы, картинки и т.д. Во время чтения такого текста (в соответствующей программе, его обрабатывающей и выполняющей соответствующие ссылки или действия) вы видите подсвеченные (выделенные) в тексте слова. Если наехать на них курсором и нажать клавишу или на кнопку (глаз) мышки, то высветится то, на что ссылалось это слово, например, другой параграф той же главы этого же текста. В WWW по ключевым словам можно попасть в совершенно другой текст из другого документа, войти в какую-нибудь программу, произвести какое-либо действие и т.д. В Internet в контексте WWW можно получать доступ к чему угодно, к telnet, e-mail, ftp, Gopher, WAIS, Archie, USENET News и т.п. В WWW можно ссылаться на данные на других машинах в любом месте сети, тогда при активации этой ссылки эти данные автоматически передадутся на исходную машину и вы увидите на экране текст, данные, картинку, а если провести в жизнь идею мультимедиа, то и звук услышите, музыку, речь. Это слегка напоминает Gopher, но фактически это принципиально другое и новое. В Gopher имеется жесткая структура меню, по который вы двигаетесь, как вам угодно. Эта структура не зависит от того, что вы делаете, какой документ пользуете и т.д. В WWW вы двигаетесь по документу, который может иметь какую угодно гипертекстовую структуру. Можно свободно организовать структуры меню в гипертексте. Имея редактор гипертекстов, можно создать любую структуру рабочей среды, включая документацию, файлы, данные, картины, программное обеспечение и т.д., и это не будет новое программное обеспечение, а просто гипертекст.

Современные программы разработки Web-серверов, такие как MS FrontPage или Web Pen для Windows, дают возможность даже новичку без всякого штудирования учебников легко создавать готовые странички. При этом cпециалист по созданию Web-сайтов, называемый Web-мастером, берет готовые файлы (тексты, таблицы, графику, базы данных, звук, анимацию, видеофильмы, программы) и с помощью кнопок и команд меню оформляет страницы сайта. Подобные программы, выполняя команды инструментальных и операционного меню, формируют гипертекст WWW-сервера.

Исходные текстовые, табличные и графические и другие объекты включаются в Web-site посредством тегов (tag = ярлык, этикетка). Тег - это последовательность символов, задающая

1)положение объекта на странице сайта,

2)внешний вид объекта или

3)связь данной страницы с другими страницами этого сайта, а также с любым другим сервером.

Тег называют также управляющим маркером, флагом. Программы типа Web Pen сами расставляют теги, поэтому пользователь таких программ может не знать языка разметки гипертекста (HTML = HyperText Markup Language).

Знание HTML необходимо по пяти причинам.

Во-первых, Web-мастер анализирует сайты фирм-конкурентов и просто удачные экземпляры WWW-серверов. Такой анализ, необходимый для совершенствования своего сайта, невозможен без знания языка разметки гипертекста.

Во-вторых, совершенствование своего Web-сервера без полной его переделки (что долго и дорого) удобно производить путем ручной вставки и удаления объектов и тегов.

В-третьих, HTML непрерывно развивается, поэтому программы типа MS FrontPage все время отстают от новейших возможностей языка.

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

Наконец, в-пятых, потратив деньги на приобретение программы, нужно еще потратить время на ее освоение.

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

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

1) на данном сайте, то есть в папке, содержащей все htm-файлы, графику, звук, анимацию, видеофильмы, программы;

2) вне сайта в других в папках на данном компьютере;

3) в системе World Wide Web, то есть на других Web-серверах;

4) в Internet на серверах других типов(FTP, Gopher).

Применение механизма гипертекстовых ссылок создает всемирное единое информационное пространство, из которого сотрудники торговой фирмы получают нужные им сведения. Стандарт HTML, как и все другие стандарты, имеющие отношение к Web, разрабатывается под эгидой консорциума World Wide Web Consortium (W3C). Спецификации стандартов и проекты новых предложений можно найти по адресу http://www.w3.org. Самая последняя разработка рабочей группы по HTML в W3C - рабочий проект HTML 4.0. Кроме HTML, Web-мастера используют и другие языки, например, Java (Ява), Perl, Си.

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

HTML-документ состоит из текстов, графики, таблиц и других объектов, которые представляют собой содержимое документа. Программа просмотра использует при этом теги, которые записаны в HTML-документе для задания структуры расположения объектов и их внешнего вида. Чаще всего HTML-теги записываются парами (начальный и конечный теги), между которыми размещаются текст и другие объекты документа. Имя конечного тега идентично имени начального, но перед именем конечного тега ставится косая черта (/), так называемый слэш. Оформление HTML-документа просто: он начинается тегом и заканчивается тегом . Имя тега может быть записано как строчными, так и прописными буквами.

Запустить приложение Блокнот, используя кнопку “Пуск” на панели задач: ПУСК => ПРОГРАММЫ => СТАНДАРТНЫЕ => БЛОКНОТ.

Разместить на рабочем столе одновременно два окна: окно MS Word с данной методичкой и окно Блокнота.

Набрать в поле редактирования Блокнота следующий текст:

Данную программу, как и все последующие, можно не набирать на клавиатуре,а скопировать в поле редактирования Блокнота из этой программы используя команду операционного меню ВИД => ИСТОЧНИК. Неиспользуемые в программаж сноски набраны черным шрифтом.

Здесь записан текст, появляющийся на экране при открытии этого документа.

А этот текст будет записан курсивом

Если времени не хватает для набора текста, то прочтите Блокнотом файл ris1.htm, находящийся в том же каталоге, из которого Вы прочли данную методичку.

Сохранить документ в рабочем каталоге под именем, например, ris1a.htm (Блокнот закрывать не следует, он пригодится для дальнейшей работы).

В окне рабочего каталога выполнить двойной щелчок левой кнопкой мыши по значку только что созданного документа ris1a.htm и с помощью MS Internet Explorer просмотреть получившийся документ. Текст документа состоит из элементов заголовок и тело, которые выделяются соответственно тегами <HEAD></HEAD> и <BODY></BODY> В заголовке теги <TITLE> . . . </TITLE> ограничивают текст, используемый как надпись в заголовке окна программы просмотра. Такую же надпись имеет кнопка на панели задач при просмотре документа.

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

Заголовок страницы. Заголовок Web-страницы представляет собой информацию. заключенную внутри 'цемента (секции) HEAD.

<TITLE > это элемент TITLE определяет текст, который появляется в заголовке окна броузера во время просмотра страницы. Этот текст не только служит подсказкой, но может использоваться и поисковыми машинами для анализа страниц. Су шествует три способа для поиска страниц в Интернете па основе текстовых данных: по ключевым словам элемента МЕТА, по тексту, разметенном) на странице. и по строке заголовка внутри элемента TITLE.

- STYLE -и - LINK -. Тег STYLE тоже должен располагаться внутри элемента HEAD, Если вы хотите разобраться, какие нестандартные форматы используются на странице, надо просмотреть содержимое этого элемента. В нем будут указаны необходимые форматы. Если таких форматов нет, значит стили страницы записаны в отдельном файле. Ссылка на такой файл должна находиться в элементе LINK.

Секция заголовка может содержать несколько цементов МЕТА, каждый из которых отвечает за определенный набор параметров. Использование элементов МЕТА не является обязательным, но некоторые настройки могут быть весьма важны. Так, например, известно, что броузер в некоторых случаях способен автоматически определить вид кодировки страницы. Пользователь, работая с броузером, может выбрать в меню определенную кодировку. Чтобы исключить неопределенность при просмотре конкретной страницы, на ней целесообразно разместить указание на кодовую страницу.

Информация, сосредоточенная в элементах МЕТА, определяет общие настройки Web-страницы и называется профилем. Профили можно хранить в отдельных файлах и присоединять к определенной странице при помощи специального атрибута элемента HEAD:

<HEAD prorIle=«lJRL»>

Стандартные атрибуты. Существует ряд атрибутов, которые moist использоваться во многих элементах. Часть этих атрибутов очень важна для конструирования Web-страниц, а часть подходит только для решения определенных задач.

Атрибут id выполняет функции уникального имени элемента. В зависимости от типа элемента, этот атрибут выполняет различные функции

Атрибут classid задает программу или объект, которые могут использоваться в определенных элементах.

Атрибут style может использоваться со многими элементами. Он предназначен ятя определения формата конкретного элемента и может принимать самые разные значения.

Похожие функции выполняет атрибут class. Его можно указывать, если в секции HEAD расположен элемент STYLE или использована ссылка на каскадную таблицу стилей (см. ниже раздел «Таблицы стилей»).

Атрибут align используется для выравнивания текста, объектов или элементов целиком. Выравнивание может выполняться относительно границ окна, рамки таблицы и т. д. Каждый элемент позволяет указывать определенные значения для этого атрибута. В общем случае значения могут быть такие:

* left - выравнивание по левому краю;

* right - выравнивание по правому краю;

* justify - выравнивание по ширине (для текста);

* center - выравнивание по центру (по горизонтали):

* middle - выравнивание по центру (по вертикали):

* top - выравнивание по верхней границе;

* bottom - выравнивание по нижней границе.

Атрибут lang определяет, на каком языке набран текст внутри текущего элемента: lang - «код языка»

Атрибут dir теоретически может использоваться в разных элементах, но не все броузеры обеспечивают его работу.

Форматирование текста. Текст - единственный объект Web-страницы, который не требует специального определения. Иными словами, произвольные символы интерпретируются по умолчанию как текстовые данные. Но для форматирования текста существует большое количество элементов. Большинство из них, кроме специальных, поддерживает стандартные атрибуты: id, class, lang. dir, title, sty le и атрибуты событий.

Изначально в HTML было введено меньше возможностей для форматирования текста, чем в обычные текстовые редакторы. В результате авторам гипертекстовых документов приходилось прибегать к различным ухищрениям, чтобы придать тексту заданный вид. Сейчас положение изменилось, но все дополнительные возможности осуществляются за счет применения таблиц стилей. Например, только с помощью свойства text-indent можно задать величину отступа первой строки абзаца.

Форматировать текст можно и с помощью традиционных элементов: выделять фрагменты курсивом, полужирным, выбирать шрифт и т.д. Рассмотрим эти элементы. Для них могут быть использованы стандартные атрибуты id. class, lang, dir. title, style, атрибуты событий, а также атрибуты, определяющие уникальные свойства определенных элементов.

Элемент абзаца paragraph - один из самых полезных. Он позваляег использовать только начальный тег, так как следующий элемент Р обозначает не только начато следующего абзаца, но и конец предыдущего. В тех случаях, когда по смыслу необходимо обозначить завершение абзаца можно использовать и конечный тег. В некоторых случаях начальный тег удобно ставить в конце строки: он не только обозначит конец абзаца но и выполнит функцию тега <BR> (разрыв строки). Вместе с элементом абзаца можно

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

<ЕМ> </ет> и <DFN> </dfn> элементы, обозначающие выразительность (emphasis) данного фрагмента текста и определение чего-либо (definition). Оба элемента аналогичны но своему действию элементу 1, то есть в большинстве случаев позволяют выделить текст курсивом.

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

Эти и другие элементы содержания могут иметь стандартные атрибуты: id. class, lang, dir, title, style, атрибуты событий.

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

cite=« Л0ресоокулшта->крва1кттн11ка''11ре;1!ю.гаж!ся, что адрес задается в виде URL.

Таблицы стилей (style sheets) являются одним из самых эффективных

нововведений HTML 4. Они позволяют изменять свойства элементов в соответствии с желаниями разработчика страницы. К обычным таблицам таблицы стилей не имеют никакого отношения. В общем случае шаблон таблицы стилей выглядит так:

Элемент. имя стиля (Свойство 1: значение; свойство 2: значение:... j) В результате для определенного элемента задается набор свойств (ассортимент которых весьма значителен). Тем самым снимаются ограничения HTML, а для дизайнера (автора страницы) открывается широкое поле деятельности. Одна из важнейших особенностей стилевого оформления заключается в том. что преобразованию подвергаются все элементы, заключенные внутри цемента с заданным стилем. Так. определив некоторый стиль для элемента BODY, вы присваиваете его всему содержимому Web-страницы. По аналогии с объектно-ориентированными языками программирования это качество называется наследованием.

В соответствии с правилами HTML, автор, использующий стили, должен включить в заголовок документа (элемент HEAD) соответствующее мета-определение:

<МЕТА http-equi\=«Content-Style-Type» content-»text/css»>

Броузер получит информацию, какой язык определения стилей использован. «CSS» в данном случае означает «каскадная таблица стилей» (Cascading Style Sheets). Это одновременно стандарт и язык, расширяющий традиционный HTML. В настоящее время существует две спецификации (CSS1 и CSS2), в которых перечислены свойства элементов. «Эти свойства очень похожи на атрибуты, но есть два различия: свойств намного больше и правила синтаксиса несколько иные.

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

Списки (list) были введены в HTML, несомненно, под влиянием успеха текстовых редакторов. Список отличается от обычного текста прежде всего тем, что пользователю не надо думать о нумерации его пунктов: эту задачу программа берёт на себя. Гели список дополняется новыми пунктами или укорачивается, нумерация корректируется автоматически. В случае ненумерованных списков программа ставит перед каждым пунктом маркеры: кружки, прямоугольники, ромбы или другие изображения, В результате список принимает удобочитаемый, «фирменный» вид. Теги для создания списков можно условно разделить на две группы: одни определяю! общий вид списка (и позволяют указывать атрибуты), а другие задают его внутреннюю структуру. В списках можно использовать стандартные атрибуты. Существует несколько разновидностей списков.

Самым простым является ненумерованный список (unordered list). Его шаблон имеет вид

<UL>

<L1>ПУНКТ

<L!> ПУНКТ!

<L1> ПУНКТ 1<1.1> ПУНКТ1 <ДЛ.>

Элемент UL является своеобразным обрамлением списка. Он позволяет отделять один список от другого. Элемент LI обозначает каждый из пунктов.

<OL> <[.!> </ol> - тго структура нумерованного списка (ordered list) похожа на предыдущую:

<OL><LI>ПУHKTl<LI> ПУНКТ1<[Л>ПУНКТ1<1Л> ПУНКТ 1</OL>

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

Произвольный текст < A h ref> = « Адрес ссылки» текст to щелчка - а

Или такой:

<А hre>f=«Aдpec ссылки» * <IMCi «гс= «Ссылка на рисунок» </а>

Первый шаблон используется в том случае, когда гиперссылка встречается в тексте. Атрибут href может указывать на ресурс Интернета, файл на локальном диске или на метку внутри текущей страницы. Текст, расположенный внутри элемента А, представляет собой видимую часть гиперссылки. На нем должен щелкнуть пользователь, чтобы осуществить переход. Броузер выделяет этот фрагмент цветом, а после использования гиперссылки меняет цвет, чтобы обеспечить подсказку.

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

2. Создание файлов помощи с использованием HTML

Для создания файлов помощи с использованием HTML применяется система Help&Manual.

Что такое Help&Manual? Это система для быстрого и наглядного создания файлов помощи и электронных документов - в первую очередь для Windows. При этом программа ориентирована на различные группы, начиная от обычных пользователей, волей судьбы вынужденных создавать электронные документы, и заканчивая профессиональными программистами, создающими файлы помощи для разрабатываемых продуктов. Инсталляционный пакет Help&Manual занимает 12 мегабайт; кроме того, для полноценной работы желательно поставить на машину MS HtmlHelp (3.5 мегабайта) и HtmlHelp Workshop (1.6 мегабайта), после чего ваше рабочее место писателя можно считать полностью оборудованным. Установка программы не вызывает каких-либо затруднений, все шаги подробно документированы и логичны. Кроме того, для вашего удобства предлагается поставить примеры, изучая которые, можно в дальнейшем быстрее освоить продукт (11 мегабайт примеров из 30 мегабайт, занятых в итоге).

Help&Manual (последняя версия 3.25) помогает вам удобно и с минимальными затратами создать шаблон системы помощи для пользователя, после чего на его основе можно сгенерировать итоговый документ в следующих форматах:

· WinHelp 2 (MS Help 2);

· HTML Help;

· Classic Windows Help;

· HTML (classic help documentation);

· Adobe PDF;

· MS Word (RTF format);

· MMHelp.

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

1. создание нескольких основных разделов и подразделов;

2. наполнение каждого из разделов статьями, описывающими те или иные особенности выбранной темы;

3. формирование заголовков статей, по которым можно будет быстро найти необходимый материал и собираемых затем в таблицу тем, доступных для поиска;

4. описание ключевых слов, по которым можно произвести быстрый поиск в итоговом документе данной статьи;

5. создание списка ассоциативных ключей, по которым будет формироваться ссылка «смотрите также».

Такой порядок работы используется еще со времен создания первых файлов помощи для MS Windows. Кстати, многие системы визуальной разработки электронных документов используют данную последовательность.

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

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

Текст можно набирать как в самом Help&Manual, так и других офисных системах - где вам будет удобнее. Часто документацию поставляют в двух комплектах: урезанный вариант в форматах MS Word и подобных ему, а более полную и технически дополненную - в виде файлов помощи. Фактически, первоначальный «укороченный» текст просто перекочевывает частично или полностью в те или иные разделы файлов помощи.

Унифицируйте внешний вид изображений, которые будут сопровождать описание. Сходные по размерам и внешнему виду картинки качественно отличают прилично выполненные документы от слепленных «на коленке» самоделок.

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

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

Теперь давайте рассмотрим, как нам может помочь в этой работе Help&Manual.

Первым делом мы заполним дерево навигации по документу, используя для этого панель Table of Contents. Обычно она расположена в левой части рабочего окна программы, при этом ее можно оттуда «отцепить» и перетащить в более удобное место. Двойной щелчок на заголовке этого плавающего окна вернет панель обратно. Попутно стоит заметить, что любые панели с кнопками управления программой можно также передвигать по экрану и размещать где угодно. В заполняемом дереве заголовков можно добавлять, удалять элементы, редактировать их описание и передвигать их по всему дереву с места на место (включая и все подразделы, расположенные ниже). За все возможные варианты управления разделами отвечает раздел Topics в меню. Кроме описанного редактирования, сюда входит еще управление «развертыванием/свертыванием» всех веток для просмотра, запись содержимого раздела в виде файла или загрузка информации с диска.

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

· стандартное редактирование (выделение, копирование, перенос, удаление);

· дополнительное оформление текста (изменение размера и вида шрифтов, цвета выводимого текста;

· форматирование внешнего вида параграфов, установка отступов и расположения на странице (справа, слева, по центру);

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

Кроме того, набираемый текст можно форматировать согласно уже заложенным шаблонам (оформить как заголовок, как обычный текст, согласно заложенным заранее настройкам). Стили оформления (шаблоны) можно добавлять и редактировать в настройках программы. Весьма удобна возможность использования «горячих клавиш» для их быстрого вызова.

Далее, мы можем дополнить полученный текст дополнительными элементами оформления:

· изображениями (поддерживается два популярных для MS Windows формата: BMP, Windows Metafile);

· AVI-файлами;

· OLE-объектами (не забудьте убедиться, что для его показа данный объект будет установлен у клиента на машине);

· символами из шрифтов (греческий, латинский и т.д.);

· горизонтальными линиями, разделителями страницы;

· HTML-кодом.

Для тех, кому приходится разрабатывать сложные тексты, будет удобна возможность использования специальных инструментов:

· генерация текста согласно заложенным на странице логическим управляющим блокам (генерировать данную часть текста только для тех или иных итоговых проектов);

· использовать переменные, которые в момент генерации будут заменены на описанные для данной переменной значениями (названия продуктов, версии продукта, копирайты и так далее);

· «якоря», которые позволяют переходить на конкретные части текста из других разделов справочной системы;

· возможность встраивать одни разделы в качестве подразделов в другие.

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

Следующим шагом после размещения содержимого документов является приведение к стандартам внешнего вида. Использование корпоративных стандартов по стилям документов и уже описанных выше шаблонов Help&Manual (Style Sheet) позволит быстро оформить итоговый документ.

Завершающим этапом работ является создание внутренних связей в документе и описание ключевых слов для последующего поиска в массиве информации. Для удобства навигации по уже заложенным в документ ссылкам лучше всего использовать Topic Referrer Report (вызывается из меню Topic / Find Referrers). Вторым мощным инструментом является Project Report (Tools / Report). Вы можете выбрать описание статей по различным маскам (включая показ модифицированных разделов в тот или иной промежуток времени), задать детализацию отчета, а также всегда иметь перед глазами статистику возможных проблем в создаваемом документе (нарушение связей, потерянные статьи и так далее).

Из дополнительных инструментов, включенных в Help&Manual, хочется отдельно отметить Screen Capture - средство для «моментальных снимков» внешнего вида программ. Вызов данного инструмента позволит вам получить в одно нажатие клавиши мыши готовую иллюстрацию к разрабатываемому документу. Screen Capture радует обилием настроек, которые включают в себя масштабирование итогового изображения, задание характеристик захватываемых объектов (отдельная программа, часть десктопа, фиксированные области экрана), внешнее оформление итоговой картинки, включая разнообразные характеристики теней и задание «источника подсветки» с указанием его направления. Если вы не собираетесь дополнительно дорабатывать спецэффекты в Adobe Photoshop и ему подобных, то данного инструмента будет более чем достаточно для получения необходимых иллюстраций.

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

Common Properties объединяет в себе заголовок и копирайты, настройку языка отображения документа, шрифты, поддержку генерации констант для последующего использования в программных проектах (С++, Delphi и так далее), пути к графическим иллюстрациям данного документа, настройку текстовых переменных (для использования в статьях в макроподстановках);

Style Sheets описывает все доступные в документы стили (шрифт, характеристики параграфа, горячие клавиши);

детальные настройки каждого из форматов для генерации (а это WinHelp, HTML Help, HTML Export, Adobe PDF, MS Word RTF, e-Book).

Кроме того, настройки самого Help&Manual вынесены в отдельный блок (Tools / Customize). Используя их, вы можете задавать внешний вид программы, генерацию части кода по умолчанию, пути по умолчанию для проектов и временных файлов, доступ к внешним компиляторам файлов помощи и многое другое.

В частности, разновидностью использования Help&Manual является Richtext HTML редактор

Richtext HTML редактор предлагает интерфейс, напоминающий MS WORD и встроенный в Web-страницу. Позволяет создавать Web-страницу в визуальном режиме и формирует ее HTML-код.

В дополнении к форматированию текста, редактор предлагает ряд дополнительных возможностей.

1. Копирование текста через буфер обмена из других программ. Вы можете вставить текст из других windows-приложений, например из MS Word, при этом формат текста будет сохранен. используйте команды копирования и вставки в меню «Правка» или Control+C - для копирования и Control+V - для вставки.

2. Вставка картинок . Если Вы хотите вставить картинку, находящуюся на web-сайте и доступную через URL, воспользуйтесь кнопкой «Вставить рисунок» («Insert Image»).

3. Вставка таблиц . Вы можете вставить таблицу в текст, используя кнопку «Вставить таблицу» («Insert Table»).

4. Вставка ссылки . Для того, чтобы создать web-ссылку наберите текст, выделите его, нажмите на кнопку «Вставить ссылку» («Insert Link») на панели инструментов и наберите URL-адрес ссылки.

5. Вставка «Смайликов» (Эмоции) . Для вставки маленьких иконок, выражающих эмоции, в текст, нажмите на иконку со «смайликом» на панели инструментов. Диалоговое окно позволит Вам выбрать нужную картинку (альтернативный способ рисования - написать текстовый эквивалент, который позднее автоматически заменится графическим аналогом).

улыбаюсь :-) смеюсь :-D подмигиваю ;-) в сметении :-/ озадаченный V-. показываю язык :-P крутой перец B-) одобряю ^-) глаза по полтиннику 8-) ошарашен 8-o	растроенный :-( стесняюсь 8-. краснею :-I целую :-X клоун :o) пират P-| злюсь 8-[ помираю xx-P сплю |-. чёрт }-]

гипертекст файл помощь

3. Пример создания файла помощи

Рассмотрим создание файлов помощи на примере. Первоначально приведём синтаксис таких файлов. В файлах подсказки могут содержаться следующие управляющие элементы.

Управляющий элемент	Описание
@Topic (в начале строки)	Начать определение темы Topic. Существуют 4 предопределенных темы: 1. Тема с именем Contents имеет специальное назначение. Она вызывается при нажатии клавиши F1 из командной строки FAR или при выборе пункта из списка помощи плагинов. 2. Если плагин "умеет настраиваться", то желательно в качестве имени темы помощи для диалога настройки указать Config. Эта тема будет также вызываться , когда пользователь нажмет клавишу F1 в меню конфигурации плагинов (Options|Plugins configuration) 3. Если плагин умеет работать и в панелях и в редакторе/программе просмотра, но при этом выполняет разные действия, то имеет смысл в HLF-файлах использовать две предопределенных темы: Editor и Viewer (для редактора и программы просмотра, соответственно). В этом случае Shift-F1 в списке плагинов в редакторе/программе просмотра покажет тему помощи Editor/Viewer.
$Text (в начале строки)	Определяет непрокручиваемую область помощи. Можно указывать несколько идущих подряд строк для не прокручиваемой области, но все эти строки должны идти сразу после определения темы (символа '@').
~Text~@Topic@	Ссылка на тему. Если вы желаете поставить ссылку на тему из основного файла помощи FAR, то перед именем темы поставьте символ ':'. Ссылка должна располагаться в одной строке.
~Text~@<FullPath>Topic@	Абсолютная или относительная ссылка на тему в файле помощи, находящемся в каталоге FullPath. Путь задается c заключительным слешем. Ссылка должна располагаться в одной строке. Например, плагин Foo располагается в каталоге 'D:\FAR\Plugins\Foo' и нам надо показать тему помощи 'FooInfo' из хелпа по этому плагину. ~Информации о плагине Foo~@<D:\FAR\Plugins\Foo\>FooInfo@
~Text~@<FullModuleName>Topic@	Абсолютная или относительная ссылка на тему в файле помощи, находящемся в том же каталоге, где находится плагин FullModuleName. Ссылка должна располагаться в одной строке. Например, для плагина Foo 'D:\FAR\Plugins\Foo\Foo.dll' необходимо показать тему помощи 'FooInfo' из хелпа по этому плагину. ~Информации о плагине Foo~@<D:\FAR\Plugins\Foo\Foo.dll>FooInfo@
~Text~@URL@	URL-активатор - запуск приложений, поддерживающих URL-протоколы. Под URL-приложениями понимаются такие приложения, которые поддерживают протоколы, подобные этим: ~доступ к файлам~@file://C:\Program Files\Far\License.xUSSR.txt@ ~передача файлов по FTP~@ftp://ftp.kgb.ru/WinUtil/Rar/@ ~HTTP~@http://plugring.farmanager.com/@ ~MailTo~@mailto:vskirdin@@mail.ru@ ~News~@news://fido7.far.support@ ~Telnet~@telnet://fido7.far.support@ Должно располагаться в одной строке.
#Text#	Выделенный текст Text.
^ (в начале строки или после $)	Центрирование строки.
@- (в начале строки)	Отключает автоформатирование текста. По умолчанию FAR форматирует все строки, которые в тексте начинаются с первой позиции. Должен находится в отдельной строке.
@+ (в начале строки)	Включает автоформатирование текста. Должен находится в отдельной строке.
<CtrlColorChar>XX	Задает цветовые атрибуты, которыми будет отрисован следующий за этой конструкцией текст. Цветовые атрибуты XX - две шестнадцатеричных цифры (0-9A-F). Например, в качестве управляющего кода <CtrlColorChar> был задан символ '\'. Тогда конструкция \4F заставит менеджер помощи рисовать следующий за приведенной конструкцией текст белыми буквами на темно-красном фоне. (см. CtrlColorChar)
<CtrlColorChar>-	Устанавливает цветовые атрибуты в предустановленный цвет. (см. CtrlColorChar)

Отметим следующее

1. Длина каждой строки в hlf-файле не должна превышать 300 символов.

2. Если Вам необходимо показать символы ~, # или @, то продублируйте их.

3. Для URL-активаторов в ссылке (поле <URL>) символы ~ и # могут дублироваться или не дублироваться, символ @ - - всегда дублируется. Если в ссылке должно присутствовать два идущих подряд символа ~ или #, то укажите последовательность из 3 или 4 символов (например, ~~~ или ~~~~ будет восприниматься как ~~)

4. Не используйте внутри ссылки (если ссылка не URL-активатор!) служебные символы (~, # и @).

Пример:

Данный пример взят из файла FarRus.hlf.

@FolderShortcuts

$ #Ссылки на папки#

Ссылки на папки позволяют обеспечить быстрый доступ к часто используемым папкам. Для создания ссылки на текущую папку нужно нажать Ctrl-Shift-<N>, где N - '0'..'9'. После этого, чтобы перейти в папку, записанную в ссылке, достаточно нажать ПравыйCtrl-<N>.

Пункт #Ссылки на папки# в ~Меню команд~@CmdMenu@ позволяет просматривать, устанавливать, редактировать и удалять ссылки на папки.

Это выглядит так:

Следующие примеры показывают оформление URL-активаторов.

Активизация E-mail клиента:

~vskirdin@@mail.ru~@mailto:vskirdin@@mail.ru@

Активизация браузера:

Активизация браузера:

~http://plugring.farmanager.com/~@plugring.farmanager.com/@

или

~http://www.uic.nnov.ru/~~ruiv/plugring/~@http://www.uic.nnov.ru/~ruiv/plugring/@

Следующие примеры показывают использование цветовых атрибутов:

.Language=Russian,Russian (Русский)

.PluginContents=Игра Реверси

.Options CtrlColorChar=\

...

@-

Реверси, также известная как Othello, является игрой

\70 B \-\2F W \- стратегией, в которую играют два игрока: Черный и

\2F W \-\70 B \- #Белый#. Игра происходит на поле 8х8 клеток с

применением 64-х двухцветных фишек.

@+

Оглавление файлов помощи (Help Files Contents)

Keyboard not found. Press F1 to continue...

Используйте HELP_FINDER, если "текущая закладка" не является закладкой 'Index' или 'Find'. HELP_FINDER открывает окно Help Topics, но не меняет закладку с оглавлением (Contents), если текущая закладка - 'Index' или 'Find'.

Попробуйте следующий код:

Function L1InvokeHelpMacro(const i_strMacro: String; const i_bForceFile:

Boolean): Boolean;

Begin

if i_bForceFile then

Application.HelpCommand(HELP_FORCEFILE, 0);

Result:=Application.HelpCommand(HELP_COMMAND,

Longint(PChar(i_strMacro))); //Приведение типа PChar здесь необязательно.

End;

Ищем ассоциированный файл помощи, открываем его (если не открыт) и переходим на закладку 'Index':

L1InvokeHelpMacro('Search()', True);

Ищем ассоциированный файл помощи, открываем его (если не открыт) и переходим на закладку 'Contents':

L1InvokeHelpMacro('Contents()', True);

Ищем ассоциированный файл помощи, открываем его (если не открыт) и переходим на закладку 'Find' (только для WinHelp 4):

L1InvokeHelpMacro('Find()', True);

Заключение

По итогам решения задач работы получены следующие результаты:

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

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

3.Файлы помощи в HTML создаются посредством использования Help&Manual. Это система для быстрого и наглядного создания файлов помощи и электронных документов - в первую очередь для Windows. При этом программа ориентирована на различные группы, начиная от обычных пользователей, волей судьбы вынужденных создавать электронные документы, и заканчивая профессиональными программистами, создающими файлы помощи для разрабатываемых продуктов. Help&Manual (последняя версия 3.25) помогает удобно и с минимальными затратами создать шаблон системы помощи для пользователя, после чего на его основе можно сгенерировать итоговый документ в следующих форматах: WinHelp 2 (MS Help 2); HTML Help; Classic Windows Help; HTML (classic help documentation); Adobe PDF; MS Word (RTF format); MMHelp.

Литература

1. Бройдо В.Л. Вычислительные системы, сети и телекоммуникации СПб, Питер 2002- 464 с.

2. Информатика /под редакцией С.В.Симоновича. СПб, Питер 2001- 400 с.

3. Кирмайер М. Информационные технологии. СПб.: Питер, 2003 - 443 с.

4. Мэтьюз Дж. Web - сервер. СПб.: Символ, 1998 - 356 с.

5. Олифер В. Г., Олифер Н.А. Компьютерные сети. СПб.: Питер, 2005 - 864 с.

6. Олифер В. Г., Олифер Н.А. Сетевые операционные системы. СПб.: Питер, 2003 - 539 с.

Размещено на Allbest.ru

...