From 5bccf8b1933be9236f7ed2829ac9cc1226e8c274 Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Sun, 19 Nov 2023 17:10:15 -0800
Subject: [PATCH] Use LinkTitle consistently in examples

---
 content/en/content-management/multilingual.md    |  4 ++--
 content/en/content-management/related.md         |  4 ++--
 content/en/content-management/sections.md        |  4 ++--
 content/en/content-management/shortcodes.md      |  8 ++++----
 content/en/functions/collections/After.md        |  4 ++--
 content/en/functions/collections/Append.md       |  2 +-
 content/en/functions/collections/Complement.md   |  4 ++--
 content/en/functions/collections/Group.md        |  2 +-
 content/en/functions/collections/Sort.md         |  2 +-
 content/en/functions/global/page.md              |  2 +-
 content/en/functions/go-template/block.md        |  2 +-
 content/en/functions/go-template/range.md        |  2 +-
 content/en/functions/go-template/template.md     |  2 +-
 content/en/methods/page/Ancestors.md             |  4 ++--
 content/en/methods/page/Pages.md                 |  4 ++--
 content/en/methods/page/Paginate.md              |  2 +-
 content/en/methods/page/RegularPages.md          |  4 ++--
 content/en/methods/page/RegularPagesRecursive.md |  2 +-
 content/en/methods/page/Type.md                  |  2 +-
 content/en/methods/pages/ByDate.md               |  4 ++--
 content/en/methods/pages/ByExpiryDate.md         |  4 ++--
 content/en/methods/pages/ByLanguage.md           |  4 ++--
 content/en/methods/pages/ByLastmod.md            |  4 ++--
 content/en/methods/pages/ByLength.md             |  4 ++--
 content/en/methods/pages/ByParam.md              |  6 +++---
 content/en/methods/pages/ByPublishDate.md        |  4 ++--
 content/en/methods/pages/ByWeight.md             |  4 ++--
 content/en/methods/pages/GroupBy.md              |  4 ++--
 content/en/methods/pages/GroupByDate.md          |  4 ++--
 content/en/methods/pages/GroupByExpiryDate.md    |  4 ++--
 content/en/methods/pages/GroupByLastmod.md       |  4 ++--
 content/en/methods/pages/GroupByParam.md         |  4 ++--
 content/en/methods/pages/GroupByParamDate.md     |  4 ++--
 content/en/methods/pages/GroupByPublishDate.md   |  4 ++--
 content/en/methods/pages/Limit.md                |  2 +-
 content/en/methods/pages/Related.md              |  4 ++--
 content/en/methods/pages/Reverse.md              |  2 +-
 content/en/methods/site/RegularPages.md          |  2 +-
 content/en/methods/taxonomy/Alphabetical.md      |  2 +-
 content/en/methods/taxonomy/ByCount.md           |  2 +-
 content/en/templates/introduction.md             |  6 +++---
 content/en/templates/lists/index.md              |  2 +-
 content/en/templates/single-page-templates.md    | 10 +++++-----
 content/en/templates/taxonomy-templates.md       | 14 +++++++-------
 content/en/templates/views.md                    |  6 +++---
 45 files changed, 87 insertions(+), 87 deletions(-)

diff --git a/content/en/content-management/multilingual.md b/content/en/content-management/multilingual.md
index 4fdd3df30..07eecbaaf 100644
--- a/content/en/content-management/multilingual.md
+++ b/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 >}}
diff --git a/content/en/content-management/related.md b/content/en/content-management/related.md
index 526a080f1..9a766e130 100644
--- a/content/en/content-management/related.md
+++ b/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 . }}
diff --git a/content/en/content-management/sections.md b/content/en/content-management/sections.md
index 5d14dadf3..2207513d5 100644
--- a/content/en/content-management/sections.md
+++ b/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>
diff --git a/content/en/content-management/shortcodes.md b/content/en/content-management/shortcodes.md
index 2b19d3c6b..40184c606 100644
--- a/content/en/content-management/shortcodes.md
+++ b/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 >}}
 
diff --git a/content/en/functions/collections/After.md b/content/en/functions/collections/After.md
index 10f304520..0cf25c7dd 100644
--- a/content/en/functions/collections/After.md
+++ b/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>
diff --git a/content/en/functions/collections/Append.md b/content/en/functions/collections/Append.md
index 8e3a94edf..5632dccfb 100644
--- a/content/en/functions/collections/Append.md
+++ b/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 }}
diff --git a/content/en/functions/collections/Complement.md b/content/en/functions/collections/Complement.md
index 773323b38..b2a4b42a4 100644
--- a/content/en/functions/collections/Complement.md
+++ b/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 }}
 ```
 
diff --git a/content/en/functions/collections/Group.md b/content/en/functions/collections/Group.md
index 72d60964a..74aa869df 100644
--- a/content/en/functions/collections/Group.md
+++ b/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 }}
diff --git a/content/en/functions/collections/Sort.md b/content/en/functions/collections/Sort.md
index 9e9ea80ca..6b9ea2c34 100644
--- a/content/en/functions/collections/Sort.md
+++ b/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 }}
 ```
diff --git a/content/en/functions/global/page.md b/content/en/functions/global/page.md
index 758f70d01..850efbee0 100644
--- a/content/en/functions/global/page.md
+++ b/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 }}
 ```
diff --git a/content/en/functions/go-template/block.md b/content/en/functions/go-template/block.md
index bbf83cb62..f8a082037 100644
--- a/content/en/functions/go-template/block.md
+++ b/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 >}}
diff --git a/content/en/functions/go-template/range.md b/content/en/functions/go-template/range.md
index a3c488c04..e8642e50b 100644
--- a/content/en/functions/go-template/range.md
+++ b/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 }}
 ```
 
diff --git a/content/en/functions/go-template/template.md b/content/en/functions/go-template/template.md
index c089010ca..a78ec5c65 100644
--- a/content/en/functions/go-template/template.md
+++ b/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" . }}
 ```
diff --git a/content/en/methods/page/Ancestors.md b/content/en/methods/page/Ancestors.md
index cc0aa0d2b..da5cf2ca3 100644
--- a/content/en/methods/page/Ancestors.md
+++ b/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>
diff --git a/content/en/methods/page/Pages.md b/content/en/methods/page/Pages.md
index 9bd8fc0a7..2f329eeec 100644
--- a/content/en/methods/page/Pages.md
+++ b/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 }}
 ```
 
diff --git a/content/en/methods/page/Paginate.md b/content/en/methods/page/Paginate.md
index 878cae0a5..6b43b99dd 100644
--- a/content/en/methods/page/Paginate.md
+++ b/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 >}}
diff --git a/content/en/methods/page/RegularPages.md b/content/en/methods/page/RegularPages.md
index da433ec80..b0ca7b1e1 100644
--- a/content/en/methods/page/RegularPages.md
+++ b/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 }}
 ```
 
diff --git a/content/en/methods/page/RegularPagesRecursive.md b/content/en/methods/page/RegularPagesRecursive.md
index 5a314cef3..3dac8c85e 100644
--- a/content/en/methods/page/RegularPagesRecursive.md
+++ b/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 }}
 ```
 
diff --git a/content/en/methods/page/Type.md b/content/en/methods/page/Type.md
index d504bc8b8..b7c62372b 100644
--- a/content/en/methods/page/Type.md
+++ b/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 }}
 ```
 
diff --git a/content/en/methods/pages/ByDate.md b/content/en/methods/pages/ByDate.md
index 41d9b7da7..eb4e86535 100644
--- a/content/en/methods/pages/ByDate.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByExpiryDate.md b/content/en/methods/pages/ByExpiryDate.md
index cec8f975c..41753c340 100644
--- a/content/en/methods/pages/ByExpiryDate.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByLanguage.md b/content/en/methods/pages/ByLanguage.md
index 744a8efeb..30d87f954 100644
--- a/content/en/methods/pages/ByLanguage.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByLastmod.md b/content/en/methods/pages/ByLastmod.md
index 3c5a0347f..385093134 100644
--- a/content/en/methods/pages/ByLastmod.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByLength.md b/content/en/methods/pages/ByLength.md
index 7d20d034e..602b548c2 100644
--- a/content/en/methods/pages/ByLength.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByParam.md b/content/en/methods/pages/ByParam.md
index 0fb9b48c0..9a919cc88 100644
--- a/content/en/methods/pages/ByParam.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByPublishDate.md b/content/en/methods/pages/ByPublishDate.md
index b7d026f5f..e622636a2 100644
--- a/content/en/methods/pages/ByPublishDate.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/ByWeight.md b/content/en/methods/pages/ByWeight.md
index 1e4de8e80..4eafee11f 100644
--- a/content/en/methods/pages/ByWeight.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/GroupBy.md b/content/en/methods/pages/GroupBy.md
index e4e905ade..b46a39bdf 100644
--- a/content/en/methods/pages/GroupBy.md
+++ b/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 }}
diff --git a/content/en/methods/pages/GroupByDate.md b/content/en/methods/pages/GroupByDate.md
index aa77f5881..8b5fcd6f1 100644
--- a/content/en/methods/pages/GroupByDate.md
+++ b/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 }}
diff --git a/content/en/methods/pages/GroupByExpiryDate.md b/content/en/methods/pages/GroupByExpiryDate.md
index d398be775..a9b248297 100644
--- a/content/en/methods/pages/GroupByExpiryDate.md
+++ b/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 }}
diff --git a/content/en/methods/pages/GroupByLastmod.md b/content/en/methods/pages/GroupByLastmod.md
index 30f1431f7..877692521 100644
--- a/content/en/methods/pages/GroupByLastmod.md
+++ b/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 }}
diff --git a/content/en/methods/pages/GroupByParam.md b/content/en/methods/pages/GroupByParam.md
index 87570c0a5..9c63ab902 100644
--- a/content/en/methods/pages/GroupByParam.md
+++ b/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 }}
diff --git a/content/en/methods/pages/GroupByParamDate.md b/content/en/methods/pages/GroupByParamDate.md
index 03642fcbe..c7fedbb1a 100644
--- a/content/en/methods/pages/GroupByParamDate.md
+++ b/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 }}
diff --git a/content/en/methods/pages/GroupByPublishDate.md b/content/en/methods/pages/GroupByPublishDate.md
index 9264ecae2..f6603e858 100644
--- a/content/en/methods/pages/GroupByPublishDate.md
+++ b/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 }}
diff --git a/content/en/methods/pages/Limit.md b/content/en/methods/pages/Limit.md
index 0939add9f..bf889fd7e 100644
--- a/content/en/methods/pages/Limit.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/pages/Related.md b/content/en/methods/pages/Related.md
index 1fc6102be..1cee88745 100644
--- a/content/en/methods/pages/Related.md
+++ b/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 }}
diff --git a/content/en/methods/pages/Reverse.md b/content/en/methods/pages/Reverse.md
index b54cf451e..e03e0ea47 100644
--- a/content/en/methods/pages/Reverse.md
+++ b/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 }}
 ```
diff --git a/content/en/methods/site/RegularPages.md b/content/en/methods/site/RegularPages.md
index 744eb8a13..b163ad919 100644
--- a/content/en/methods/site/RegularPages.md
+++ b/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 }}
 ```
 
diff --git a/content/en/methods/taxonomy/Alphabetical.md b/content/en/methods/taxonomy/Alphabetical.md
index 2c07fbef4..7845dbf3d 100644
--- a/content/en/methods/taxonomy/Alphabetical.md
+++ b/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 }}
diff --git a/content/en/methods/taxonomy/ByCount.md b/content/en/methods/taxonomy/ByCount.md
index d0caa7d2c..40f58420a 100644
--- a/content/en/methods/taxonomy/ByCount.md
+++ b/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 }}
diff --git a/content/en/templates/introduction.md b/content/en/templates/introduction.md
index fee9a8ff0..56cabe0ca 100644
--- a/content/en/templates/introduction.md
+++ b/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>
diff --git a/content/en/templates/lists/index.md b/content/en/templates/lists/index.md
index b69babdde..c26174974 100644
--- a/content/en/templates/lists/index.md
+++ b/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>
diff --git a/content/en/templates/single-page-templates.md b/content/en/templates/single-page-templates.md
index ea25ec3cb..cd8a2715c 100644
--- a/content/en/templates/single-page-templates.md
+++ b/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>
diff --git a/content/en/templates/taxonomy-templates.md b/content/en/templates/taxonomy-templates.md
index 539872c75..ff149e940 100644
--- a/content/en/templates/taxonomy-templates.md
+++ b/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>
diff --git a/content/en/templates/views.md b/content/en/templates/views.md
index 6ba1dcc31..e49f1debb 100644
--- a/content/en/templates/views.md
+++ b/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 >}}