Search code examples
jekyllgithub-pages

Github Pages - A file was included is a symlink or does not exist

I'm having a problem to build my site on GitHub Pages. I'm receiving the following message:

Your page is having problems building: A file was included in docs/samples/widgets/custom_services.html that is a symlink or does not exist in your _includes directory.

All the files can be viewed at https://github.com/igrejaadventista/iasd-bootstrap/tree/master/docs

The files that are included do exist and are not symlink. Locally I dont have any problem building the pages or viewing them on the browser.

Any suggestions about what is going on?

Solution

  • It looks like you're using a custom source. You're not allowed to use custom sources in your Jekyll sites on GitHub Pages. They override it to your repo's top directory. So it's looking for ./_includes/... rather than ./docs/_includes.