feat: also publish javadoc

Author: erdos

.github/workflows/gh-pages.yml

@@ -14,11 +14,9 @@ permissions:
   pages: write
   id-token: write
 
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
   group: "pages"
-  cancel-in-progress: false
+  cancel-in-progress: true
 
 jobs:
   # Build job
@@ -34,6 +32,10 @@ jobs:
         with:
           source: ./docs
           destination: ./_site
+      - name: Compile uberjar
+        run: lein uberjar
+      - name: Run javadoc tool
+        run: javadoc -d _site/javadoc --source-path ./java-src -cp target/stencil-core-*-standalone.jar -subpackages io.github.erdos.stencil
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v2
 

.gitignore

@@ -20,4 +20,5 @@ junit.xml
 .DS_Store
 .lsp/
 *.jfr
-.clj-kondo/
+.clj-kondo/
+/_site/

java-src/io/github/erdos/stencil/functions/package-info.java

@@ -1,10 +1,5 @@
 /**
- * General purpose functions.
- * <p>
- * Function implementations come here.
- *
- *
- * <h3>Custom Functions</h3>
+ * <h2>Custom Functions</h2>
  * <p>
  * It is possible to define custom functions on the host code and invoke them from  within the template files.
  * Custom functions must implement the {@link io.github.erdos.stencil.functions.Function} interface and be registered