Translate LaTeX documentation to PDF

.github/workflows/CompletePipeline.yml

@@ -33,6 +33,11 @@ on:
         description: 'Name of the tool''s package.'
         required: true
         type: string
+      documentation:
+        description: 'Name of documentation document.'
+        required: false
+        default: ''
+        type: string
       unittest_python_version:
         description: 'Python version.'
         required: false
@@ -310,15 +315,15 @@ jobs:
       sqlite_coverage_artifacts_prefix: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}-
       xml_unittest_artifacts_prefix:    ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}-
 
-#  PDFDocumentation:
-#    uses: pyTooling/Actions/.github/workflows/LaTeXDocumentation.yml@dev
-#    needs:
-#      - UnitTestingParams
-#      - Documentation
-#    with:
-#      document: pyEDAA.ProjectModel
-#      latex_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
-#      pdf_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_pdf }}
+  PDFDocumentation:
+    uses: pyTooling/Actions/.github/workflows/LaTeXDocumentation.yml@latex
+    needs:
+      - UnitTestingParams
+      - Documentation
+    with:
+      document: ${{ inputs.documentation }}
+      latex_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+      pdf_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_pdf }}
 
   PublishToGitHubPages:
     uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@dev
@@ -392,7 +397,7 @@ jobs:
       - UnitTesting
       - StaticTypeCheck
       - Documentation
-#      - PDFDocumentation
+      - PDFDocumentation
       - PublishTestResults
       - PublishCoverageResults
       - PublishToGitHubPages

.github/workflows/LaTeXDocumentation.yml

@@ -43,33 +43,37 @@ on:
         required: false
         default: ''
         type: string
+      miktex_image:
+        description: 'Name of the MikTeX image.'
+        required: false
+        default: 'pytooling/miktex:latest'
+        type: string
 
 jobs:
   PDFDocumentation:
     name: 📓 Converting LaTeX Documentation to PDF
     runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
+    container:
+      image: ${{ inputs.miktex_image }}
+
     steps:
       - name: 📥 Download artifacts '${{ inputs.latex_artifact }}' from 'SphinxDocumentation' job
         uses: pyTooling/download-artifact@v4
         with:
           name: ${{ inputs.latex_artifact }}
           path: latex
 
-      - name: Debug
+      - name: Version check
         run: |
-          tree -pash .
+          echo "which pdflatex: $(which pdflatex)"
+          echo ""
+          pdflatex --version
 
-      - name: Build LaTeX document using 'pytooling/miktex:sphinx'
-        uses: addnab/docker-run-action@v3
-        with:
-          image: pytooling/miktex:sphinx
-          options: -v ${{ github.workspace }}/latex:/latex --workdir /latex
-          run: |
-            which pdflatex
-            pwd
-            ls -lAh
-
-            latexmk -xelatex ${{ inputs.document }}.tex
+      - name: Version check
+        run: |
+          cd latex
+          ls -lAh *.tex
+          latexmk ${{ inputs.document }}.tex
 
       - name: 📤 Upload 'PDF Documentation' artifact
         uses: pyTooling/upload-artifact@v4

.github/workflows/_Checking_NamespacePackage_Pipeline.yml

@@ -6,10 +6,11 @@ on:
 
 jobs:
   NamespacePackage:
-    uses: pyTooling/Actions/.github/workflows/CompletePipeline.yml@dev
+    uses: pyTooling/Actions/.github/workflows/CompletePipeline.yml@latex
     with:
       package_namespace: pyExamples
       package_name:      Extensions
+      documentation:     Actions
       codecov:           true
       codacy:            true
       dorny:             true

.github/workflows/_Checking_SimplePackage_Pipeline.yml

@@ -6,13 +6,14 @@ on:
 
 jobs:
   SimplePackage:
-    uses: pyTooling/Actions/.github/workflows/CompletePipeline.yml@dev
+    uses: pyTooling/Actions/.github/workflows/CompletePipeline.yml@latex
     with:
-      package_name: pyDummy
-      codecov: true
-      codacy:  true
-      dorny:   true
-      cleanup: false
+      package_name:  pyDummy
+      documentation: Actions
+      codecov:       true
+      codacy:        true
+      dorny:         true
+      cleanup:       false
     secrets:
       PYPI_TOKEN:    ${{ secrets.PYPI_TOKEN }}
       CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}