maven-site-plugin M9+出现Site model旧版警告，求相关解答

什么是Site model #

Site model是Maven Site插件定义的站点配置元数据规范，用来统一站点的结构、皮肤配置、文档组织等规则。2.0.0版本是该规范的重大更新，旧版指的是遵循2.0.0之前schema的配置格式。

M8到M9版本的关键变化 #

maven-site-plugin 4.0.0-M9开始启用了对插件站点配置的严格校验，强制要求插件的站点描述符合2.0.0版本的Site model规范。而M8版本还未开启这一严格校验，所以不会触发警告。

具体解决步骤 #

• 更新插件自身的site.xml配置：打开你的latex-maven-plugin项目中的src/site/site.xml，将顶部的schema声明更新为2.0.0版本。例如，把原来的：

  <project xmlns="http://maven.apache.org/DECORATION/1.7.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/DECORATION/1.7.0 http://maven.apache.org/xsd/decoration-1.7.0.xsd">
  

  修改为：

  <project xmlns="http://maven.apache.org/DECORATION/2.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/DECORATION/2.0.0 http://maven.apache.org/xsd/decoration-2.0.0.xsd">
  

• 同步升级依赖版本：
  • 将doxia-module-markdown升级到与maven-site-plugin匹配的版本（比如4.0.0-M11对应doxia-module-markdown 2.0.0-M11）
  • 将maven-fluido-skin升级到2.0.0-M11版本，确保皮肤兼容新版Site model
• 检查插件的站点文档结构：确认插件项目中src/site下的文档（markdown、html等）的组织方式符合新版规范，比如目录结构、文档命名的要求

验证修改 #

完成上述调整后，在插件项目中执行mvn clean site命令，检查是否还会出现旧版Site model的警告。如果警告仍存在，排查插件项目中是否有其他与站点相关的配置文件（如plugin.xml中的站点信息）未同步更新。

内容的提问来源于stack exchange，提问作者user2609605