Автор: Алексей
Голубев
![]()
Сайт: http://www.frnet.narod.ru/
![]()
Некоторые преуменьшают важность роли комментариев
на web-страницах и в программах, однако комментарий – это наиполезнейшая вещь. К примеру: два года назад вы сделали сайт для какой-нибудь фирмы, и вот, фирма обращается к вам с просьбой о реконструкции
сайта. Причем структуру web-страницы нужно оставить той же, а нужно добавить форму с поиском в определенное место страницы или заменить какой-нибудь элемент. Два года – это не такой уж и маленький срок
для того, чтобы не успеть забыть весь код страницы, а комментарии освежат вашу память, и все встанет на свои места. Или другой пример, с программой в тысячу строчек, не разделенную на процедуры и функции.
Сложно-то с такой разобраться, не так ли? Возможно, может показаться, что это не сильно важная тема, но все же, советую дочитать статью до конца.
Как создаются комментарии?
Создание комментариев
в HTML, CSS и JavaScript, VBScript производится разными командами. Рассмотрим все по порядку.
HTML
Синтаксис таков:
<!-- Ваши комментарии -->
Есть еще один способ задания
комментариев в HTML, при помощи следующей конструкции:
<comment>Ваши комментарии </comment>
Эти комментарии больше применимы для программ, индексирующих сайты, типа Яndex’а.
Естественно ваши комментарии не будут отображаться в окне браузера.
CSS и JavaScript
В CSS и JavaScript имеется два вида комментариев. Первый вид – однострочные комментарии:
//
Ваши комментарии
Второй вид – много строчные комментарии:
/*
Данная таблица стилей отвечает за корректное
Отображение страницы на экране посетителя
*/
VBScript
Скажем
так, кто когда-нибудь программировал в школе (или не в школе…) на QBasic, тот сразу узнает родной комментарий. Два способа:
‘ Первый способ
Rem Второй способ
Как используются комментарии?
Вот
мы подошли к самому интересному месту статьи. Для чего должны использоваться комментарии в коде мы разобрались, а вот как их используют, еще нет. Продемонстрирую несколько примеров.
С Xakep.ru
Где-то
под конец страницы:
<!-- ...И мимо шли годы, а ламер все читал и читал исходник... -->
В самом конце страницы:
<!-- Ну и настырен же ты!... Все понял? Если нет - не отчаивайся;
многое людям понять не дано... -->
С Artlebedev.ru
В самом начале страницы:
<!-- meta name="GENERATOR" content="Microsoft FrontPage 1.0" -->
Где-то в середине страницы:
<!-- А как ты называешь то, на что сейчас смотришь? Сорс? Сорец? Исходник? Бнопня? Код? -->
В самом конце страницы:
<!-- А ты знаешь, сколько идиотов пишут мне письма, что наверху
написано про FrontPage? -->
С Tema.ru
Где-то в начале страницы:
<!-- Ну вот скажи - ну неужели так интересно читать код? Купи себе лучше книгу, что ли... -->
Где-то в конце
страницы:
<!-- Слушай, а давай я тебя HTML писать научу? Это мы только что открыли таблицу. Ширина у нее - пока не треснет браузер. Края не видны. А все остальное - по нулям. Понимаешь? Давай, теперь
сама -->
В самом конце страницы:
<!-- ...шли годы... а он все читал и читал исходник... -->
Да кстати, на главной странице сайта tema.ru есть комментарии поинтересней этих,
кто хочет посмотрите. Вот и все, что я хотел рассказать вам про комментарии. Просьба: если вы найдете в Интернете интересный комментарии присылайте мне на электронный адрес:
alexey-golubev@mail.ru.
Обсудить
в форуме...>>>>
