How to remove .html extension from page urls (gh-pages)?

[MarkParker5]

How to remove .html extension from links? I published docs https://stark.markparker.me (repo https://github.com/MarkParker5/STARK) using gh pages and all my links have .html at the end. If I type the url without .html, it still works, but a tags have .html in href.

[alexvoss]

I don't have experience with gh-pages but the compilation of the pages is controlled by the use_directory_urls option in MkDocs. When I build your documentation it produced HTML files instead of directories with index.html files in them. However, I cannot see you using use_directory_urls in your mkdocs.yml. Odd, the defailt is true according to the MkDocs documentation and that works for me with my sites.

[alexvoss]

Ok, you are using the Offline Plugin, which explains the behavior: "Additionally, the plugin automatically disables the use_directory_urls setting, ensuring that users can open your documentation directly from the local file system." As far as I can see, you can either have offline use or URLs without the .html extension.

[squidfunk]

Correct! The offline plugin is intended for distributing your documentation as a downloadable .zip file, which you can view from the local file system without the use of a server. For this to work, the .html extension is mandatory. You should not use the plugin when you deploy your documentation.

[alexvoss]

You should be able to enable/disable the plugin using an environment variable as described here.

[MarkParker5]

Yes that's it! Thank you!