2026/5/18 22:59:46
网站建设
项目流程
门户网站栏目建设,软件开发视频网站,常德做网站专业公司,吉安企业做网站maven-site-plugin 是 Maven 的一个核心插件#xff0c;用于生成项目文档网站。以下是详细介绍#xff1a;
主要功能 生成项目站点 集成各种项目报告#xff08;Javadoc、测试报告、检查报告等#xff09; 生成标准化的项目文档结构 支持多模块项目的聚合站点 报告集成…maven-site-plugin是 Maven 的一个核心插件用于生成项目文档网站。以下是详细介绍主要功能生成项目站点集成各种项目报告Javadoc、测试报告、检查报告等生成标准化的项目文档结构支持多模块项目的聚合站点报告集成Javadoc API 文档单元测试报告代码覆盖率报告配合 jacoco 等静态代码分析报告Checkstyle、PMD、FindBugs项目信息依赖、许可证、团队等常用 GoalsGoal说明site:site生成项目站点HTML 文件输出到target/site/site:stage将站点暂存到本地目录用于多模块项目预览site:deploy将生成的站点部署到配置的服务器需配置distributionManagementsite:run启动一个本地 HTTP 服务器预览站点已弃用建议用mvn site 本地打开index.html注意从Maven Site Plugin 3.0开始site:run已被移除。基本配置在 pom.xml 中配置project !-- 配置站点信息 -- nameMy Project/name description项目描述/description urlhttps://example.com/url build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-site-plugin/artifactId version3.12.1/version !-- 使用最新版本 -- /plugin /plugins /build !-- 配置报告插件 -- reporting plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-javadoc-plugin/artifactId version3.5.0/version /plugin plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-surefire-report-plugin/artifactId version3.0.0/version /plugin /plugins /reporting /project一键生成站点mvn clean site执行完后静态站点位于target/site/用浏览器打开target/site/index.html即可查看。常见增强项中文站点 / UTF-8在properties里加project.build.sourceEncodingUTF-8/project.build.sourceEncoding project.reporting.outputEncodingUTF-8/project.reporting.outputEncoding在插件configuration里加localeszh_CN/locales自定义输出目录configuration outputDirectory${project.build.directory}/my-site/outputDirectory /configuration本地启服务实时预览mvn site:run会自动启动 Jetty打开 http://localhost:8080 即可边改边看。多模块项目先生成整体站点再一次性发布mvn site site:stagesite:stage会把所有模块的页面聚合到target/staging/目录方便一次性拷贝到 nginx、Apache 或通过site:deploy上传到远程服务器。与 AsciiDoc 集成可选如果想用.adoc写文档把文件放到src/site/asciidoc/然后在插件里增加依赖即可plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-site-plugin/artifactId version3.12.1/version dependencies dependency groupIdorg.asciidoctor/groupId artifactIdasciidoctor-maven-plugin/artifactId version2.2.1/version /dependency /dependencies /plugin运行mvn site后会自动把.adoc渲染成.html并嵌入站点导航。