Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Error: Couldn't find a Table of Contents file. #2078

Open
pinshuai opened this issue Nov 29, 2023 · 5 comments
Open

Error: Couldn't find a Table of Contents file. #2078

pinshuai opened this issue Nov 29, 2023 · 5 comments
Labels
bug Something isn't working

Comments

@pinshuai
Copy link

pinshuai commented Nov 29, 2023

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:

image

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
@pinshuai pinshuai added the bug Something isn't working label Nov 29, 2023
Copy link

welcome bot commented Nov 29, 2023

Thanks for opening your first issue here! Engagement like this is essential for open source projects! 🤗

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! 🎉

@pinshuai
Copy link
Author

Updates: manual build works, but not with the GitHub Action workflow.

jb build .
ghp-import -n -p -f ./_build/html

@agoose77
Copy link
Collaborator

This was caused by a recent bug in our cookiecutter, fixed by executablebooks/cookiecutter-jupyter-book#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?

@pinshuai
Copy link
Author

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

@agoose77
Copy link
Collaborator

agoose77 commented Dec 19, 2023

It looks like GitHub might be experiencing an outage. Let's try again once https://githubstatus.com is all green.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

No branches or pull requests

2 participants