jupyter-book
jupyter-book copied to clipboard
Error: Couldn't find a Table of Contents file.
Describe the bug
context After creating Jupyter Book using this cookie-cutter template: https://github.com/executablebooks/cookiecutter-jupyter-book, I was able to push the book to Github (https://github.com/hydroaggie/group_handbook) and saw the live document on Github Pages.
Now I am trying to update the book content.
expectation I expected the book to be built without error.
bug
Here's an error message I ran into when I committed the changes and pushed to github:
Reproduce the bug
The steps on how to create my Jupyter Book is published here: https://hydroaggie.github.io/blog/2022/Create-Jupyter-Book/
You can reproduce the error following the steps.
List your environment
Jupyter Book : 0.15.1 External ToC : 0.3.1 MyST-Parser : 0.18.1 MyST-NB : 0.17.2 Sphinx Book Theme : 1.0.1 Jupyter-Cache : 0.6.1 NbClient : 0.5.13
- Python: 3.11.6
- MacOS
Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada:
Updates: manual build works, but not with the GitHub Action workflow.
jb build .
ghp-import -n -p -f ./_build/html
This was caused by a recent bug in our cookiecutter, fixed by https://github.com/executablebooks/cookiecutter-jupyter-book/pull/43
Could you try modifying your .github/workflows/deploy.yml
, replacing
jupyter-book build .
with
jupyter-book build <NAME-OF-YOUR-BOOK>
where <NAME-OF-YOUR-BOOK>
is the name of the book directory in your GitHub repository?
I updated the build command as well as the path as follows:
jupyter-book build group_handbook/.
...
path: "group_handbook/_build/html"
Now I am getting this error:
Run actions/deploy-pages@v2
with:
token: ***
timeout: 600000
error_count: 10
reporting_interval: 5000
artifact_name: github-pages
preview: false
env:
BASE_URL: /group_handbook
pythonLocation: /opt/hostedtoolcache/Python/3.11.7/x64
PKG_CONFIG_PATH: /opt/hostedtoolcache/Python/3.11.7/x64/lib/pkgconfig
Python_ROOT_DIR: /opt/hostedtoolcache/Python/3.11.7/x64
Python[2](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:2)_ROOT_DIR: /opt/hostedtoolcache/Python/[3](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:3).11.7/x6[4](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:4)
Python3_ROOT_DIR: /opt/hostedtoolcache/Python/3.11.7/x64
LD_LIBRARY_PATH: /opt/hostedtoolcache/Python/3.11.7/x64/lib
Artifact exchange URL: https://pipelinesghubeus9.actions.githubusercontent.com/VxuvmlijgMzqzoxWvYhDvJ6FN6I3prDp1KOfGdP8Ee9cF6xNbB/_apis/pipelines/workflows/726832244[5](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:5)/artifacts?api-version=[6](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:6).0-preview
Creating Pages deployment with payload:
{
"artifact_url": "https://pipelinesghubeus9.actions.githubusercontent.com/VxuvmlijgMzqzoxWvYhDvJ6FN6I3prDp1KOfGdP8Ee9cF6xNbB/_apis/pipelines/1/runs/33/artifacts?artifactName=github-pages&%24expand=SignedContent",
"pages_build_version": "6216e99f50b9fd635a2164[7](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:7)b1[8](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:8)e[9](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:9)826ad61ff704",
"oidc_token": "***"
}
Error: Creating Pages deployment failed
Error: HttpError: Invalid environment node id
at /home/runner/work/_actions/actions/deploy-pages/v2/node_modules/@octokit/request/dist-node/index.js:86:1
at processTicksAndRejections (node:internal/process/task_queues:96:5)
at createPagesDeployment (/home/runner/work/_actions/actions/deploy-pages/v2/src/internal/api-client.js:[12](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:12)6:1)
at Deployment.create (/home/runner/work/_actions/actions/deploy-pages/v2/src/internal/deployment.js:80:1)
at main (/home/runner/work/_actions/actions/deploy-pages/v2/src/index.js:30:1)
Error: Error: Failed to create deployment (status: 500) with build version 62[16](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:16)e99f50b9fd635a21647b[18](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:19)e98[26](https://github.com/hydroaggie/group_handbook/actions/runs/7268111794/job/19803333723#step:7:27)ad61ff704. Server error, is githubstatus.com reporting a Pages outage? Please re-run the deployment at a later time.
You can checkout my deploy.yml file here: https://github.com/hydroaggie/group_handbook/blob/main/.github/workflows/deploy.yml
It looks like GitHub might be experiencing an outage. Let's try again once https://githubstatus.com is all green.