search

quarto-dev / quarto-cli

Open-source scientific and technical publishing system built on Pandoc.
https://quarto.org
Other
3.88k stars 318 forks source link

Quarto should output websites with "pretty" URLs #2065

Open sellorm opened 2 years ago

sellorm commented 2 years ago

When using quarto to build websites, some static site generators, for instance mkdocs, create sites with "pretty" URLs by default. It would be great if Quarto also did this.

For instance, in a project containing the file science.md, quarto render will generate that as science.html, resulting in a URL like, https://example.com/science.html. In contrast, mkdocs build would generate it as science/index.html, meaning that, when published, it could be accessed at https://example.com/science/.

The current workaround would be to create the original file at science/index.md, in which case, both quarto and mkdocs would generate the same HTML in the same places.

This is important for sites that might be considering migrating to quarto that are not currently structured along the lines of the workaround.

eitsupi commented 2 years ago

I believe this can be worked around by simply setting an alias. (No need to rename the file) https://quarto.org/docs/websites/website-navigation.html#redirects

---
title: science
aliases:
  - /science/
---