Setup actions

Author: Wim3000

.github/workflows/create-release.yml

@@ -0,0 +1,97 @@
+name: Ximera Workflow
+
+on:
+  push:
+    # tags:
+    #   - 'v*'  # Trigger the workflow when a new tag starting with 'v' is pushed   
+
+jobs:
+  build-ximera:
+    name: Build and preview Ximera Courses
+    runs-on: ubuntu-latest
+
+    permissions:
+      actions: read
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # full 
+
+      - name: Setup cache
+        uses: actions/cache@v4
+        with:
+          path: | 
+            **/*.html
+            **/*.pdf
+            **/*.svg
+            **/*.aux
+            **/*.xref
+            **/*.toc
+            !xmPictures/**
+            !.git/**
+            !.github/**
+          key: ximera-${{ github.ref_name }}-${{ github.sha }}
+          restore-keys: |
+            ximera-${{ github.ref_name }}-
+            ximera-
+
+
+      - name: Build and publish Ximera courses
+        env:
+          # These variables can/should be set at repository level
+          # If not set, defaults from xmScripts/config.txt or xlatex will be used 
+          # (The defaults will presumably make this step fail.)
+          GPG_KEY: ${{ secrets.GPG_KEY }}
+          GPG_KEY_ID: ${{ secrets.GPG_KEY_ID }}
+          XIMERA_URL: ${{ vars.XIMERA_URL }}
+          XIMERA_NAME: ${{ vars.XIMERA_NAME }}${{ github.ref_name }}
+        run: |
+          ls -alrt
+          chmod +x xmScripts/xmlatex   # Overleaf sync might reset it :-()
+          ./xmScripts/xmlatex ghaction
+          echo "✅ Published to $XIMERA_URL$XIMERA_NAME " >> $GITHUB_STEP_SUMMARY
+
+      - name: Setup ximera serve cache (only .git)
+        id: serve-cache
+        uses: actions/cache/save@v4
+        with:
+          path: | 
+            xmScripts/**
+            .git/**
+          key: ximeraSERVE-${{ github.ref_name }}-${{ github.sha }}
+
+
+  publish-ximera:
+    name: Publish Ximera Courses
+    needs: build-ximera # Waits for the build job to complete
+    runs-on: ubuntu-latest
+    environment: production  # Allows for 'manual review' step
+    steps:
+      - name: Restore ximera serve cache (only .git)
+        id: serve-cache-restore
+        uses: actions/cache/restore@v4
+        with:
+          fail-on-cache-miss: true
+          path: | 
+            xmScripts/**
+            .git/**
+          key: ximeraSERVE-${{ github.ref_name }}-${{ github.sha }}
+          
+      - name: Serve
+        env:
+          GPG_KEY: ${{ secrets.GPG_KEY }}
+          GPG_KEY_ID: ${{ secrets.GPG_KEY_ID }}
+          XIMERA_URL: ${{ vars.XIMERA_URL }}
+          XIMERA_NAME: ${{ vars.XIMERA_NAME }}
+        run: |
+          chmod +x xmScripts/xmlatex # Overleaf sync might reset it :-()
+          ./xmScripts/xmlatex name         
+          ./xmScripts/xmlatex serve -f  # NOTE: -f  should not be needed ...        
+          echo "✅ Published to $XIMERA_URL$XIMERA_NAME " >> $GITHUB_STEP_SUMMARY
+
+
+

.github/workflows/serve-ximera.yml

@@ -3,7 +3,7 @@
 #
 # : "${XAKE_BASE:=ximeralatex}"
 # : "${XAKE_VERSION:=v2.6.8}"
-# : "${XAKE_VERSION:=v2.6.8-full}"    # with texlive_full
+: "${XAKE_VERSION:=v2.6.8-full}"    # with texlive_full
 #
 # For publishing you'll need a GPG Key
 # To generate a key-pair, fill in your name and email, and run 'xmlatex genKey'