Jupyter-book: default book doesn't build properly on github - symlink error

Created on 18 Jul 2019  路  4Comments  路  Source: executablebooks/jupyter-book

Following the following commands:

jupyter-book create demo
jupyter-book build demo
git add .
git commit -m "here's a message"
git push

produces the following error from github:

The page build failed for the `master` branch with the following error:

A file was included in `demo/assets/html/search_form.html` that is a symlink or does not exist in your `_includes` directory. For more information, see https://help.github.com/en/articles/page-build-failed-file-is-a-symlink.

For information on troubleshooting Jekyll see:

 https://help.github.com/articles/troubleshooting-jekyll-builds

If you have any questions you can contact us by replying to this email.

Site runs/builds completely fine via Docker locally.

Manually deleting/removing the search functionality seems to produce a SASS error. I will update this issue with more error messages later.

Link to repo with the minimal book: https://github.com/muzny/demobook

bug

Most helpful comment

the _include directory has to be

Following the following commands:

jupyter-book create demo
jupyter-book build demo
git add .
git commit -m "here's a message"
git push

produces the following error from github:

The page build failed for the `master` branch with the following error:

A file was included in `demo/assets/html/search_form.html` that is a symlink or does not exist in your `_includes` directory. For more information, see https://help.github.com/en/articles/page-build-failed-file-is-a-symlink.

For information on troubleshooting Jekyll see:

 https://help.github.com/articles/troubleshooting-jekyll-builds

If you have any questions you can contact us by replying to this email.

Site runs/builds completely fine via Docker locally.

Manually deleting/removing the search functionality seems to produce a SASS error. I will update this issue with more error messages later.

Link to repo with the minimal book: https://github.com/muzny/demobook

@muzny, if you rename the "demo" directory to "docs" and set the gh-pages option on github to build from master/docs it will work

All 4 comments

If you delete assets/html/search_form.html and modify _data/toc.yml correspondingly, a SASS error is produced with the following message. (again, I can 100% run this successfully in a local docker container)

The page build failed for the `master` branch with the following error:

Your SCSS file `demo/assets/css/styles.scss` has an error on line 1: File to import not found or unreadable: main. Load path: /hoosegow/.bundle/ruby/2.5.0/gems/jekyll-theme-primer-0.5.3/_sass. For more information, see https://help.github.com/en/articles/page-build-failed-invalid-sass-or-scss.

huh, that is bizarre that it works locally but not on GitHub...hmm, let's mark this as a bug and follow up on it. Let me know if you figure out a workaround

We're hitting the same problem

the _include directory has to be

Following the following commands:

jupyter-book create demo
jupyter-book build demo
git add .
git commit -m "here's a message"
git push

produces the following error from github:

The page build failed for the `master` branch with the following error:

A file was included in `demo/assets/html/search_form.html` that is a symlink or does not exist in your `_includes` directory. For more information, see https://help.github.com/en/articles/page-build-failed-file-is-a-symlink.

For information on troubleshooting Jekyll see:

 https://help.github.com/articles/troubleshooting-jekyll-builds

If you have any questions you can contact us by replying to this email.

Site runs/builds completely fine via Docker locally.

Manually deleting/removing the search functionality seems to produce a SASS error. I will update this issue with more error messages later.

Link to repo with the minimal book: https://github.com/muzny/demobook

@muzny, if you rename the "demo" directory to "docs" and set the gh-pages option on github to build from master/docs it will work

Was this page helpful?
0 / 5 - 0 ratings

Related issues

sidneymbell picture sidneymbell  路  5Comments

spring-haru picture spring-haru  路  5Comments

firasm picture firasm  路  5Comments

rickwierenga picture rickwierenga  路  3Comments

mmcky picture mmcky  路  5Comments