docs/.github/workflows/buildDocs.yml at main · eclipse-xfsc/docs · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
name: Run docToolchain

on:
  push:
    branches:
      - main


jobs:
  build:
    runs-on: ubuntu-latest
    env:
      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
    steps:
      - name: Check out code
        uses: actions/checkout@v5
        with:
          lfs: true

      - name: Setup Java
        uses: actions/setup-java@v5
        with:
          distribution: 'temurin'
          java-version: '17'

      - name: Setup Node.js
        uses: actions/setup-node@v5
        with:
          node-version: '22'

      - name: Verify Chrome is installed
        run: |
          which google-chrome || which google-chrome-stable || echo "Chrome not found"
          google-chrome --version || google-chrome-stable --version || echo "Cannot run Chrome"

      - name: Install Mermaid CLI
        run: npm install -g @mermaid-js/mermaid-cli

      - name: Verify Mermaid CLI installation and create symlink
        run: |
          which mmdc
          mmdc --version
          echo "PATH=$PATH"
          sudo ln -sf $(which mmdc) /usr/local/bin/mmdc
          which mmdc
          ls -la /usr/local/bin/mmdc

      - name: Test mmdc with simple diagram
        run: |
          echo 'graph TD; A-->B;' > test.mmd
          CHROME_PATH=$(which google-chrome-stable || which google-chrome)
          echo "Using Chrome at: $CHROME_PATH"
          PUPPETEER_EXECUTABLE_PATH="$CHROME_PATH" mmdc -i test.mmd -o test.png || echo "mmdc test failed"
          ls -la test.* || true

      - name: Install docToolchain locally
        run: |
          cd ./federated-catalogue
          ./dtcw local install doctoolchain

      - name: Generate HTML Documentation
        run: |
          cd ./federated-catalogue
          export CHROME_PATH=$(which google-chrome-stable || which google-chrome)
          echo "Using Chrome at: $CHROME_PATH"
          PUPPETEER_EXECUTABLE_PATH="$CHROME_PATH" ./dtcw local generateHTML

      - name: Generate PDF Documentation
        run: |
          cd ./federated-catalogue
          export CHROME_PATH=$(which google-chrome-stable || which google-chrome)
          echo "Using Chrome at: $CHROME_PATH"
          PUPPETEER_EXECUTABLE_PATH="$CHROME_PATH" ./dtcw local generatePDF

      - name: Upload Artifacts
        uses: actions/upload-artifact@v6
        with:
          name: Documentation
          path: |
            federated-catalogue/build/pdf/architecture/catalogue-architecture.pdf
            federated-catalogue/build/html5/