javadoc.yml

name: Maven Site

on:
  push:
    branches: [ main ]
    paths:
      - '.github/workflows/javadoc.yml'
      - 'jsgenerator-core/**'
      - 'pom.xml'

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
      - name: Set up JDK 21
        uses: actions/setup-java@v4
        with:
          distribution: 'temurin'
          java-version: '21'
          # Given the fact that this is a multimodule project, build process will take long time so we activate caching
          # To know more: https://maven.apache.org/extensions/maven-build-cache-extension/cache.html
          cache: 'maven'
      - name: Build Javadoc Site with Maven
        #To see the full stack trace of the errors, re-run Maven with the -e switch.
        #Re-run Maven using the -X switch to enable full debug logging.
        # -B,--batch-mode Run in non-interactive (batch) mode (disables output color)
        # To learn more about options: https://maven.apache.org/ref/3.6.3/maven-embedder/cli.html
        run: |
          mvn clean site -B -e -X --projects 'jsgenerator-core'
        env:
          MAVEN_SITE_GITHUB_OAUTH_TOKEN: ${{ secrets.MAVEN_SITE_GITHUB_OAUTH_TOKEN }}