我一直在尝试使用 Sphinx 自动化 github 工作流程来记录我编写的一些 Python doce。目标是在进行任何修改后运行“make html”和“make Latex”以使文档保持最新。我创建了一个简单的工作流程,但是当我使用 guthub 操作运行它时,我收到错误:
运行 make html 错误:尝试使用工作目录“/home/runner/work/Repo_Name/Repo_Name/Directory_Name/docs/python”启动进程“/usr/bin/bash”时发生错误。没有这样的文件或目录
我不确定这是否与我设置环境的方式有关,或者是否与 actios 工作流程本身有关?我尝试使用 nektos act 在本地运行工作流程,它似乎有效,所以不确定为什么它在这里不起作用。
这是我迄今为止的工作流程:
name: Sphinx documentation generation
on:
push:
pull_request:
workflow_call:
workflow_dispatch:
jobs:
build-python-docs:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.10'
- name: Install Dependencies
run: |
python -m pip install --upgrade pip
pip install sphinx
pip install -r requirements.txt
- name: Build HTML
run: make html
working-directory: Directory_Name/docs/python
- name: Build LaTeX
run: make latex
working-directory: Directory_Name/docs/python
- name: Upload HTML
uses: actions/upload-artifact@v3
with:
name: python-html-docs
path: Directory_Name/docs/python/_build/html
- name: Upload LaTeX
uses: actions/upload-artifact@v3
with:
name: python-pdf-docs
path: Directory_Name/docs/python/_build/latex`
I've tried solutions for similar issues but none of the solutions have worked for me. This is my first time using GitHub actions so I'm not sure if I'm going wrong somewhere or if there's something I've missed, but would appreciate any feedback or suggestions.
您似乎面临着 GitHub Actions 的经典路径问题。您的错误消息表明该操作找不到工作流程中指定的目录。
首先,仔细检查工作流程中的
working-directory
路径,确保其与 GitHub 存储库中的目录结构完全匹配。如果存在拼写错误或文件夹结构不符合预期,通常会出现此错误。
由于它在本地与
nektos/act
配合使用,因此您的本地设置和 GitHub 运行器环境之间可能存在差异。这里有一个小提示:您可以尝试在 make html
命令之前添加一个步骤来列出目录,这可能会帮助您发现任何差异:
- name: List directories
run: ls -al
working-directory: Directory_Name/docs/python
此命令将显示该位置的所有文件和目录,以便您可以验证路径是否符合预期。