如何注释HTML与PHP混合的代码?(附各种编程语言的注释写法)

从我开始学习搭建网站的第一天开始,我就发现:
有些代码真的不能直接删除!

不然终究会惹事。

somanybugs

而且bug还是你自己zuō出来的。

hopeless

即便是复制到另一个地方保管也不好,麻烦又混乱。

所以说,注释是一种好方法。

Just like this:

<!DOCTYPE html>
<html>
    <head>
        <meta charest="utf-8" />
        <!--<title>ThrRip</title>-->    <!--(左边那里和这里都是被注释的代码)-->
        <title>Test by ThrRip</title>
    </head>
    <body>
    </body>
    </html>

当然,这只针对于HTML。


正文开始!

刚才在修改一部分Typecho的.php文件的时候,发现 <!-- --> 只能注释掉HTML代码,查了一下,PHP代码得用 来注释。

但是那些.php文件是HTML和PHP混合的啊!

So,ThrRip想出了一个好(馊)主意。这个是Typecho源码文件夹下的/usr/themes/default/page.php文件:

<?php if (!defined('__TYPECHO_ROOT_DIR__')) exit; ?>
<?php $this->need('header.php'); ?>

<div class="col-mb-12 col-8" id="main" role="main">
    <article class="post" itemscope itemtype="http://schema.org/BlogPosting">
        <h1 class="post-title" itemprop="name headline"><a itemprop="url" href="<?php $this->permalink() ?>"><?php $this->title() ?></a></h1>
        <div class="post-content" itemprop="articleBody">
            <?php $this->content(); ?>
        </div>
    </article>
    <?php $this->need('comments.php'); ?>
</div><!-- end #main-->

<?php $this->need('sidebar.php'); ?>
<?php $this->need('footer.php'); ?>

假如我不太想要(又不太确定)含有 <h1> 元素的那一行,即不想要在每篇文章的页面上显示标题,如下图:

dontwanttitleineachpage

那就可以这样修改:

<?php if (!defined('__TYPECHO_ROOT_DIR__')) exit; ?>
<?php $this->need('header.php'); ?>

<div class="col-mb-12 col-8" id="main" role="main">
    <article class="post" itemscope itemtype="http://schema.org/BlogPosting">
        <?php/*<h1 class="post-title" itemprop="name headline"><a itemprop="url" href="<?php $this->permalink() ?>"><?php $this->title() ?></a></h1>*/?>
        <div class="post-content" itemprop="articleBody">
            <?php $this->content(); ?>
        </div>
    </article>
    <?php $this->need('comments.php'); ?>
</div><!-- end #main-->

<?php $this->need('sidebar.php'); ?>
<?php $this->need('footer.php'); ?>

看出来差异在哪里了吗?

OK,这就是解决办法。


各种编程语言的注释写法 - 总喜欢一人做事的开发者赶紧收藏!

编程语言注释写法
C/C++/C#行注释: //注释内容 ;块注释:
Java行注释: //注释内容 ;块注释:
HTML块注释: <!--注释内容-->
CSS块注释:
JavaScript行注释: //注释内容 ;块注释:
PHP行注释: #注释内容 ;行注释: //注释内容 ;块注释:
XML块注释: <!--注释内容-->
JSON行注释: //注释内容 ;块注释: (不建议在JSON中加入注释)
Python行注释: #注释内容 ;块注释: '''注释内容'''
SQL Server/Oracle PLSQL行注释: --注释内容 ;块注释:
MySQL行注释: --注释内容 ;行注释: #注释内容 ;块注释:
Visual Basic行注释: `注释内容
汇编语言行注释: ;注释内容
Perl行注释: #注释内容 ;块注释: =pod 注释内容 =cut
MATLAB行注释: %注释内容% ;块注释: %%注释内容%% ;块注释: %{注释内容%}
R语言行注释: #注释内容 ;块注释: if(false){注释内容}

不难发现,其实编程语言的注释写法都大同小异。

源于对音乐和科技的热爱

可能感兴趣的文章

留言