Skip to content
Fetch and compile MAG workflow documentation

Specify branch name as "master" instead of "main" (modern default) #2

Sign in to view logs

Specify branch name as "master" instead of "main" (modern default)

Specify branch name as "master" instead of "main" (modern default) #2

Workflow file for this run

.github/workflows/fetch-and-compile-mag-workflow-documentation.yml at 87815d9
name: Fetch and compile MAG workflow documentation
on:
push: { branches: [ main ] }
workflow_dispatch: { }
# Allow this workflow to be called by other workflows.
# Reference: https://docs.github.com/en/actions/using-workflows/reusing-workflows
workflow_call: { }
jobs:
compile:
name: Compile
runs-on: ubuntu-latest
steps:
# Docs: https://github.com/actions/checkout
- name: Check out commit
uses: actions/checkout@v4
# Note: The default branch of the `metaMAGs` repository is named "master"
- name: Check out commit from `metaMAGs/master`
uses: actions/checkout@v4
with:
# Notes:
# - `repository` format is: "{owner_name}/{repo_name}"
# - The default branch of the `metaMAGs` repository is named "master"
repository: microbiomedata/metaMAGs # format is "{owner_name}/{repo_name}"
ref: master
sparse-checkout: |
docs
path: _clones/microbiomedata/metaMAGs # where, locally, to create the clone
# Docs: https://github.com/actions/setup-python
- name: Set up Python
uses: actions/setup-python@v5
with: { python-version: '3.12' }
- name: Install dependencies of `metaMAGs` docs
run: python -m pip install sphinx
# Docs: https://www.mkdocs.org/user-guide/cli/
- name: Compile source documents into HTML
working-directory: _clones/microbiomedata/metaMAGs
run: sphinx-build -b html docs ${{ github.workspace }}/_dist
# Upload the result as an "artifact" so it can then be downloaded and used by another job.
- name: Save the HTML for publishing later # Docs: https://github.com/actions/upload-artifact
uses: actions/upload-artifact@v4
with:
name: mag-workflow-documentation-as-html
# Note: Relative `path` values here are relative to the _workspace_, not to the current working directory.
# Reference: https://github.com/actions/upload-artifact/pull/477#issue-2044900649
path: _dist
if-no-files-found: error
retention-days: 1 # Note: 1 day is the shortest period possible