Skip to content
Build and deploy camel documents

feat: Dynamic dependency loading (#2495) #1640

Sign in to view logs

feat: Dynamic dependency loading (#2495)

feat: Dynamic dependency loading (#2495) #1640

Workflow file for this run

.github/workflows/documentation.yml at 1073a30
name: Build and deploy camel documents
on:
push:
branches: [ "master", "qa" ]
workflow_dispatch:
permissions:
contents: write
jobs:
docs:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
with:
fetch-depth: 0
persist-credentials: false
- name: Set up Python environment and install dependencies
uses: ./.github/actions/camel_install
with:
python-version: "3.10"
- name: Install Pandoc
run: sudo apt-get install -y pandoc
- name: Convert Cookbooks and Update Mintlify Config
run: |
source .venv/bin/activate
echo "Manual workflow - processing all cookbooks files"
python docs/mintlify/convert_notebook2mdx.py \
--input docs/cookbooks \
--output docs/mintlify \
--update-docs-json docs/mintlify/docs.json \
--docs-path-prefix "" \
--verbose
- name: Convert Get Started docs
run: |
source .venv/bin/activate
echo "Manual workflow - processing all get_started files"
python docs/mintlify/convert_notebook2mdx.py \
--input docs/get_started \
--output docs/mintlify \
--update-docs-json docs/mintlify/docs.json \
--docs-path-prefix "" \
--verbose
- name: Convert Key Modules docs
run: |
source .venv/bin/activate
echo "Manual workflow - processing all key_modules files"
python docs/mintlify/convert_notebook2mdx.py \
--input docs/key_modules \
--output docs/mintlify \
--update-docs-json docs/mintlify/docs.json \
--docs-path-prefix "" \
--verbose
- name: Generate API Documentation
run: |
source .venv/bin/activate
echo "Using incremental API docs generation for optimal performance"
python docs/mintlify/build_api_docs.py \
--output_dir docs/mintlify/reference \
--mint_json docs/mintlify/docs.json \
--package camel \
--incremental \
--since_hours 24
- name: Commit and push changes
env:
PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
run: |
git config --global user.email "action@github.com"
git config --global user.name "GitHub Action"
git add docs/mintlify/ docs/mintlify/get_started/ docs/mintlify/key_modules/ docs/mintlify/reference/ docs/mintlify/docs.json
if git diff --staged --quiet; then
echo "No changes to commit"
else
git commit -m "Auto-update documentation after merge"
git remote set-url origin https://x-access-token:${PAT_TOKEN}@github.com/${{ github.repository }}
git push origin ${{ github.ref_name }}
fi