Wowchemy-hugo-modules: GitHub Pages Deployment Failure

[xorz57]

There seems to be an error somewhere. I can't deploy my website on GitHub Pages.

Here is my repository: https://github.com/xorz57/xorz57.github.io

• Netlify (SUCCESS): https://xorz57.netlify.com/
• GitHub (FAILURE): https://xorz57.github.io/

[xorz57]

This issue could probably be renamed to "Syntax Error in Examples"

[gcushen]

This is a bug with Github attempting to parse a Hugo repository as a Jekyll site. It's not directly related to Academic since Academic is host-agnostic. As per the docs, we recommend Netlify for hosting. Github Pages can work with Hugo sites, but it can be more problematic and requires extra effort to get running.

The primary purpose of the exampleSite folder is to power the example site, which is running online without any issues.

Having said that, someone contributed a workaround for the Github bug in PR #917 but then they closed the PR for an unknown reason. If anyone can verify if his workaround works, we'll consider adding it...

[xorz57]

@gcushen OK thanks for the clear answer! But I think it should be noted in the guides that deploying with github pages is not recommended. I just thaught it was going to work just as fine.

[xorz57]

@gcushen I will test his workaround sometime and I will probably open a PR.

[bitsandscraps]

@xorz57 Following this guide worked for me.

[xorz57]

@bitsandscraps I ended up using netlify. Thanks anyway!