javadocs.yml

name: Publish javadocs

on:
  push:
    branches: [ development, experimental ]

jobs:
  build:

    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4

    - name: Set up JDK 17
      uses: actions/setup-java@v4
      with:
        java-version: 17
        java-package: jdk
        distribution: 'temurin'

    - name: Set up Python 3.9
      uses: actions/setup-python@v5
      with:
        python-version: 3.9

    - name: Install GH import
      run: |
        python -m pip install --upgrade pip
        pip install ghp-import

    - name: Checkout NeuroML2
      uses: actions/checkout@v4
      with:
        repository: NeuroML/NeuroML2
        ref: ${{ github.ref }}
        path: NeuroML2

    - name: Checkout org.neuroml.model.injectingplugin
      uses: actions/checkout@v4
      with:
        repository: NeuroML/org.neuroml.model.injectingplugin
        ref: ${{ github.ref }}
        path: org.neuroml.model.injectingplugin

    - name: Install NeuroML deps
      run: |
        pushd NeuroML2
        mvn install
        popd
        pushd org.neuroml.model.injectingplugin
        mvn install
        popd

    - name: Generate javadocs
      run: |
        mvn javadoc:javadoc

    - name: Publish documentation on GH pages
      run: |
        ghp-import -f -m "Regenerate documentation" -b gh-pages -n -p target/site/apidocs