hugo/docs/content/functions/urlize.md
2017-07-21 11:00:08 +02:00

1.9 KiB

title description date publishdate lastmod categories menu godocref signature hugoversion deprecated workson relatedfuncs
urlize Takes a string, sanitizes it for usage in URLs, and converts spaces to hyphens. 2017-02-01 2017-02-01 2017-02-01
functions
docs
parent
functions
urlize INPUT
false

The following examples pull from a content file with the following front matter:

{{< code file="content/blog/greatest-city.md" copy="false">}} +++ title = "The World's Greatest City" location = "Chicago IL" tags = ["pizza","beer","hot dogs"] +++ {{< /code >}}

The following might be used as a partial within a single page template:

{{< code file="layouts/partials/content-header.html" download="content-header.html" >}}

{{.Title}}

{{ with .Params.location }}
{{.}}
{{ end }} {{ with .Params.tags }}
    {{range .}}
  • {{ . }}
  • {{end}}
{{ end }} {{< /code >}}

The preceding partial would then output to the rendered page as follows, assuming the page is being built with Hugo's default pretty URLs.

{{% output file="/blog/greatest-city/index.html" %}}

<header>
    <h1>The World's Greatest City</h1>
    <div><a href="/locations/chicago-il/">Chicago IL</a></div>
    <ul>
        <li>
            <a href="/tags/pizza">pizza</a>
        </li>
        <li>
            <a href="/tags/beer">beer</a>
        </li>
        <li>
            <a href="/tags/hot-dogs">hot dogs</a>
        </li>
    </ul>
</header>

{{% /output %}}