飞牛士 飞牛士
  • 首页
  • 杂谈
  • 摘记
  • 代码
  • 资源
  • 注册
    登录
现在登录。
  • 首页
  • 杂谈
  • 摘记
  • 代码
  • 资源
  • 网友来稿
  • 其他
    • 留言
    • 投稿
    • 邻居
首页 代码 WordPress建站主题实践:代码注释

WordPress建站主题实践:代码注释

飞牛 3月 18, 2021

WordPress建站主题实践:代码注释-飞牛士

wordpress主题主要包含HTML、CSS、php、JavaScript四种代码。今天飞牛在修改wordpresss主题的时候就遇到问题,不想让某一段代码输出,但是又不想删除,方便后悔了可以继续使用,这时候就需要用到注释。网上搜索并实践,将知识记录下来。

HTML注释

注意:html 注释标签和其它语言的注释不一样。比如:JavaScript、php等语言都有单行注释和多行注释,但是 html 注释标签只有一个,单行和多行都是使用同一个标签来注释。

<!-- 这里是注释的内容 -->
<!-- 此刻不显示图片:
<img border="0" src="/i/tulip_ballade.jpg" alt="Tulip">
-->

注意: 注释中可以直接使用回车换行。

并且我们习惯用注释的标签把HTML代码包裹起来。如:

<!-- xx部分 开始 -->
    这里放你xx部分的HTML代码
<!-- xx部分 结束 -->

 

HTML注释的注意事项:

  1. HTML注释不支持嵌套。
  2. HTML注释不能写在HTML标签中

建议:注释的内容两边留个空格
[c-alert type="warning"]提示:单行注释中使用最广泛是使用双斜杠“//”来定义注释。[/c-alert]

不推荐以下这种不留空格:

<!--This section is non-normative-->

 

多行注释:范例来源于wordpress 2020主题:

/**
 * The main template file
 *
 * This is the most generic template file in a WordPress theme
 * and one of the two required files for a theme (the other being style.css).
 * It is used to display a page when nothing more specific matches a query.
 * E.g., it puts together the home page when no home.php file exists.
 *
 * @link https://developer.wordpress.org/themes/basics/template-hierarchy/
 *
 * @package WordPress
 * @subpackage Twenty_Twenty
 * @since 1.0.0
 */

PHP、JS、CSS

单行注释

单行注释有两种方式,分别是使用“#”和反斜杠“//”。

// 这是单行注释
# 这也是单行注释

[c-alert type="warning"]提示:单行注释中使用最广泛是使用双斜杠“//”来定义注释。[/c-alert]

多行注释块

/*
  这是多行注释块
  它横跨了
  多行
*/

[c-alert type="warning"]提示:多行注释不能相互嵌套使用。[/c-alert]

当然,这种方式也可以作为单行注释使用

/* echo "PHP 注释"; */
#wordpress#wordpress主题
0
飞牛
一个互联网资深菜鸟
评论 (18)
返回
  • 林羽凡

    你首页这样的布局排版就好多了,进来首页一眼就能看出来,哪些是最近更新的。下面回复@好扎眼,哈哈哈哈

    1年 前 回复
    • 飞牛

      @林羽凡 嗯,目前感觉还不错的,就怕过段时间又换了个心水又换主题哈哈。
      @这个提示比较明显,我觉得还行。

      1年 前 回复
    • 林羽凡

      @飞牛 最新提交的评论不是应该排到最前面的么

      1年 前 回复
    • 飞牛

      @林羽凡 嗯,改过来了,一开始是想着最早留言就应该排前面。[f=tiaopi]

      1年 前 回复
    • 林羽凡

      @飞牛 你速度真快,哈哈哈哈,不过邮件的表情没解析。[f=tiaopi] f=tiaopi

      1年 前 回复
    • 飞牛

      @林羽凡 个人比较追求效率,不马上去做的话事情越拖拖多,越多越拖。

      1年 前 回复
    • 林羽凡

      @飞牛 越拖越不想做,积着多了,自己看到要做的事,就心累。

      1年 前 回复
  • 孤斗-伍子蛇

    小tip:其实主流的编辑器,不管任何语言,“command(ctrl) + / ”就可以注释,它会选择正确的方式进行注释,就和 ctrl + s是保存一样通用

    1年 前 回复
    • 飞牛

      @孤斗-伍子蛇 这个真没注意过,可能我很少用编辑器改代码的原因。我都是直接后台改或者直接文本打开修改。这个习惯要不得。[f=xiaoku]

      1年 前 回复
    • Fong

      @孤斗-伍子蛇 哈哈哈哈,确实如此。

      竟然能在这碰到你。

      8月 前 回复
    • 孤斗-伍子蛇

      @Fong 最近太忙了,博客N久没写了?

      8月 前 回复
  • 王麻子

    资深的一定不是菜鸟,资深菜鸟那一定是自谦的。PS:简约的主题能给你带来沉浸式的阅读体验,但是,不百花看过,又焉知此味[f=touxiao]

    1年 前 回复
    • 飞牛

      @王麻子 翻不起浪花所以自诩菜鸟,而飞牛就是吹了十几年风却也没有任何浪花所以自评资深菜鸟。
      博客程序接触不多,特别是wordpress,早些年接触了一阵子,没有深入,所以博客的装维算是一次学习经历。风格随着心情而变,百花皆尝,择适而优,潮有起落,变化万千。

      1年 前 回复
  • 夏目贵志

    换主题啦?

    1年 前 回复
    • 飞牛

      @夏目贵志 是啊,换了前几天推荐的免费主题,原来的主题太花了,试试这个。[f=shengli]

      1年 前 回复
    • 夏目贵志

      @飞牛 这个 就是 简约,方便看最新的文章 哈哈

      我好像没收到回复通知?是不是还没设置?

      1年 前 回复
    • 飞牛

      @夏目贵志 嗯,是够简约的,不过还是有些不足。
      邮件通知之前没设置,不知道现在设置了没问题了吧?

      1年 前 回复
    • 夏目贵志

      @飞牛 邮件收到,正常over!~

      1年 前 回复
飞牛
一个互联网资深菜鸟
76
文章
245
评论
28
获赞
随机推荐
笔趣阁v8.0.20200119 安卓版无广告可换源
3月 10, 2021
WordPress 上传文件按时间重命名
3月 20, 2021
不忘初心方得始终-博客为谁而写
2月 17, 2021
不用root,一键消除app开屏广告
1月 29, 2021
一年前“逃离武汉”的英国人,他后悔了
2月 4, 2021
  • 关于飞牛
  • 给我留言
  • 友情链接
Copyright © 2006-2022 飞牛士.