d2l-book icon indicating copy to clipboard operation
d2l-book copied to clipboard

Missing important step in github pages deployment

Open mohamed-ali opened this issue 3 years ago • 0 comments

When deploying the generated html to github, it will be treated as a jekyll website thus the content won't be rendering correctly. Namely, in this case, the html pages won't be able to load static files like css and images which leads to having a broken page.

A quick fix is to add an empty file named .nojekyll to the root of the html folder.

Since this is essential to have correct display, we can:

  • Automatically add this file .nojekyll when d2lbook deploy html is run
  • Or instruct the user to add in the documentation.

Here's an example deployment I did on github with the above tip

  • https://github.com/mohamed-ali/d2l-ar-demo
  • https://mohamed-ali.github.io/d2l-ar-demo/

mohamed-ali avatar Dec 29 '20 18:12 mohamed-ali