如何在Javadoc中屏蔽img标签或指定行?重复显示问题求助
解决Javadoc中类注释图片重复显示的问题
嘿,这问题很好解决!你现在的Javadoc里放了两张指向同一张图的标签,所以鼠标悬停类的时候会重复显示。要屏蔽其中一张,有两种简单的方式:
方法1:用HTML注释隐藏不需要的图片标签
Javadoc支持HTML注释语法<!-- -->,把你想屏蔽的那行<img>标签包在里面就行,这样Javadoc解析的时候会直接忽略这部分内容,不会渲染出来。
修改后的代码如下:
package com.java.escapesequence; /** * * @author udaykiranp * * </br> * <!-- <img src="../../../../resources/images/java-basic-ASCII Table.png" /> --> * * <img src="{@docRoot}/../resources/images/java-basic-ASCII Table.png" /> */ public class CharSequence { public static void main(String[] args) { System.out.println((char) 33); System.out.println((char)0x2B);//hexa decimal start with 0x System.out.println((char)056);//octa decimal start with 0 } }
方法2:直接删除不需要的图片标签
如果你确认{@docRoot}的路径写法是正确的(这种写法更通用,不会因为包结构层级变化导致图片找不到),直接删掉另一行相对路径的<img>标签就好,这样注释里只剩一张图,自然不会重复显示。
修改后的代码示例:
package com.java.escapesequence; /** * * @author udaykiranp * * </br> * <img src="{@docRoot}/../resources/images/java-basic-ASCII Table.png" /> */ public class CharSequence { public static void main(String[] args) { System.out.println((char) 33); System.out.println((char)0x2B);//hexa decimal start with 0x System.out.println((char)056);//octa decimal start with 0 } }
另外提一句,{@docRoot}是Javadoc的内置变量,指向生成的文档的根目录,用它来引用资源比硬编码相对路径更可靠,推荐保留这一行~
内容的提问来源于stack exchange,提问作者UdayKiran Pulipati
相关产品推荐
相关产品推荐

