hugo/docs/content/extras/urls.md

---
aliases:
- /doc/urls/
date: 2014-01-03
menu:
  main:
    parent: extras
next: /community/mailing-list
notoc: true
prev: /extras/toc
title: URLs
weight: 110
---

## Pretty URLs

By default Hugo will create content with 'pretty' URLs. For example
content created at /content/extras/urls.md will be rendered at
/content/extras/urls/index.html and accessible at /content/extras/urls. No
no standard server side configuration is required for these pretty urls to
work.

If you would like to have ugly URLs, you are in luck. Hugo supports the
ability to create your entire site with ugly URLs. Simply use the
`--uglyUrls=true` flag on the command line.

If you want a specific piece of content to have an exact URL, you can
specify this in the front matter under the url key. See [Content
Organization](/content/organization/) for more details. 

## Canonicalization

By default, all relative URLs encountered in the input will be canonicalized
using `baseurl`, so that a link `/css/foo.css` becomes
`http://yoursite.example.com/css/foo.css`.

Setting `canonifyurls` to `false` will prevent this canonicalization.

Benefits of canonicalization include fixing all URLs to be absolute, which may
aid with some parsing tasks.  Note though that all real browsers handle this
client-side without issues.

Benefits of non-canonicalization include being able to have resource inclusion
be scheme-relative, so that http vs https can be decided based on how this
page was retrieved.
Add `canonifyurls` config option. Be able to inhibit AbsURL canonicalization of content, on a site configuration basis. Advantages of being able to inhibit this include making it easier to rendering on other hostnames, and being able to include resources on http or https depending on how this page was retrieved, avoiding mixed-mode client complaints without adding latency for plain http. 2014-01-03 18:36:53 -05:00			`---`
			`aliases:`
Converting front matter to YAML 2014-05-29 18:42:05 -04:00			`- /doc/urls/`
			`date: 2014-01-03`
Implementing new menu system in the docs site 2014-04-23 03:00:11 -04:00			`menu:`
			`main:`
Converting front matter to YAML 2014-05-29 18:42:05 -04:00			`parent: extras`
			`next: /community/mailing-list`
			`notoc: true`
			`prev: /extras/toc`
			`title: URLs`
Documentation for `ref` and `relref`. - Rejigged the weight of the extras/ content for the new crossreferences page. - Used the new {{</…/>}} format for documenting highlighting and to prevent a warning about the missing `fig` shortcode. 2014-11-25 03:07:18 -05:00			`weight: 110`
Add `canonifyurls` config option. Be able to inhibit AbsURL canonicalization of content, on a site configuration basis. Advantages of being able to inhibit this include making it easier to rendering on other hostnames, and being able to include resources on http or https depending on how this page was retrieved, avoiding mixed-mode client complaints without adding latency for plain http. 2014-01-03 18:36:53 -05:00			`---`
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00
Minor proofreading corrections to Hugo docs 2014-08-31 07:08:36 -04:00			`## Pretty URLs`
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00
Minor proofreading corrections to Hugo docs 2014-08-31 07:08:36 -04:00			`By default Hugo will create content with 'pretty' URLs. For example`
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00			`content created at /content/extras/urls.md will be rendered at`
			`/content/extras/urls/index.html and accessible at /content/extras/urls. No`
			`no standard server side configuration is required for these pretty urls to`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`work.`
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00
Minor proofreading corrections to Hugo docs 2014-08-31 07:08:36 -04:00			`If you would like to have ugly URLs, you are in luck. Hugo supports the`
			`ability to create your entire site with ugly URLs. Simply use the`
Update urls.md Corrected the --uglyUrls flag, wouldn't work if lowercase. 2014-09-17 15:59:18 -04:00			`--uglyUrls=true` flag on the command line.
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00
Minor proofreading corrections to Hugo docs 2014-08-31 07:08:36 -04:00			`If you want a specific piece of content to have an exact URL, you can`
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00			`specify this in the front matter under the url key. See [Content`
Fixing broken link. Fixed #278. 2014-05-09 11:32:06 -04:00			`Organization](/content/organization/) for more details.`
Adding documentation on Pretty Urls 2014-02-20 19:04:29 -05:00
			`## Canonicalization`

Add `canonifyurls` config option. Be able to inhibit AbsURL canonicalization of content, on a site configuration basis. Advantages of being able to inhibit this include making it easier to rendering on other hostnames, and being able to include resources on http or https depending on how this page was retrieved, avoiding mixed-mode client complaints without adding latency for plain http. 2014-01-03 18:36:53 -05:00			`By default, all relative URLs encountered in the input will be canonicalized`
			using `baseurl`, so that a link `/css/foo.css` becomes
			`http://yoursite.example.com/css/foo.css`.

			Setting `canonifyurls` to `false` will prevent this canonicalization.

			`Benefits of canonicalization include fixing all URLs to be absolute, which may`
			`aid with some parsing tasks. Note though that all real browsers handle this`
			`client-side without issues.`

			`Benefits of non-canonicalization include being able to have resource inclusion`
			`be scheme-relative, so that http vs https can be decided based on how this`
			`page was retrieved.`