Github.io pages not linking through properly #22720
-
I create documentation using Doxygen from my code and it gets loaded into a docs directory of my repositories for online viewing. It all works ok except for one section where the files will not show (Error 404). The same html help files work fine on my local computer where they are generated. An example is https://majicdesigns.github.io/MD_MIDIFile/files.html. Clicking on any of the file names listed on this page results in an error finding the file. Any ideas on what what could be wrong would be gratefully accepted as I have no idea where to start with this. |
Beta Was this translation helpful? Give feedback.
Replies: 2 comments
-
Hello @MajicDesigns, welcome to the GitHub Support Community! I believe the issue is that the file names begin with underscores. It’s actually a conflict with Jekyll. If you’re not using Jekyll to build your GitHub pages, adding a file named .nojekyll to the docs folder should resolve the issue. More info: Bypassing Jekyll on GitHub Pages - The GitHub BlogIt is now possible to completely bypass Jekyll processing on GitHub Pages by creating a file named .nojekyll in the root of your pages repo and pushing it to GitHub. This should only be necessary |
Beta Was this translation helpful? Give feedback.
-
Yes, that fixed the problem. Thanks. |
Beta Was this translation helpful? Give feedback.
Hello @MajicDesigns, welcome to the GitHub Support Community!
I believe the issue is that the file names begin with underscores. It’s actually a conflict with Jekyll. If you’re not using Jekyll to build your GitHub pages, adding a file named .nojekyll to the docs folder should resolve the issue.
More info:
The GitHub Blog – 30 Dec 09Bypassing Jekyll on GitHub Pages - The GitHub Blog
It is now possible to completely bypass Jekyll processing on GitHub Pages by creating a file named .nojekyll in the root of your pages repo and pushing it to GitHub. This should only be necessary