Разработка сайтов, создание сайтов
главная / Web-дизайн / Немного о комментариях

Немного о комментариях

Некоторые преуменьшают важность роли комментариев на 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 писать научу? Это мы только что открыли таблицу. Ширина у нее - пока не треснет браузер. Края не видны. А все остальное - по нулям. Понимаешь? Давай, теперь сама -->

В самом конце страницы:
<!-- ...шли годы... а он все читал и читал исходник... -->

Источник: frnet.narod.ru
текущее:

НОВОСТИ

2011 г., «VisMech.ru»