возможно заказать разработку или сопровождение, услуги вашего сайта/блога


обновлено: 2021-10-04 в теме: Бардачок html php css
Запросто с WordPress создание и продвижение сайтов ATs media

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

…сегодня мы в этой коротенькой, но полезной статье, разберемся, как же комментируется различный программный код. Много говорить не стану, ибо если вас подобное заинтересовало, то вы уже столкнулись с вопросами этой задачи, и представление о ней имеете.

 

Также о представлении можно прочесть предыдущую статью Оформление внешних и внутренних ссылок визуальными иконками CSS

 

(в финале статьи подробное видео о правилах и способах комментирования кодов)

 


 

 

 

 

 

Вы зашли по адресу… но несколько слов для ясности и пользы дела. Наверняка видели, как это делается с CSS-кодом, так как сss представляет наибольший интерес у многих начинающих, как и я.

 

 

… Хорошо!

 

Но обратите внимание, что комментарии используются также и в html и php… А ведь большинство начинающих путаются на начальном этапе своей работе с сайтом и не знают, как дописать себе необходимые пояснения. Ведь бывает же так, например, вам потребуется на какое-то время деактивировать код html, а потом снова возобновить его функцию – это запросто реализовать, если вы сделали себе пометки на “полях”, да мало ли что.

 

 

Но что следует помнить о “комментариях” вообще – тут всё в строгой зависимости от того, с каким файлом вы работаете конкретно, а следовательно и код применения различен.

 

 

 

ошибки в комментариях к коду – по версиям php

 

 

 

php 8

 

 

важно!

время от времени языки программирования меняются (их версии), а следовательно относитесь внимательнее к тому, что и как комментируете!

 

 

Как известно, не так давно вышла версия php 8 – некоторые пользователи столкнулись с проблемами!

 

В данной статье коснемся, скажем так, синтаксиса – правописания))…

 

 

Например, если комментируете в самом финале кода, то обязательно соответственно закрывайте комментарий! иначе, в новейших версиях php (подобные правила касаются многих ЯПов) бесконечно закомментированный блок вызовет ошибки! Белый экран.

 

 

 

закомментировать код

 

 

 

 

 

…далее: никогда не ЛЕПИТЕ друг к дружке символы комментариев к тегам кода!!!! неряшество в коде, как и в жизни, вызывает неприличные ошибки.

 

 

На мой взгляд, лучше потратить несколько лишних минут времени, но написать чистенький и аккуратный код и комментарии. Это в будущем сэкономит массу времени!

 

 

неправильно:

 

<?php/*коммент*/?>

 

 

правильно:

 

<?php /*коммент*/ ?>

 

 

 

 

…продолжаем о правилах комментирования кода…

 

 

Итак:

 

 

 

Комментируем код CSS

 

 

 

a:hover, a:focus {
color: #D5071E;
text-decoration: Overline; /*ПОДЧЁРКИВАНИЕ ВВЕРХУ*/
}

 

 

 

Таким образом вы делаете себе пояснение. Или можно вообще закомментировать этот скрипт css так: просто оберните

 

/* здесь КОД */

 

 

 

/*a:hover, a:focus {
color: #D5071E;
text-decoration: underline; /*ПОДЧЁРКИВАНИЕ ВНИЗУ*/
}*/

 

 

Обращаю ваше внимание на то, что – закомментировать полный цикл кода css таким способом можно, но !! тогда придётся убрать повторные комментарии /*ПОДЧЁРКИВАНИЕ ВНИЗУ*/, или поиграть слэшами, если пояснение важно ))

 

Иначе будет ошибка!!

 

 

 

Ко сведению:

 

Если открыть исходный код страницы – Ctrl+U и взглянуть… то увидим, что закомментированный кусок кода css замечательно отображается в сгенерированном документе! это если css использовалось (задавались свойства) прямо в html

 

И, как понимаете, если перейти из исходного кода по ссылке в документ css вашего активного шаблона – все комментарии можно наблюдать и изучать)) если кому-то потрэбу. Но это вряд ли)

Английское наречие (слова) будут читаемы. Русская символика – нет.

 

 

 

 

Комментируем код HTML

 

 

 

<!-- <div class="redblock"><p>This is some HTML in
the redblock class.</p></div> -->

 

 

 

Аналогично комментируется и файл XML

 

 

 

<!-- закрытый код ...код -->

 

 

 

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

 

Обычная невнимательность при форматировании может стоить времени, например, показанный выше ЗАКОММЕНТИРОВАННЫЙ код частенько бывает ошибочен: заместо двух коротких дефисов вырисовывается длинное тире:

 

 

<!— закрытый код ...код —>

 

 

 

К сведению же:

 

как говорилось в предыдущей ремарке – так же и закомментный… код html отображается в сгенерированном документе!

Имейте в виду это.

 

 

 

 

И вот ещё что:

помимо того, что комментированный код отображается в исходном коде страницы (а значит и отрабатывается в каком-то смысле, хотя и на страничке будет невидим!) – какие-то функции php связкой с html лучше выносить из активного документа.

 

Например:

 

 

<!--<br /><div class="postmeta"><?php echo category_description(); ?></div>-->

 

 

будет виден в документе и функция <?php echo category_description(); ?> замечательно отработает своё дело: т.е во фронтенде информации станет не видать, но вот в исходнике – она чётко отобразится! и это беспонтовый запрос к БД: всё это мелочь, но знать надобно!

 

 

Возможно поступить так, если выносить кусок кода из документа не хочется:

 

добавьте перед необходимым “лишним” html кодом открывающий <?php и ?>… встроенная функция… и закрывающий ?>

 

 

Словом, вот так можно поступить, если код большой:

 

 

<?php /** ?><br /><div class="postmesy"><?php echo category_description(); ?></div> **/ ?>

 

 

тогда исходник будет чистеньким!

 

 

Или попроще:

 

 

<?php /** echo category_description(); **/?>

 

 

Закомментируем саму функцию в документе html. Исходник в этих случаях относительно отработок функций будет чистеньким!

 

 

 

как закомментировать JavaScript

 

 

 

 

if (beingShown || shown) {
// don't trigger the animation again
return;
} else {
// в строке применяем ЛЮБОЙ КОММЕНТАРИЙ
// в строке применяем ЛЮБОЙ КОММЕНТАРИЙ
// true;

 

 

 

Этот пример-код JavaScript, — я, для наглядности, ухватил в нете, слегка поправив пунктуацию. Это неважно… Главное понять принцип…

 

Как вы понимаете слеш «//» двойной, это и есть ЗНАК комментария… ОДНОСТРОЧНЫЙ !

 

 

А в остальном код JS комментируется подобно php, об этом ниже:

 

 

ремарка:

 

если кто-то перейдёт по ссылке в исходном коде шаблона “в документ” js, всякие личные комментарии будут видны в соответствии с кодировкой (транслитерация описана выше)

 

 

 

 

Комментируем код PHP

 

 

 

<?php

else :
// get_template_part('post', 'noresults');
endif;

 

 

 

…и …здесь аналогично – слеш-слеш… однострочный.

 

Но обратите внимание, что его можно комментировать так, как и код-CSS.

 

 

…либо так можно закомментировать – однострочный вариант, когда используем НЕ ДВА СЛЕШ, но БЕКАР (решётка) перед комментируемой строкой:

 

<?php

else :
# get_template_part('post', 'noresults');
endif;

 

 

…Естественно, комментировать нужно осторожно в цикле кода!

 

 

…либо же таким образом – аналогично показанному выше примеру для CSS… т.е. этот /* код */ вариант комментирования подойдёт и для CSS и для JS кодов !

 

 

<?php

else :
/* get_template_part('post', 'noresults'); */
endif;

 

 

комментируем код js php css

 

 

А вот таким образом можно закомментировать более объёмное пояснение к коду PHP, где-то меж его основными примерами…

 

 

<?php
/**
* The default post formatting from the post.php template file will be used.
* If you want to customize the post formatting for your homepage:
*
* - Create a new file: post-homepage.php
* - Copy/Paste the content of post.php to post-homepage.php
* - Edit and customize the post-homepage.php file for your needs.
*
* Learn more about the get_template_part() function: http://codex.wordpress.org/Function_Reference/get_template_part
*/

 

 

 

 

Ещё в циклах php можно комментровать и так, коли код смешанный… php и как-то html

 

Аналогично описанному выше:

 

К примеру какая-то такая функция…   где-то в общем коде (или цикл в html): <?php mihalica_add_viva(); ?> – можно закомментировать, т.е добавить свою метку так:

 

 

<?php /** или тут **/ mihalica_add_viva(); /** или так: здесь можно поместить целый цикл какой-то функции - она будет неактивна! **/ ?>

 

 

 

или так: однострочный вариант…

 

 

<?php

// mihalica_add_viva(); - однострочный (до переноса строки)

/** или так: здесь можно помести целый цикл какой-то добавочной функции -

*...она будет неактивна! **/

?>

 

 

 

Сведения:

 

php код не виден ни в каких исходных кодах!! виден только его функциональный результат – отработка!

 

 

 

 

Вот в общем и всё что хотелось нынче доложить!

 

Теперь можете поэкспериментировать… Удачи.

 

 


...и конечно же, читайте статьи сайта и подписывайтесь:
Делюсь горьким опытом - кое-какими знаниями, для вашего сладкого благополучия))


...город веб мастеров Михалика.ru © - запросто с WordPress - ATs media squad

 

 


подписка feedburner Online консультация по настройкам и созданию сайтов на WordPress

 

 

 

Подробная видеоинструкция:

 

 

 

 

Видео: как правильно закомментировать на время код HTML, CSS или PHP, JS

 

 

 

 


...вопросы в комментариях - помогу, в чём дюжу...
mihalica.ru !


Михаил ATs - владелец блога запросто с Вордпресс - в сети нтернет давным-давно...

...веб разработчик студии ATs media: помогу в создании, раскрутке, развитии и целенаправленном сопровождении твоего ресурса в сети... - заказы, вопросы... разработка...





Нажатия на кнопочки определяют Ваше высокое гражданское сознание

Поделитесь соображениями: Ваши мысли очень важны!

Внимание! Обязательные поля помечены *

  отныне доступен плагин: ats privacy policy ©


  1. Спасибо большое. Для таблицы css стилей мне очень пригодилось : ) Если нетрудно посмотрите правильно ли я оформил комментарии на своём сайте. Так то, визуально, выглядит всё нормально, вроде. Вот пример с куском кода:

    /* Код увеличивает ВСЕ изображения на сайте при наведении курсора */ 
    img:hover {
     opacity: 1;
     /* Скорость увеличения */
     -webkit-transition-duration: 0.7s;
     -moz-transition-duration: 0.7s; 
     -o-transition-duration: 0.7s;
     /* Степень увеличения */
     -webkit-transform:scale(1.2); 
     -moz-transform:scale(1.2); 
     -o-transform:scale(1.2); 
     z-index: 0;
    }
    /* Код увеличивает ВСЕ изображения на сайте при наведении курсора */
    Ответить - Игорь

    • Здравствуйте Игорь!!
      Да, Вы всё верно сделали.
      Разве что логичнее внутренние комментарии переместить в одну строку:

      /* Код увеличивает ВСЕ изображения на сайте при наведении курсора */ 
      img:hover {
      opacity: 1;
      -webkit-transition-duration: 0.7s;/* Скорость увеличения */
      -moz-transition-duration: 0.7s;

      …и т.д – этак полезнее в планах скоростей загрузок скриптов (и сайта)… Да и оптимизаторы CSS имеют свои нюансы сокращения/сохранения кода.
      Если станете последовательно верстать (без помарок) – в один прекрасный момент будет всё легко поправить…
      А этот момент придёт: тогда Вам эти пометки станут уже и не нужны!
      Так пришла опытность))
      Спрашивайте, коли что будет не ясно по сайту!

      Ответить - Михаил

  2. Очень полезная информация, спасибо

    Ответить - irmaseo

    • На здоровье продвижению))

      Ответить - Михаил

  3. Спасибо за статью и видюху – оказалось кстати и полезно!
    Удачи вам!

    Ответить - Алексей