doc_to_pages.yml

name: Generate pages from doc

on:
  workflow_call:
    inputs:
      source: # id of input
        description: "Path to doc folder"
        required: false
        default: "./doc/"
        type: string
      destination:
        description: "Path to output generated site"
        required: false
        default: "./_site/"
        type: string
      baseurl:
        description: "baseurl of generated site"
        required: false
        default: ""
        type: string
      deploy:
        description: "Whether to save generated site as artifact"
        required: false
        default: true
        type: boolean
      force_regen:
        description: "Force regenerate"
        required: false
        default: false
        type: string

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
  contents: read
  pages: write
  id-token: write

# Allow one concurrent deployment
# concurrency:
#   group: ${{ inputs.baseurl }}
#   cancel-in-progress: true

jobs:
  # only rebuild if files under doc/ folder changed
  check:
    runs-on: ubuntu-latest
    outputs:
      doc_changed: ${{ steps.doc_changed.outputs.doc }}
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0
      - run: git branch
      - uses: dorny/paths-filter@v2
        id: doc_changed
        with:
          list-files: shell
          # base: develop
          # ref: develop
          filters: |
            doc:
              - 'doc/**'
              - '.github/workflows/doc_to_pages.yml'
              - '.github/workflows/publish_doc.yml'
      - name: Doc changed result is ${{ steps.doc_changed.outputs.doc }}
        run: |
          echo ${{ steps.doc_changed.outputs.doc }}
          echo ${{ steps.doc_changed.outputs.doc == 'true' }}
      - name: Force regen is ${{ inputs.force_regen == 'true' }}
        run: |
          echo ${{ inputs.force_regen }}
          echo ${{ inputs.force_regen == 'true' }}

  # Build job
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.11"]
    needs: check
    if: ${{ ( needs.check.outputs.doc_changed == 'true' ) || ( inputs.force_regen == 'true' ) }}
    steps:
      - run: |
          echo needs.check.outputs.doc_changed == 'true'
          echo ${{ needs.check.outputs.doc_changed == 'true' }}
          echo inputs.force_regen
          echo ${{ inputs.force_regen }}
          echo inputs.force_regen == 'true'
          echo ${{ inputs.force_regen == 'true' }}

      - uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Setup Pages
        id: pages
        uses: actions/configure-pages@v2

      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: "3.0" # Not needed with a .ruby-version file
          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
          cache-version: 1 # Increment this number if you need to re-download cached gems
          working-directory: ${{ inputs.source }}

      - name: Jekyll build
        run: |
          git branch
          dst=$(pwd)/${{ inputs.destination }}
          # tree .
          cd ${{ inputs.source }}
          pwd
          python prepare.py ${{ inputs.baseurl }} # insert headers, change md relative link path to html ...
          bundle exec jekyll build \
            --config ./CN/_config.yml \
            --source ./CN/ \
            --destination $dst/CN/ \
            --baseurl ${{ inputs.baseurl }}CN/
          bundle exec jekyll build \
            --config ./EN/_config.yml \
            --source ./EN/ \
            --destination $dst/EN/ \
            --baseurl ${{ inputs.baseurl }}EN/
          cp -s $dst/CN/index.html $dst/

          # tree $dst
          cd -

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v1 # This will automatically upload an artifact from the '/_site' directory
        with:
          path: ${{ inputs.destination }}
          retention-days: 7

  # Deployment job
  deploy:
    needs: build
    if: inputs.deploy
    environment:
      name: github-pages
      url: steps.deployment.outputs.page_url
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v1