home chevron_right
Pretty URLs

Pretty URLslink

By default, any Blade files not named index.blade.php are rendered as index.html in a subfolder named after the original file.

For example, if you have a file named about-us.blade.php in your /source directory:

chevron_rightfolder
source
docs
about-us.blade.php
docs
blog.blade.php
docs
index.blade.php
folder
_assets
folder
_layout
folder
assets

It will be rendered as index.html in the /build/about-us directory:

chevron_rightfolder
build_*
docs
index.html
chevron_rightfolder
about-us
docs
index.html
chevron_rightfolder
blog
docs
index.html

This means your "About us" page will be available at http://example.com/about-us/ instead of http://example.com/about-us.html.

Disabling Pretty URLslink

To disable this behavior, set the pretty option to false in your config file:

return [
'pretty' => false,
];

Note: the current Docara stubs and navigation logic assume pretty is true. Switching it off can break links and menu generation unless you adjust paths accordingly.