mirror of
https://github.com/huggingface/lerobot.git
synced 2026-05-13 15:49:53 +00:00
2f238fce15
* feat(ci): adds release versioning to docs * chore(ci): remove TODO
76 lines
2.6 KiB
YAML
76 lines
2.6 KiB
YAML
# Copyright 2025 The HuggingFace Inc. team. All rights reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
# This workflow handles building documentation for both main branches and PRs.
|
|
name: Documentation
|
|
|
|
on:
|
|
# Allows running this workflow manually from the Actions tab
|
|
workflow_dispatch:
|
|
|
|
# Triggers the workflow on push events to main for the docs folder
|
|
push:
|
|
branches:
|
|
- main
|
|
paths:
|
|
- "docs/**"
|
|
|
|
# Triggers the workflow on pull request events targeting main for the docs folder
|
|
pull_request:
|
|
branches:
|
|
- main
|
|
paths:
|
|
- "docs/**"
|
|
|
|
release:
|
|
types: [published]
|
|
|
|
# Ensures that only the latest commit for a PR or branch is built, canceling older runs.
|
|
concurrency:
|
|
group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
# This job builds and deploys the official documentation.
|
|
build_main_docs:
|
|
name: Build Main Docs
|
|
if: >
|
|
(github.event_name == 'push' || github.event_name == 'workflow_dispatch' || github.event_name == 'release') &&
|
|
github.repository == 'huggingface/lerobot'
|
|
permissions:
|
|
contents: read
|
|
uses: huggingface/doc-builder/.github/workflows/build_main_documentation.yml@main
|
|
with:
|
|
commit_sha: ${{ github.sha }}
|
|
package: lerobot
|
|
additional_args: --not_python_module ${{ github.event_name == 'release' && format('--version {0}', github.event.release.tag_name) || '' }}
|
|
secrets:
|
|
token: ${{ secrets.HUGGINGFACE_PUSH }}
|
|
hf_token: ${{ secrets.HF_DOC_BUILD_PUSH }}
|
|
|
|
# This job builds a preview of the documentation for a pull request.
|
|
# The result of this job triggers the 'Upload PR Documentation' workflow.
|
|
build_pr_docs:
|
|
name: Build PR Docs
|
|
if: github.event_name == 'pull_request' && github.repository == 'huggingface/lerobot'
|
|
permissions:
|
|
contents: read
|
|
pull-requests: write
|
|
uses: huggingface/doc-builder/.github/workflows/build_pr_documentation.yml@main
|
|
with:
|
|
commit_sha: ${{ github.event.pull_request.head.sha }}
|
|
pr_number: ${{ github.event.number }}
|
|
package: lerobot
|
|
additional_args: --not_python_module
|