mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
d2b1030060
0fd7b4169 Fix typo: pygmentsUseClasses -> pygmentsUseClassic 9a3e1c19a Clarify that lower weight gets higher precedence 820d8b581 Clarify the true behavior of hrefTargetBlank #blackfriday eb3aa5e46 Fix typo 9aedb9269 Add examples for removing default taxonomies 772a26f84 Fix source link on maintainance 975c215ae Minor edits. 2bdb1a150 Fix invalid iink 991d2e139 Fix misspelling 60af8dfb0 Update eSolia link d7426b76e Release 0.40.3 4977bd9cf Merge branch 'release-0.40.3' 9946f7108 releaser: Prepare repository for 0.41-DEV beef16b01 releaser: Add release notes to /docs for release of 0.40.3 80c51c55a releaser: Bump versions for release of 0.40.3 21e2934c5 rename `taxonomies.html` to `taxonomy.html` 34a02c289 Add release notes from Hugo 0.7 to 0.15 for completeness b593f512e Update related.md 7c2bf528b Fix the "edit this page" link e8fbc163e Add warning about cond ae15a8831 Add link to Markdown Guide e077dfd65 Added documentation for a new migration tool: BlogMl2Hugo 957bfb6a8 Add Talkayrd, a new commenting system, & fix txtpen link 86acea7f8 Tomango showcase 3c2fc32f1 Fix snap classic command in installing.md 9a76f1737 Merge commit '83bef6955e014d40c0f00db9cebe09113154e999' a4b71fb84 Fix typo git-subtree-dir: docs git-subtree-split: 0fd7b416997bf76cd99e3ae2dfae406cb8b6724a
150 lines
4.8 KiB
Markdown
150 lines
4.8 KiB
Markdown
---
|
|
title : "Page Resources"
|
|
description : "Page Resources -- images, other pages, documents etc. -- have page-relative URLs and their own metadata."
|
|
date: 2018-01-24
|
|
categories: ["content management"]
|
|
keywords: [bundle,content,resources]
|
|
weight: 4003
|
|
draft: false
|
|
toc: true
|
|
linktitle: "Page Resources"
|
|
menu:
|
|
docs:
|
|
parent: "content-management"
|
|
weight: 31
|
|
---
|
|
|
|
## Properties
|
|
|
|
ResourceType
|
|
: The main type of the resource. For example, a file of MIME type `image/jpg` has for ResourceType `image`.
|
|
|
|
Name
|
|
: Default value is the filename (relative to the owning page). Can be set in front matter.
|
|
|
|
Title
|
|
: Default blank. Can be set in front matter.
|
|
|
|
Permalink
|
|
: The absolute URL to the resource. Resources of type `page` will have no value.
|
|
|
|
RelPermalink
|
|
: The relative URL to the resource. Resources of type `page` will have no value.
|
|
|
|
## Methods
|
|
ByType
|
|
: Returns the page resources of the given type.
|
|
|
|
```go
|
|
{{ .Resources.ByType "image" }}
|
|
```
|
|
Match
|
|
: Returns all the page resources (as a slice) whose `Name` matches the given Glob pattern ([examples](https://github.com/gobwas/glob/blob/master/readme.md)). The matching is case-insensitive.
|
|
|
|
```go
|
|
{{ .Resources.Match "images/*" }}
|
|
```
|
|
|
|
GetMatch
|
|
: Same as `Match` but will return the first match.
|
|
|
|
### Pattern Matching
|
|
```go
|
|
// Using Match/GetMatch to find this images/sunset.jpg ?
|
|
.Resources.Match "images/sun*" ✅
|
|
.Resources.Match "**/Sunset.jpg" ✅
|
|
.Resources.Match "images/*.jpg" ✅
|
|
.Resources.Match "**.jpg" ✅
|
|
.Resources.Match "*" 🚫
|
|
.Resources.Match "sunset.jpg" 🚫
|
|
.Resources.Match "*sunset.jpg" 🚫
|
|
|
|
```
|
|
|
|
## Page Resources Metadata
|
|
|
|
Page Resources' metadata is managed from their page's front matter with an array/table parameter named `resources`. You can batch assign values using a [wildcards](http://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm).
|
|
|
|
{{% note %}}
|
|
Resources of type `page` get `Title` etc. from their own front matter.
|
|
{{% /note %}}
|
|
|
|
name
|
|
: Sets the value returned in `Name`.
|
|
|
|
{{% warning %}}
|
|
The methods `Match` and `GetMatch` use `Name` to match the resources.
|
|
{{%/ warning %}}
|
|
|
|
title
|
|
: Sets the value returned in `Title`
|
|
|
|
params
|
|
: A map of custom key/values.
|
|
|
|
|
|
### Resources metadata example
|
|
|
|
{{< code-toggle copy="false">}}
|
|
title: Application
|
|
date : 2018-01-25
|
|
resources :
|
|
- src : "images/sunset.jpg"
|
|
name : "header"
|
|
- src : "documents/photo_specs.pdf"
|
|
title : "Photo Specifications"
|
|
params:
|
|
icon : "photo"
|
|
- src : "documents/guide.pdf"
|
|
title : "Instruction Guide"
|
|
- src : "documents/checklist.pdf"
|
|
title : "Document Checklist"
|
|
- src : "documents/payment.docx"
|
|
title : "Proof of Payment"
|
|
- src : "**.pdf"
|
|
name : "pdf-file-:counter"
|
|
params :
|
|
icon : "pdf"
|
|
- src : "**.docx"
|
|
params :
|
|
icon : "word"
|
|
{{</ code-toggle >}}
|
|
|
|
From the example above:
|
|
|
|
- `sunset.jpg` will receive a new `Name` and can now be found with `.GetMatch "header"`.
|
|
- `documents/photo_specs.pdf` will get the `photo` icon.
|
|
- `documents/checklist.pdf`, `documents/guide.pdf` and `documents/payment.docx` will get `Title` as set by `title`.
|
|
- Every `PDF` in the bundle except `documents/photo_specs.pdf` will get the `pdf` icon.
|
|
- All `PDF` files will get a new `Name`. The `name` parameter contains a special placeholder [`:counter`](#the-counter-placeholder-in-name-and-title), so the `Name` will be `pdf-file-1`, `pdf-file-2`, `pdf-file-3`.
|
|
- Every docx in the bundle will receive the `word` icon.
|
|
|
|
{{% warning %}}
|
|
The __order matters__ --- Only the **first set** values of the `title`, `name` and `params`-**keys** will be used. Consecutive parameters will be set only for the ones not already set. For example, in the above example, `.Params.icon` is already first set to `"photo"` in `src = "documents/photo_specs.pdf"`. So that would not get overridden to `"pdf"` by the later set `src = "**.pdf"` rule.
|
|
{{%/ warning %}}
|
|
|
|
### The `:counter` placeholder in `name` and `title`
|
|
|
|
The `:counter` is a special placeholder recognized in `name` and `title` parameters `resources`.
|
|
|
|
The counter starts at 1 the first time they are used in either `name` or `title`.
|
|
|
|
For example, if a bundle has the resources `photo_specs.pdf`, `other_specs.pdf`, `guide.pdf` and `checklist.pdf`, and the front matter has specified the `resources` as:
|
|
|
|
{{< code-toggle copy="false">}}
|
|
[[resources]]
|
|
src = "*specs.pdf"
|
|
title = "Specification #:counter"
|
|
[[resources]]
|
|
src = "**.pdf"
|
|
name = "pdf-file-:counter"
|
|
{{</ code-toggle >}}
|
|
|
|
the `Name` and `Title` will be assigned to the resource files as follows:
|
|
|
|
| Resource file | `Name` | `Title` |
|
|
|-------------------|-------------------|-----------------------|
|
|
| checklist.pdf | `"pdf-file-1.pdf` | `"checklist.pdf"` |
|
|
| guide.pdf | `"pdf-file-2.pdf` | `"guide.pdf"` |
|
|
| other\_specs.pdf | `"pdf-file-3.pdf` | `"Specification #1"` |
|
|
| photo\_specs.pdf | `"pdf-file-4.pdf` | `"Specification #2"` |
|