Javadoc生成文档

 1 package com.lin.base;
 2 
 3 /**
 4  * @author Lin
 5  * @version 1.0
 6  * @since 11
 7  */
 8 public class Doc {
 9     String name;
10 
11     /**
12      *
13      * @param name
14      * @return
15      * @throws Exception
16      */
17     public String test(String name)throws Exception{
18         return name;
19 
20         //我是通过命令行 javadoc 参数 Java文件
21         //javadoc -encoding UTF-8 -charset UTF-8 Doc.java 限定中文编译
22         //学会查找使用IDEA生产Javadoc文档!   面向百度编程!
23 
24         //基础部分的一切知识,后面几乎每天都会用
25     }
26 }

 使用DOS命令生成Javadoc文档

 

 

idea 生成javadoc文件(并解决Error running ‘Javadoc’: Cannot generate JavaDoc - JDK path is not specified or invalid)

首先,如果想要生成某个类的doc文件时,只需鼠标单击选中该类即可,如图所示

在这里插入图片描述

选中之后在上方导航栏找到Tools,如图所示,点击红框中的选项

在这里插入图片描述

打开之后如图所示

在这里插入图片描述

这里解释一下,第一个红框中,就是你选中的类的路径。第二个红框是生成javadoc文件的存放路径,可以自己选择。第三个红框就是选择地区,这个决定了文档语言,中文就是zh_CN。第四个红框就是传入javadoc的参数,一般这样写:-encoding UTF-8 -charset UTF-8 -windowtitle “文档HTML页面标签的标题” -link http://docs.Oracle.com/javase/7/docs/api。

可以看到控制台输出

在这里插入图片描述

这里的警告不影响doc文件的生成

ps:如果想要生成整个项目的doc文件,只需要像第一步一样,将类换为项目即可,其他步骤不变。如果遇到Error running ‘Javadoc’: Cannot generate JavaDoc - JDK path is not specified or invalid,就按照下面的解决办法即可。

在这里插入图片描述

在这里插入图片描述

点击ok之后上面说的问题就解决了

 

posted @ 2021-02-05 21:49  奔啵儿灞  阅读(100)  评论(0)    收藏  举报