Use LinkTitle consistently in examples

content/en/content-management/multilingual.md

@@ -309,7 +309,7 @@ To create a list of links to translated content, use a template similar to the f
 <ul>
   {{ range .Translations }}
   <li>
-    <a href="{{ .Permalink }}">{{ .Lang }}: {{ .Title }}{{ if .IsPage }} ({{ i18n "wordCount" . }}){{ end }}</a>
+    <a href="{{ .RelPermalink }}">{{ .Lang }}: {{ .LinkTitle }}{{ if .IsPage }} ({{ i18n "wordCount" . }}){{ end }}</a>
   </li>
   {{ end }}
 </ul>
@@ -327,7 +327,7 @@ The above also uses the [`i18n` function][i18func] described in the next section
 {{< code file=layouts/partials/allLanguages.html >}}
 <ul>
 {{ range $.Site.Home.AllTranslations }}
-<li><a href="{{ .Permalink }}">{{ .Language.LanguageName }}</a></li>
+<li><a href="{{ .RelPermalink }}">{{ .Language.LanguageName }}</a></li>
 {{ end }}
 </ul>
 {{< /code >}}

content/en/content-management/related.md

@@ -24,7 +24,7 @@ To list up to 5 related pages (which share the same _date_ or _keyword_ paramete
 <h3>See Also</h3>
 <ul>
  {{ range . }}
- <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+ <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
  {{ end }}
 </ul>
 {{ end }}
@@ -91,7 +91,7 @@ weight      = 80
   <ul>
     {{ range $i, $p := . }}
       <li>
-        <a href="{{ .RelPermalink }}">{{ .Title }}</a>
+        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
         {{ with .HeadingsFiltered }}
           <ul>
             {{ range . }}

content/en/content-management/sections.md

@@ -121,11 +121,11 @@ For example, use the `.Ancestors` method to render breadcrumb navigation.
   <ol>
     {{ range .Ancestors.Reverse }}
       <li>
-        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
       </li>
     {{ end }}
     <li class="active">
-      <a aria-current="page" href="{{ .Permalink }}">{{ .Title }}</a>
+      <a aria-current="page" href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
     </li>
   </ol>
 </nav>

content/en/content-management/shortcodes.md

@@ -171,7 +171,7 @@ To display a highlighted code sample:
 ```text
 {{</* highlight go-html-template */>}}
 {{ range .Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 {{</* /highlight */>}}
 ```
@@ -180,7 +180,7 @@ Rendered:
 
 {{< highlight go-html-template >}}
 {{ range .Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 {{< /highlight >}}
 
@@ -191,7 +191,7 @@ To specify one or more [highlighting options], include a quotation-encapsulated,
 ```text
 {{</* highlight go-html-template "lineNos=inline, lineNoStart=42" */>}}
 {{ range .Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 {{</* /highlight */>}}
 ```
@@ -200,7 +200,7 @@ Rendered:
 
 {{< highlight go-html-template "lineNos=inline, lineNoStart=42" >}}
 {{ range .Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 {{< /highlight >}}
 

content/en/functions/collections/After.md

@@ -46,7 +46,7 @@ You can use `after` in combination with the [`first`] function and Hugo's [power
     <h2>Featured Article</h2>
     {{ range first 1 .Pages.ByPublishDate.Reverse }}
     <header>
-      <h3><a href="{{ .Permalink }}">{{ .Title }}</a></h3>
+      <h3><a href="{{ .RelPermalink }}">{{ .Title }}</a></h3>
     </header>
     <p>{{ .Description }}</p>
   {{ end }}
@@ -56,7 +56,7 @@ You can use `after` in combination with the [`first`] function and Hugo's [power
     {{ range first 3 (after 1 .Pages.ByPublishDate.Reverse) }}
       <section class="recent-article">
         <header>
-          <h3><a href="{{ .Permalink }}">{{ .Title }}</a></h3>
+          <h3><a href="{{ .RelPermalink }}">{{ .Title }}</a></h3>
         </header>
         <p>{{ .Description }}</p>
       </section>

content/en/functions/collections/Append.md

@@ -95,7 +95,7 @@ Although the elements in the examples above are strings, you can use the `append
 {{ with $p }}
   <ul>
     {{ range . }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/functions/collections/Complement.md

@@ -51,7 +51,7 @@ To list everything except blog articles (`blog`) and frequently asked questions
 {{ $blog := where site.RegularPages "Type" "blog" }}
 {{ $faqs := where site.RegularPages "Type" "faqs" }}
 {{ range site.RegularPages | complement $blog $faqs }}
-  <a href="{{ .RelPermalink }}">{{ .Title }}</a>
+  <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
 {{ end }}
 ```
 
@@ -63,7 +63,7 @@ Although the example above demonstrates the `complement` function, you could use
 
 ```go-html-template
 {{ range where site.RegularPages "Type" "not in" (slice "blog" "faqs") }}
-  <a href="{{ .RelPermalink }}">{{ .Title }}</a>
+  <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
 {{ end }}
 ```
 

content/en/functions/collections/Group.md

@@ -24,7 +24,7 @@ aliases: [/functions/group]
   <ul>
     {{ range .Pages }}
       <li>
-        <a href="{{ .Permalink }}">{{ .Title }}</a>
+        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
         <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
       </li>
     {{ end }}

content/en/functions/collections/Sort.md

@@ -117,6 +117,6 @@ In this contrived example, sort the site's regular pages by `.Type` in descendin
 
 ```go-html-template
 {{ range sort site.RegularPages "Type" "desc" }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/functions/global/page.md

@@ -90,7 +90,7 @@ Consider this section template:
 
 ```go-html-template
 {{ range .Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
   {{ .Summary }}
 {{ end }}
 ```

content/en/functions/go-template/block.md

@@ -47,7 +47,7 @@ The typical use is to define a set of root templates that are then customized by
   <h1>{{ .Title }}</h1>
   {{ .Content }}
   {{ range .Pages }}
-    <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+    <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
   {{ end }}
 {{ end }}
 {{< /code >}}

content/en/functions/go-template/range.md

@@ -160,7 +160,7 @@ This template code:
 
 ```go-html-template
 {{ range where site.RegularPages "Type" "articles" }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 

content/en/functions/go-template/template.md

@@ -17,7 +17,7 @@ Use the `template` function to execute [internal templates]. For example:
 
 ```go-html-template
 {{ range (.Paginate .Pages).Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 {{ template "_internal/pagination.html" . }}
 ```

content/en/methods/page/Ancestors.md

@@ -68,11 +68,11 @@ In the example above, notice that Hugo orders the ancestors from closest to furt
   <ol>
     {{ range .Ancestors.Reverse }}
       <li>
-        <a href="{{ .Permalink }}">{{ .LinkTitle }}</a>
+        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
       </li>
     {{ end }}
     <li class="active">
-      <a aria-current="page" href="{{ .Permalink }}">{{ .LinkTitle }}</a>
+      <a aria-current="page" href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
     </li>
   </ol>
 </nav>

content/en/methods/page/Pages.md

@@ -17,7 +17,7 @@ Range through the page collection in your template:
 
 ```go-html-template
 {{ range .Pages.ByTitle }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 
@@ -80,7 +80,7 @@ When used with a `Site` object, the `Pages` method recursively returns all pages
 
 ```go-html-template
 {{ range .Site.Pages.ByTitle }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 

content/en/methods/page/Paginate.md

@@ -26,7 +26,7 @@ You can invoke pagination on the home page template, [`section`] templates, [`ta
 {{ $pages := where .Site.RegularPages "Section" "articles" }}
 {{ $pages = $pages.ByTitle }}
 {{ range (.Paginate $pages 7).Pages }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 {{ template "_internal/pagination.html" . }}
 {{< /code >}}

content/en/methods/page/RegularPages.md

@@ -17,7 +17,7 @@ Range through the page collection in your template:
 
 ```go-html-template
 {{ range .RegularPages.ByTitle }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 
@@ -77,7 +77,7 @@ When used with the `Site` object, the `RegularPages` method recursively returns
 
 ```go-html-template
 {{ range .Site.RegularPages.ByTitle }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 

content/en/methods/page/RegularPagesRecursive.md

@@ -17,7 +17,7 @@ Range through the page collection in your template:
 
 ```go-html-template
 {{ range .RegularPagesRecursive.ByTitle }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 

content/en/methods/page/Type.md

@@ -37,7 +37,7 @@ To list the books, regardless of [section]:
 
 ```go-html-template
 {{ range where .Site.RegularPages.ByTitle "Type" "books" }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 

content/en/methods/pages/ByDate.md

@@ -18,7 +18,7 @@ When sorting by date, the value is determined by your [site configuration], defa
 
 ```go-html-template
 {{ range .Pages.ByDate }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -26,6 +26,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Pages.ByDate.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByExpiryDate.md

@@ -18,7 +18,7 @@ When sorting by expiration date, the value is determined by your [site configura
 
 ```go-html-template
 {{ range .Pages.ByExpiryDate }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -26,6 +26,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Pages.ByExpiryDate.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByLanguage.md

@@ -11,7 +11,7 @@ action:
 
 ```go-html-template
 {{ range .Site.AllPages.ByLanguage }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -19,6 +19,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Site.AllPages.ByLanguage.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByLastmod.md

@@ -18,7 +18,7 @@ When sorting by last modification date, the value is determined by your [site co
 
 ```go-html-template
 {{ range .Pages.ByLastmod }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -26,6 +26,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Pages.ByLastmod.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByLength.md

@@ -11,7 +11,7 @@ action:
 
 ```go-html-template
 {{ range .Pages.ByLength }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -19,6 +19,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Pages.ByLength.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByParam.md

@@ -15,7 +15,7 @@ If the given parameter is not present in front matter, Hugo will use the matchin
 
 ```go-html-template
 {{ range .Pages.ByParam "author" }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -23,7 +23,7 @@ To sort in descending order:
 
 ```go-html-template
 {{ range (.Pages.ByParam "author").Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -31,6 +31,6 @@ If the targeted parameter is nested, access the field using dot notation:
 
 ```go-html-template
 {{ range .Pages.ByParam "author.last_name" }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByPublishDate.md

@@ -18,7 +18,7 @@ When sorting by publish date, the value is determined by your [site configuratio
 
 ```go-html-template
 {{ range .Pages.ByPublishDate }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -26,6 +26,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Pages.ByPublishDate.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/ByWeight.md

@@ -15,7 +15,7 @@ Assign a [weight] to a page using the `weight` field in front matter. The weight
 
 ```go-html-template
 {{ range .Pages.ByWeight }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```
 
@@ -23,6 +23,6 @@ To sort in descending order:
 
 ```go-html-template
 {{ range .Pages.ByWeight.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/GroupBy.md

@@ -16,7 +16,7 @@ action:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -29,7 +29,7 @@ To sort the groups in descending order:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/GroupByDate.md

@@ -31,7 +31,7 @@ To group content by year and month:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -44,7 +44,7 @@ To sort the groups in ascending order:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/GroupByExpiryDate.md

@@ -31,7 +31,7 @@ To group content by year and month:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -44,7 +44,7 @@ To sort the groups in ascending order:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/GroupByLastmod.md

@@ -31,7 +31,7 @@ To group content by year and month:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -44,7 +44,7 @@ To sort the groups in ascending order:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/GroupByParam.md

@@ -16,7 +16,7 @@ action:
   <p>{{ .Key | title }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -29,7 +29,7 @@ To sort the groups in descending order:
   <p>{{ .Key | title }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/GroupByParamDate.md

@@ -28,7 +28,7 @@ To group content by year and month:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -41,7 +41,7 @@ To sort the groups in ascending order:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/GroupByPublishDate.md

@@ -31,7 +31,7 @@ To group content by year and month:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -44,7 +44,7 @@ To sort the groups in ascending order:
   <p>{{ .Key }}</p>
   <ul>
     {{ range .Pages }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/Limit.md

@@ -11,6 +11,6 @@ action:
 
 ```go-html-template
 {{ range .Pages.Limit 3 }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/pages/Related.md

@@ -22,7 +22,7 @@ The argument passed to the `Related` method may be a `Page` or an options map. F
   <p>Related pages:</p>
   <ul>
     {{ range . }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -39,7 +39,7 @@ To pass an options map:
   <p>Related pages:</p>
   <ul>
     {{ range . }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/pages/Reverse.md

@@ -11,6 +11,6 @@ action:
 
 ```go-html-template
 {{ range .Pages.ByDate.Reverse }}
-  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
 {{ end }}
 ```

content/en/methods/site/RegularPages.md

@@ -31,7 +31,7 @@ To change the sort order, use any of the `Pages` [sorting methods]. For example:
 
 ```go-html-template
 {{ range .Site.RegularPages.ByTitle }}
-  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
 {{ end }}
 ```
 

content/en/methods/taxonomy/Alphabetical.md

@@ -48,7 +48,7 @@ With this template:
   <h2><a href="{{ .Page.RelPermalink }}">{{ .Page.LinkTitle }}</a> ({{ .Count }})</h2>
   <ul>
     {{ range .Pages.ByTitle }}
-      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/methods/taxonomy/ByCount.md

@@ -48,7 +48,7 @@ With this template:
   <h2><a href="{{ .Page.RelPermalink }}">{{ .Page.LinkTitle }}</a> ({{ .Count }})</h2>
   <ul>
     {{ range .Pages.ByTitle }}
-      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
     {{ end }}
   </ul>
 {{ end }}

content/en/templates/introduction.md

@@ -596,7 +596,7 @@ Finally, you can pull "magic constants" out of your layouts as well. The followi
   <h1>Recent Posts</h1>
   <ul>
   {{- range first .Site.Params.SidebarRecentLimit .Site.Pages -}}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
   {{- end -}}
   </ul>
 </nav>
@@ -631,7 +631,7 @@ This [partial template][partials] renders future events:
     {{ if gt (.Params.start_date | time.AsTime) now }}
       {{ $startDate := .Params.start_date | time.Format ":date_medium" }}
       <li>
-        <a href="{{ .RelPermalink }}">{{ .Title }}</a> - {{ $startDate }}
+        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a> - {{ $startDate }}
       </li>
     {{ end }}
   {{ end }}
@@ -646,7 +646,7 @@ If you restrict front matter to the TOML format, and omit quotation marks surrou
   {{ range where (where site.RegularPages "Type" "events") "Params.start_date" "gt" now }}
     {{ $startDate := .Params.start_date | time.Format ":date_medium" }}
     <li>
-      <a href="{{ .RelPermalink }}">{{ .Title }}</a> - {{ $startDate }}
+      <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a> - {{ $startDate }}
     </li>
   {{ end }}
 </ul>

content/en/templates/lists/index.md

@@ -100,7 +100,7 @@ You can now access this `_index.md`'s' content in your list template:
       <!-- Ranges through content/posts/*.md -->
       {{ range .Pages }}
         <li>
-          <a href="{{ .Permalink }}">{{ .Date.Format "2006-01-02" }} | {{ .Title }}</a>
+          <a href="{{ .RelPermalink }}">{{ .Date.Format "2006-01-02" }} | {{ .LinkTitle }}</a>
         </li>
       {{ end }}
     </ul>

content/en/templates/single-page-templates.md

@@ -38,29 +38,29 @@ This single page template makes use of Hugo [base templates], the [`.Format` fun
     <div>
       <section>
         <h4 id="date"> {{ .Date.Format "Mon Jan 2, 2006" }} </h4>
-        <h5 id="wordcount"> {{ .WordCount }} Words </h5>
+        <h5 id="wordcount"> {{ .WordCount }} Words</h5>
       </section>
       {{ with .GetTerms "topics" }}
         <ul id="topics">
           {{ range . }}
-            <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+            <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
           {{ end }}
         </ul>
       {{ end }}
       {{ with .GetTerms "tags" }}
         <ul id="tags">
           {{ range . }}
-            <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+            <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
           {{ end }}
         </ul>
       {{ end }}
     </div>
     <div>
       {{ with .PrevInSection }}
-        <a class="previous" href="{{ .Permalink }}"> {{ .Title }}</a>
+        <a class="previous" href="{{ .RelPermalink }}"> {{ .LinkTitle }}</a>
       {{ end }}
       {{ with .NextInSection }}
-        <a class="next" href="{{ .Permalink }}"> {{ .Title }}</a>
+        <a class="next" href="{{ .RelPermalink }}"> {{ .LinkTitle }}</a>
       {{ end }}
     </div>
   </aside>

content/en/templates/taxonomy-templates.md

@@ -108,7 +108,7 @@ If you need to display custom metadata for each taxonomy term, you will need to
 <ul>
   {{ range .Pages }}
     <li>
-      <a href="{{ .Permalink }}">{{ .Title }}</a>
+      <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
       {{ .Params.wikipedia }}
     </li>
   {{ end }}
@@ -194,7 +194,7 @@ To render an unordered list:
   <p>{{ (site.GetPage $taxonomy).LinkTitle }}:</p>
   <ul>
     {{ range . }}
-      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   </ul>
 {{ end }}
@@ -209,7 +209,7 @@ To render a comma-delimited list:
     {{ (site.GetPage $taxonomy).LinkTitle }}:
     {{ range $k, $_ := . -}}
       {{ if $k }}, {{ end }}
-      <a href="{{ .RelPermalink }}">{{ .Title }}</a>
+      <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
     {{- end }}
   </p>
 {{ end }}
@@ -242,7 +242,7 @@ This would be very useful in a sidebar as “featured content”. You could even
       <li>{{ $key }}</li>
       <ul>
         {{ range $taxonomy.Pages }}
-          <li hugo-nav="{{ .RelPermalink }}"><a href="{{ .Permalink }}">{{ .Title }}</a></li>
+          <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
         {{ end }}
       </ul>
     {{ end }}
@@ -277,7 +277,7 @@ This example will list all taxonomies and their terms, as well as all the conten
   {{ range $taxonomy, $terms := site.Taxonomies }}
     <li>
       {{ with site.GetPage $taxonomy }}
-        <a href="{{ .RelPermalink }}">{{ .Title }}</a>
+        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
       {{ end }}
       <ul>
         {{ range $term, $weightedPages := $terms }}
@@ -285,7 +285,7 @@ This example will list all taxonomies and their terms, as well as all the conten
             <a href="{{ .Page.RelPermalink }}">{{ .Page.LinkTitle }}</a>
             <ul>
               {{ range $weightedPages }}
-                <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+                <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
               {{ end }}
             </ul>
           </li>
@@ -305,7 +305,7 @@ Because taxonomies are lists, the [`.GetPage` function][getpage] can be used to
 <ul class="{{ $taxo }}">
   {{ with ($.Site.GetPage (printf "/%s" $taxo)) }}
     {{ range .Pages }}
-      <li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
+      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
     {{ end }}
   {{ end }}
 </ul>

content/en/templates/views.md

@@ -79,12 +79,12 @@ Hugo will pass the entire page object to the following `summary.html` view templ
 {{< code file=layouts/_default/summary.html >}}
 <article class="post">
   <header>
-    <h2><a href='{{ .Permalink }}'> {{ .Title }}</a> </h2>
+    <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
     <div class="post-meta">{{ .Date.Format "Mon, Jan 2, 2006" }} - {{ .FuzzyWordCount }} Words </div>
   </header>
   {{ .Summary }}
   <footer>
-  <a href='{{ .Permalink }}'><nobr>Read more →</nobr></a>
+  <a href='{{ .RelPermalink }}'>Read&nbsp;more&nbsp;&raquo;</a>
   </footer>
 </article>
 {{< /code >}}
@@ -95,7 +95,7 @@ Continuing on the previous example, we can change our render function to use a s
 
 {{< code file=layouts/_default/li.html >}}
 <li>
-  <a href="{{ .Permalink }}">{{ .Title }}</a>
+  <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
   <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
 </li>
 {{< /code >}}