statiqdev / Statiq.Docs

A static documentation site generator.
https://statiq.dev/docs
Other
53 stars 8 forks source link

File Casing issue when deploying to GH-Pages #58

Open nils-a opened 1 year ago

nils-a commented 1 year ago

I have a test-project with the docable theme enabled that get's deployed to gh-pages.

However, links to properties in classes return 404-errors. Everything works fine locally (on Windows, that is.) My first analysis points to a casing problem in the links: image

The test-project is available under https://github.com/nils-a/cake-test/ (it's a test of a migration from an existing projects wyam generation/deployment to statiq.) The deployed pages are at https://nils-a.github.io/cake-test/.

One example page, that demonstrates the issue is https://nils-a.github.io/cake-test/api/Cake.SevenZip.Commands/AddCommand/. When clicking any link in the properties or methods section, you'll always end up on a 404-page.

nils-a commented 1 year ago

This is somehow related to the OptimizeFileName-Module. If WebKeys.OptimizeContentFileNames is set to false, files are created in the same casing (i.e. upperCase) as the links.