PageRef 页面引用

The use case for this method is rare. 这种方法的用例很少见。

In almost also scenarios you should use the URL method instead. 在几乎所有情况下，您都应该使用该URL方法。

Explanation #

If you specify a pageRef property when [defining a menu entry] in your site configuration, Hugo looks for a matching page when rendering the entry.

If a matching page is found:

• The URL method returns the page’s relative permalink
• The Page method returns the corresponding Page object
• The HasMenuCurrent and IsMenuCurrent methods on a Page object return the expected values

If a matching page is not found:

• The URL method returns the entry’s url property if set, else an empty string
• The Page method returns nil
• The HasMenuCurrent and IsMenuCurrent methods on a Page object return false

Example #

This example is contrived.

Consider this content structure:

content/
├── products.md
└── _index.md

And this menu definition:

menus:
  main:
  - name: Products
    pageRef: /products
    weight: 10
  - name: Services
    pageRef: /services
    weight: 20

[menus]
[[menus.main]]
    name = 'Products'
    pageRef = '/products'
    weight = 10
[[menus.main]]
    name = 'Services'
    pageRef = '/services'
    weight = 20

{
   "menus": {
      "main": [
         {
            "name": "Products",
            "pageRef": "/products",
            "weight": 10
         },
         {
            "name": "Services",
            "pageRef": "/services",
            "weight": 20
         }
      ]
   }
}

With this template code:

<ul>
  {{ range .Site.Menus.main }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo render this HTML:

<ul>
  <li><a href="/products/">Products</a></li>
  <li><a href="">Services</a></li>
</ul>

In the above note that the href attribute of the second anchor element is blank because Hugo was unable to find the “services” page.

With this template code:

<ul>
  {{ range .Site.Menus.main }}
    <li><a href="{{ or .URL .PageRef }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo renders this HTML:

<ul>
  <li><a href="/products/">Products</a></li>
  <li><a href="/services">Services</a></li>
</ul>

In the above note that Hugo populates the href attribute of the second anchor element with the pageRef property as defined in the site configuration because the template code falls back to the PageRef method.