averbraeck / opentrafficsim

Open Source Multi-Level Traffic Simulator
BSD 3-Clause "New" or "Revised" License
28 stars 8 forks source link

Site generation has to be updated due to plugin updates #111

Closed averbraeck closed 4 months ago

averbraeck commented 4 months ago

The maven-site plugin has been updated from version 3 to version 4. This needs some changes.

averbraeck commented 4 months ago

For one, it needs an explicit skin. The site.xml files have been updated with:

  <skin>
    <groupId>org.apache.maven.skins</groupId>
    <artifactId>maven-fluido-skin</artifactId>
    <version>1.11.1</version>
  </skin>
averbraeck commented 4 months ago

The site.xml files still referred to the project ots-xsd. This has been removed.

averbraeck commented 4 months ago

The ots-editor project has been added to the site.xml file as one of the menu items in the MODULES menu.

averbraeck commented 4 months ago

The banners need to be updated. artifactId needs to be preceded by project., and the project name has to be explicitly mentioned as the left banner:

  <bannerLeft>
    <name>${project.name}</name>
  </bannerLeft>

  <bannerRight>
    <name>${project.artifactId} ${project.version}</name>
  </bannerRight>
averbraeck commented 4 months ago

The Maven fluido skin has been updated to: 2.0.0-M8.

averbraeck commented 4 months ago

The project tag in site.xml now starts with:

<project name="${project.artifactId} ${project.version}"
averbraeck commented 4 months ago

Eclipse had quite some trouble running the site generation with the EMBEDDED maven compiler, and failed with errors. This is a known issue. Installing a local Maven compiler (3.9.6) and setting it as default solves the problem. This will most probably not play a role when generating documentation with github actions and on the Delft server, since these use an explicit Maven compiler and not an embedded one.

averbraeck commented 4 months ago

Site generation outside of Eclipse works fine. The site is not yet visible at opentrafficsim.org, but that is a separate issue.