deploy_api_docs.yml

#name: Build FORD docs & deploy to gh-pages
name: FORD docs deployed to main
on:
  push:
    branches:
      - main

jobs:
  build:
    name: Deploy docs
    runs-on: ubuntu-latest
    steps:
      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: '3.x'

      - name: Install dependencies
        run: python -m pip install --upgrade pip ford

      - name: Checkout main
        uses: actions/checkout@v1

      - name: Build docs
        run: |
              ford --version
              ford ford.md
              ls
              tree

      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@releases/v3
        with:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          #BRANCH: gh_pages
          BRANCH: main
          FOLDER: docs/fpm-ford
          TARGET_FOLDER: docs/fpm-ford
#         ford(1) deletes the output directory before running
#         so be careful to specify a unique subdirectory in
#         your ford(1) configuration files

# valid inputs are ['SSH', 'ACCESS_TOKEN', 'GITHUB_TOKEN', 'BRANCH',
# 'FOLDER', 'TARGET_FOLDER', 'BASE_BRANCH', 'COMMIT_MESSAGE', 'CLEAN',
# 'CLEAN_EXCLUDE', 'GIT_CONFIG_NAME', 'GIT_CONFIG_EMAIL', 'REPOSITORY_NAME',
# 'WORKSPACE', 'SINGLE_COMMIT', 'LFS', 'SILENT', 'PRESERVE']