docs: add ARO Essential Primer with PDF build and CI/CD integration

.github/workflows/build.yml

@@ -1222,6 +1222,19 @@ jobs:
           path: Book/ThePluginGuide/output/ARO-Plugin-Guide.pdf
           retention-days: 30
 
+      - name: Build Essential Primer PDF
+        run: |
+          cd Book/TheEssentialPrimer
+          chmod +x build-pdf.sh
+          ./build-pdf.sh
+
+      - name: Upload Essential Primer PDF
+        uses: actions/upload-artifact@v4
+        with:
+          name: aro-essential-primer
+          path: Book/TheEssentialPrimer/output/ARO-Essential-Primer.pdf
+          retention-days: 30
+
   # ===========================================================================
   # Create Release (only on tags)
   # ===========================================================================
@@ -1283,7 +1296,8 @@ jobs:
             artifacts/aro-language-guide/ARO-Language-Guide.pdf \
             artifacts/aro-plugin-guide/ARO-Plugin-Guide.pdf \
             artifacts/aro-construction-studies/ARO-Construction-Studies.pdf \
-            artifacts/aro-by-example/ARO-By-Example.pdf; do
+            artifacts/aro-by-example/ARO-By-Example.pdf \
+            artifacts/aro-essential-primer/ARO-Essential-Primer.pdf; do
             if [ -f "$f" ]; then
               FILES="${FILES}${f}\n"
             else
@@ -1323,6 +1337,7 @@ jobs:
             artifacts/aro-plugin-guide/ARO-Plugin-Guide.pdf
             artifacts/aro-construction-studies/ARO-Construction-Studies.pdf
             artifacts/aro-by-example/ARO-By-Example.pdf
+            artifacts/aro-essential-primer/ARO-Essential-Primer.pdf
           fail_on_unmatched_files: false
           body: |
             ## ARO Programming Language ${{ steps.version.outputs.version }}
@@ -1339,6 +1354,7 @@ jobs:
             | ARO Plugin Guide | [ARO-Plugin-Guide.pdf](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/ARO-Plugin-Guide.pdf) |
             | ARO Construction Studies | [ARO-Construction-Studies.pdf](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/ARO-Construction-Studies.pdf) |
             | ARO By Example | [ARO-By-Example.pdf](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/ARO-By-Example.pdf) |
+            | ARO Essential Primer | [ARO-Essential-Primer.pdf](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/ARO-Essential-Primer.pdf) |
 
             ### Installation
 

.gitignore

@@ -115,6 +115,7 @@ testrun.log
 /Examples/DirectoryReplicatorEvents/DirectoryReplicatorEvents
 /Examples/AssertDemo/AssertDemo
 /Book/ThePluginGuide/output
+/Book/TheEssentialPrimer/output
 **/__pycache__/
 **/*.pyc
 **/Plugins/**/*.dylib

.gitlab-ci.yml

@@ -338,12 +338,18 @@ documentation:
     - cd Book/AROByExample
     - chmod +x build-pdf.sh
     - ./build-pdf.sh
+    - cd ../..
+    # Build Essential Primer
+    - cd Book/TheEssentialPrimer
+    - chmod +x build-pdf.sh
+    - ./build-pdf.sh
   artifacts:
     name: aro-documentation
     paths:
       - Book/TheLanguageGuide/output/ARO-Language-Guide.pdf
       - Book/TheConstructionStudies/output/ARO-Construction-Studies.pdf
       - Book/AROByExample/output/ARO-By-Example.pdf
+      - Book/TheEssentialPrimer/output/ARO-Essential-Primer.pdf
     expire_in: 30 days
   tags:
     - spencer
@@ -380,6 +386,7 @@ release:
     - ls -la Book/TheLanguageGuide/output/ARO-Language-Guide.pdf || echo "Language Guide PDF not found"
     - ls -la Book/TheConstructionStudies/output/ARO-Construction-Studies.pdf || echo "Construction Studies PDF not found"
     - ls -la Book/AROByExample/output/ARO-By-Example.pdf || echo "ARO By Example PDF not found"
+    - ls -la Book/TheEssentialPrimer/output/ARO-Essential-Primer.pdf || echo "Essential Primer PDF not found"
 
     # Determine if prerelease
     - |
@@ -394,6 +401,7 @@ release:
       - Book/TheLanguageGuide/output/ARO-Language-Guide.pdf
       - Book/TheConstructionStudies/output/ARO-Construction-Studies.pdf
       - Book/AROByExample/output/ARO-By-Example.pdf
+      - Book/TheEssentialPrimer/output/ARO-Essential-Primer.pdf
     expire_in: 1 year
   release:
     tag_name: $CI_COMMIT_TAG
@@ -414,6 +422,7 @@ release:
       | ARO Language Guide | [ARO-Language-Guide.pdf]($CI_PROJECT_URL/-/releases/$CI_COMMIT_TAG/downloads/ARO-Language-Guide.pdf) |
       | ARO Construction Studies | [ARO-Construction-Studies.pdf]($CI_PROJECT_URL/-/releases/$CI_COMMIT_TAG/downloads/ARO-Construction-Studies.pdf) |
       | ARO By Example | [ARO-By-Example.pdf]($CI_PROJECT_URL/-/releases/$CI_COMMIT_TAG/downloads/ARO-By-Example.pdf) |
+      | ARO Essential Primer | [ARO-Essential-Primer.pdf]($CI_PROJECT_URL/-/releases/$CI_COMMIT_TAG/downloads/ARO-Essential-Primer.pdf) |
 
       ### Installation
 
@@ -440,6 +449,10 @@ release:
           url: '$CI_PROJECT_URL/-/jobs/artifacts/$CI_COMMIT_TAG/raw/Book/AROByExample/output/ARO-By-Example.pdf?job=release'
           filepath: '/ARO-By-Example.pdf'
           link_type: 'other'
+        - name: 'ARO-Essential-Primer.pdf'
+          url: '$CI_PROJECT_URL/-/jobs/artifacts/$CI_COMMIT_TAG/raw/Book/TheEssentialPrimer/output/ARO-Essential-Primer.pdf?job=release'
+          filepath: '/ARO-Essential-Primer.pdf'
+          link_type: 'other'
   tags:
     - spencer