Как добавить/использовать комментирование в HTML, CSS, PHP, JS

Этот туториал покажет, как добавить/использовать комментирование в HTML, CSS, PHP, JS файлах.

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

Комментирование в HTML

Используется для временного комментирования элементов, которые могут быть восстановлены позже (при этом не удаляя их), добавления заметок внутри HTML, либо для отладки кода. Добавьте открывающий комментирующий тег: <!-- пере кодом и закрывающий тег --> после него.

Пример:

  <!-- {%FOOTER_LINK} -->
  </div> 
  </div>
  </footer>
  </body>
  </html>

Комментирование в CSS

Используется для легкого включения, отключения блоков CSS, а также для более простого понимая их. Такое комментирование начинается с /* и заканчивается */.

Пример:

  /* Global Structure---------------------------------------- */
  .main {
margin:0 auto;
width:940px;
position:relative;
/*
  h2 
font-size:26px;
line-height:28px;
}
*/ 

Комментирование в PHP

Есть два способа комментирования в PHP:

1. комментирование одной строки используется для отключения определенной строки кода PHP. Для этого Вам нужно добавить // или # перед кодом.

Пример:

//My comment goes here
#define('TABLE_HEADING_WRITABLE', 'Writable');

2. много-строчное комментирование используется для комментирования целого блока кода или нескольких строк кода. Вам необходимо добавить /* перед кодом и */ после.

Пример:

/*$Id$
osCommerce, Open Source E-Commerce Solutions
http://www.oscommerce.com
Copyright (c) 2010 osCommerce
Released under the GNU General Public License
  */

Комментирование в JavaScript

Есть два способа комментирования в CSS:

1. комментирование одной строки используется для отключения определенной строки кода PHP. Для этого Вам нужно добавить // или # перед кодом. Вся эта линия будет проигнорирована. Пример:

   //verify if value is in the array
     function in_array(value, array)
     {
   for (var i in array)
   if (array[i] == value)
   return true;
   return false;
   }

2. много-строчное комментирование используется для комментирования целого блока кода или нескольких строк кода. Вам необходимо добавить /* перед кодом и */ после.
   
   Пример:

/*function in_array(value, array){
for (var i in array)
	if (array[i] == value)
	return true;
        return false;}*/
</script>