build: new github action for publishing docs

.github/workflows/publish-docs.yml

@@ -0,0 +1,27 @@
+permissions: write-all
+
+name: publish-docs
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: 17
+#          server-id: oss.sonatype.org
+#          server-username: MAVEN_USERNAME
+#          server-password: MAVEN_PASSWORD
+#          gpg-private-key: ${{ secrets.MAVEN_GPG_PRIVATE_KEY }}
+#          gpg-passphrase: MAVEN_GPG_PASSPHRASE
+
+      - name: generate maven site
+        run: mvn site site:stage
+
+      - name: publish to gh-pages
+        run: mvn scm-publish:publish-scm

pom.xml

@@ -34,6 +34,10 @@
             <name>GitHub</name>
             <url>https://maven.pkg.github.com/THM-graphs/neo4j-atag</url>
         </repository>
+        <site>
+            <id>github</id>
+            <url>scm:git:git@github.com:THM-Graphs/neo4j-atag.git</url>
+        </site>
     </distributionManagement>
 
     <dependencies>
@@ -180,6 +184,14 @@
                     <tagNameFormat>v@{project.version}</tagNameFormat>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-scm-publish-plugin</artifactId>
+                <version>3.2.1</version>
+                <configuration>
+                    <scmBranch>gh-pages</scmBranch>
+                </configuration>
+            </plugin>
 <!--
             <plugin>
                 <groupId>com.ragedunicorn.tools.maven</groupId>