Fix compile workflow (#157)

## Pull Request: Enhancements and Fixes for Compile Workflow

This pull request introduces a series of enhancements and bug fixes aimed at improving the reliability and efficiency of the compile workflow.

**Key improvements:**

* **Resolved Build Failure (Temporary Fix Only):**  A function impacting the build workflow has been temporarily disabled to ensure successful compilation.  ⚠️ **This is a temporary workaround and requires a permanent solution before release.** ⚠️ Pls See #154 for more details
* **Dependency Updates:**
    * Updated `checkout` and `texlive` actions to the lates release
    * Updated the `texlive` version to the latest release
* **Fixed LaTeX Parsing:** Resolved an issue related to the parsing of LaTeX escape characters, ensuring accurate interpretation and rendering of special symbols
* **File Management:**
    * Corrected a missing file dependency and rectified an instance of file misnaming
    * Refactored file names to fit the new project structure 
    * Rectified a misspelled folder name
    * Added empty dummy files that have not yet been written or restructured
    * Rewrote the `.gitignore` file to exclude compiled artifacts and IDE-generated folders
 * **Test Workflow:**
    * Automated Tests through a workflow.
    * First test checks the links for:
       * is the URL still up/valid
       * Is it an https link instead of a http link
       * is the presented certificate valid


## Important Notice for People writing branches

If you are working on other branches, please ensure you update your local branch with the changes from this pull request **before** continuing your work. This will prevent potential conflicts and ensure consistency across the project.

You can update your branch using the following commands:

```bash
git switch <your_branch_name>
git rebase origin/fix_compile_workflow
```

Author: fschledorn

.github/workflows/build.yml

@@ -0,0 +1,80 @@
+name: Build and Run Tests
+
+on:
+  push: {}
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - uses: xu-cheng/texlive-action@v2
+        with:
+          scheme: full  # Consider changing to 'basic' or 'medium' if possible
+          run: |
+            apk add make
+            apk add g++
+            apk add zip
+            make script zip
+      - uses: actions/upload-artifact@v4
+        with:
+          name: PDF_Test
+          path: vorkurs.pdf
+
+  check-links:
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download compiled PDF
+        uses: actions/download-artifact@v4
+        with:
+          name: PDF_Test
+          path: .
+
+      - name: Install pdfgrep
+        run: sudo apt-get update && sudo apt-get install -y pdfgrep
+
+      - name: Extract and Check URLs
+        run: |
+          urls=$(pdfgrep -o -P 'https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_\+.~#?&//=]*)' vorkurs.pdf | sort -u)
+          error_count=0
+
+          for url in $urls; do
+            echo "Checking URL: $url"
+
+            if [[ ! "$url" =~ ^https:// ]]; then
+              echo "ERROR: URL is not HTTPS: $url"
+              error_count=$((error_count + 1))
+              continue
+            fi
+
+            if ! curl -Isf --fail-early --connect-timeout 10 "$url" > /dev/null 2>&1; then
+              curl_error=$(curl -Isf --fail-early --connect-timeout 10 "$url" 2>&1 > /dev/null)
+              if [[ $curl_error == *"Failed to connect"* ]]; then
+                echo "ERROR: Connection failed: $url"
+              elif [[ $curl_error == *"Could not resolve host"* ]]; then
+                echo "ERROR: DNS resolution failed: $url"
+              elif [[ $curl_error == *"SSL certificate problem"* ]]; then
+                 echo "ERROR: Initial SSL certificate problem: $url"
+              else
+                echo "ERROR: Failed to access: $url (curl error: $curl_error)"
+              fi
+              if ! openssl s_client -connect "$(echo "$url" | sed 's/https\?:\/\///' | cut -d/ -f1):443" -servername "$(echo "$url" | sed 's/https\?:\/\///' | cut -d/ -f1)" 2>/dev/null </dev/null | openssl x509 -noout; then
+                 echo "  -> CERTIFICATE ERROR DETECTED!"
+              fi
+
+              error_count=$((error_count + 1))
+            fi
+          done
+
+          if [ "$error_count" -gt 0 ]; then
+            echo "::error::Found $error_count broken or insecure links!"
+            exit 1
+          fi
+        shell: bash

.github/workflows/build_and_test.yml

@@ -17,3 +17,6 @@ vorkurs/
 vorkurs.zip
 pool_setup/poolpw
 title.pdf
+.vscode/
+.DS_Store
+*.dSYM

.gitignore

@@ -3,10 +3,10 @@ \chapter{Appendix}
 
 
 \pagestyle{fancy}
-\input{appendix/cheatsheet_shortcuts}
-\input{appendix/cheatsheet_shellcomands}
-\input{appendix/coding_style}
-\input{appendix/fehler_fehlermeldungen}
+\input{appendix/cheatsheet_shortcuts} %ToDo needs to be added
+\input{appendix/cheatsheet_shellcomands} % ToDo needs to be added
+\input{appendix/coding_style} %ToDo, partially done
+\input{appendix/error_messages} % ToDo needs to be added
 
 \clearpage
 \pagestyle{empty}

appendix/cheatsheet_shellcomands.tex

@@ -5,6 +5,6 @@ \chapter{Vorbereitung eigener Computer}
 Wir werden in diesem Fall den proprietären Editor „Visual Studio Code“ verwenden, welcher \href{https://code.visualstudio.com/Download}{hier} heruntergeladen werden kann.\\
 
 \pagestyle{fancy}
-\input{eigene_computer/windows.tex}
-\input{eigene_computer/macos.tex}
-\input{eigene_computer/linux.tex}
+\input{eigener_computer/linux}
+\input{eigener_computer/windows}
+\input{eigener_computer/macos}