ripple / dactyl

Tools to make enterprise documentation from Markdown sources.
MIT License
69 stars 34 forks source link

Feature request: make .html extension optional on generated files #42

Closed ryangyoung closed 4 years ago

ryangyoung commented 5 years ago

People have noted that the .html extension on xrpl.org pages gives the impression that we are somewhat behind the times. Other comparable sites don't use such extensions and thus their use may reflect poorly on sites powered by Dactyl.

Here are some of the competitive examples:

iroskam commented 5 years ago

This is typically achieved by rewrite rules on the server.

mDuo13 commented 5 years ago

What iroskam said. Also, you can, if you need, use whatever output file names you want, but you might end up having to worry about the MIME types / content types being wrong if you don't have correct file extensions.

mDuo13 commented 4 years ago

An alternative option that may help with this is to improve built-in Dactyl support for using such rules with a Dactyl-generated site.

For example, a built-in server (#47) could optionally support it, and a Dactyl starter kit could come with suggested rewrite rules to apply to your webserver for the same purposes.

The Dactyl link checker could also use some improvements to better handle absolute links and links with the .html suffix dropped on the web-server side.

mDuo13 commented 4 years ago

Fixed in v0.10.0