生成JavaDoc文档

2021/9/15 12:05:09

本文主要是介绍生成JavaDoc文档,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

生成JavaDoc文档

方式一:使用命令行生成JavaDoc

  1. 在资源管理器中打开想要生成的JavaDoc文档的.java文件目录

  2. 在地址栏起始位置输入cmd,回车请添加图片描述

  3. 输入命令:javadoc -encoding UTF-8 -charset UTF-8 Doc.java,回车
    请添加图片描述
    -encoding UTF-8 表示你的源代码(含有符合 JavaDoc 标准的注释)是基于 UTF-8 编码的,以免处理过程中出现中文等非英语字符乱码

    -charset UTF-8 表示在处理并生成 JavaDoc 超文本时使用的字符集也是以 UTF-8 为编码,目前所有浏览器都支持 UTF-8,这样最具有通用性,支持中文非常好

  4. 之后就可以看到生成后的JavaDoc文档
    请添加图片描述

  5. 其中index.html即为生成的API文档,可在浏览器中打开
    请添加图片描述



方式二:使用IDEA生成JavaDoc:

  1. IDEA选择Tools->Generate JavaDoc请添加图片描述

  2. 选择生成JavaDoc
    请添加图片描述
    第一步:选择生成JavaDoc文档的范围,我只对一个源文件生成Doc,所以选择文件。
    第二步:输出目录最好新建一个文件夹,比较有条理和整洁
    第三步:区域设置,决定文档的语言,简体中文就是zh_CN、繁体(台湾)zh_tw、繁体(香港)zh-hk、英语(香港)en-hk、英语(美国)en-us、英语(英国)en-gb、英语(全球)en-ww
    第四步:其他命令行参数:如果区域设置为中国,参数一般为-encoding UTF-8 -charset UTF-8
    第五步:设置完成后点击确定即可生成Doc文档

  3. IDEA会自动打开生成的API文档
    请添加图片描述

  4. 查看JavaDoc文档
    打开输出目录,就可看到成功生成,打开 index.html 便能看生成的文档。
    请添加图片描述



这篇关于生成JavaDoc文档的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!


扫一扫关注最新编程教程