Merge pull request #1 from evolvedbinary/develop

Switch to a Maven Project Layout and auto-build PDF and Website

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    name: Build and Test
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        jdk: [11]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          java-version: ${{ matrix.jdk }}
+          distribution: 'liberica'
+      - name: Build
+        run: mvn -B clean package

.github/workflows/pages.yml

@@ -0,0 +1,51 @@
+name: pages
+on:
+  push:
+    branches: ["develop"]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  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
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          java-version: 11
+          distribution: 'liberica'
+      - name: Generate website (XSLT)
+        id: generate
+        # Override Maven properties for the Petal button url
+        run: mvn -B -Dpetal.api-url=https://petal.evolvedbinary.com -Dpetal.github-org-name=evolvedbinary -Dpetal.github-repo-name=cityehr-documentation -Dpetal.github-branch=develop -Dpetal.referrer-base-url=https://evolvedbinary.github.io/cityehr-documentation package -Pquick-start-guide-website
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload pages artifact
+        id: deployment
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: cityehr-quick-start-guide/target/website/
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: generate
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,2 @@
+.idea/
+target/

cityehr-documentation-parent/pom.xml

@@ -0,0 +1,104 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.seveninformatics.cityehr.documentation</groupId>
+    <artifactId>cityehr-documentation-parent</artifactId>
+    <version>1.0.0-SNAPSHOT</version>
+    <packaging>pom</packaging>
+
+    <name>cityEHR Documentation Parent POM</name>
+    <description>Parent POM for cityEHR documentation projects</description>
+    <url>https://seveninformatics.com/cityehr/</url>
+    <inceptionYear>2024</inceptionYear>
+
+    <organization>
+        <name>Seven Informatics</name>
+        <url>https://seveninformatics.com</url>
+    </organization>
+
+    <licenses>
+        <license>
+            <name>GNU Lesser General Public License, version 2.1</name>
+            <url>https://opensource.org/licenses/LGPL-2.1</url>
+            <distribution>repo</distribution>
+            <comments>For XSLT and Maven Code</comments>
+        </license>
+        <license>
+            <name>Creative Commons Attribution NonCommercial ShareAlike 4.0</name>
+            <url>https://creativecommons.org/licenses/by-nc-sa/4.0/</url>
+            <distribution>repo</distribution>
+            <comments>For Documentation Content</comments>
+        </license>
+    </licenses>
+
+    <developers>
+        <developer>
+            <name>John Chelsom</name>
+            <organization>Seven Informatics</organization>
+            <organizationUrl>https://www.seveninformatics.com</organizationUrl>
+            <email>john.chelsom@seveninformatics.com</email>
+        </developer>
+    </developers>
+
+    <contributors>
+    	<contributor>
+    	    <name>Stephanie Cabrera</name>
+    	</contributor>
+    	<contributor>
+            <name>Catriona Hopper</name>
+        </contributor>
+    	<contributor>
+            <name>Jennifer Ramirez</name>
+        </contributor>
+        <contributor>
+            <name>Adam Retter</name>
+            <organization>Evolved Binary</organization>
+            <organizationUrl>https://www.evolvedbinary.com</organizationUrl>
+            <email>adam@evolvedbinary.com</email>
+        </contributor>
+    </contributors>
+
+    <scm>
+        <connection>scm:git:https://github.com/cityehr/cityehr-documentation.git</connection>
+        <developerConnection>scm:git:https://github.com/cityehr/cityehr-documentation.git</developerConnection>
+        <url>scm:git:https://github.com/cityehr/cityehr-documentation.git</url>
+    </scm>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <saxon.version>12.5</saxon.version>
+    </properties>
+
+    <build>
+        <pluginManagement>
+            <plugins>
+                <plugin>
+                    <groupId>org.apache.maven.plugins</groupId>
+                    <artifactId>maven-resources-plugin</artifactId>
+                    <version>3.3.1</version>
+                </plugin>
+                <plugin>
+                    <groupId>org.codehaus.mojo</groupId>
+                    <artifactId>xml-maven-plugin</artifactId>
+                    <version>1.1.0</version>
+                    <configuration>
+                        <transformerFactory>net.sf.saxon.TransformerFactoryImpl</transformerFactory>
+                    </configuration>
+                    <dependencies>
+                        <dependency>
+                            <groupId>net.sf.saxon</groupId>
+                            <artifactId>Saxon-HE</artifactId>
+                            <version>${saxon.version}</version>
+                        </dependency>
+                    </dependencies>
+                </plugin>
+                <plugin>
+                    <groupId>org.codehaus.mojo</groupId>
+                    <artifactId>exec-maven-plugin</artifactId>
+                    <version>3.4.1</version>
+                </plugin>
+            </plugins>
+        </pluginManagement>
+    </build>
+
+</project>