mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
230a495941
93f7baf80 netlify: Hugo 0.92.2 ecd8a6b6b Merge branch 'tempv0.92.2' ee04caf9f Fix validation of Page Kind in cascade target map 3fce03ed2 Remove the "check" command 70ad71b25 Fix typo (#1651) dfd1dc570 Fix internal link (#1650) b5e0e0d38 Update rotten Fedora package link 78276390a Add missing word in types.md (#1645) 45eb945f8 Remove hugo gen autocomplete 2f84d0896 netlify: Hugo 0.92.1 b55f5773b Update complement.md 7013ee43e Remove deprecated RSSLink from page variables 1c3fb6ed3 Remove deprecated page vars (#1638) 9bd0af3ab Update union.md 4576487a0 Update symdiff.md 58f1b26c7 Update starter-kits.md (#1521) 285356c1d Move inline partials section (#1635) 4d08625d2 Improve directions for editing Win 10 path env var (#1632) 41d9c7804 Update page content (#1629) d05536cad Removed unpaired quote character (#1630) 3b0fdcd88 netlify: Bump to Hugo 0.92.0 cdb068346 docs: Regenerate docshelper 778503ca8 Merge commit 'a8e9fc699a6ff7d578f97a7c553ce844efad8fdb' 2d2401c91 docs: Add dependency table to maintainance page 6bc95c386 Add hugo.Deps 19d0b5e23 docs. Regen CLI docs 76a750d96 docs: Regenerate CLI docs 70156962a docs: Regenerate docshelper git-subtree-dir: docs git-subtree-split: 93f7baf80bd03176ad44701cd2452433d492ea0b
116 lines
No EOL
3 KiB
Markdown
116 lines
No EOL
3 KiB
Markdown
---
|
|
title: hugo
|
|
linktitle: hugo
|
|
description: The `hugo` function provides easy access to Hugo-related data.
|
|
date: 2019-01-31
|
|
publishdate: 2019-01-31
|
|
lastmod: 2019-01-31
|
|
keywords: []
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: "functions"
|
|
toc:
|
|
signature: ["hugo"]
|
|
workson: []
|
|
hugoversion:
|
|
relatedfuncs: []
|
|
deprecated: false
|
|
draft: false
|
|
aliases: []
|
|
---
|
|
|
|
`hugo` returns an instance that contains the following functions:
|
|
|
|
hugo.Generator
|
|
: `<meta>` tag for the version of Hugo that generated the site. `hugo.Generator` outputs a *complete* HTML tag; e.g. `<meta name="generator" content="Hugo 0.63.2" />`
|
|
|
|
hugo.Version
|
|
: the current version of the Hugo binary you are using e.g. `0.63.2`
|
|
|
|
|
|
`hugo` returns an instance that contains the following functions:
|
|
|
|
hugo.Environment
|
|
: the current running environment as defined through the `--environment` cli tag
|
|
|
|
hugo.CommitHash
|
|
: the git commit hash of the current Hugo binary e.g. `0e8bed9ccffba0df554728b46c5bbf6d78ae5247`
|
|
|
|
hugo.BuildDate
|
|
: the compile date of the current Hugo binary formatted with RFC 3339 e.g. `2002-10-02T10:00:00-05:00`
|
|
|
|
hugo.IsExtended {{< new-in "0.83.0" >}}
|
|
: whether this is the extended Hugo binary.
|
|
|
|
hugo.IsProduction
|
|
: returns true if `hugo.Environment` is set to the production environment
|
|
|
|
{{% note "Use the Hugo Generator Tag" %}}
|
|
We highly recommend using `hugo.Generator` in your website's `<head>`. `hugo.Generator` is included by default in all themes hosted on [themes.gohugo.io](https://themes.gohugo.io). The generator tag allows the Hugo team to track the usage and popularity of Hugo.
|
|
{{% /note %}}
|
|
|
|
hugo.Deps
|
|
: See [hugo.Deps](#hugodeps)
|
|
|
|
|
|
## hugo.Deps
|
|
|
|
{{< new-in "0.92.0" >}}
|
|
|
|
`hugo.Deps` returns a list of dependencies for a project (either Hugo Modules or local theme components).
|
|
|
|
Eeach dependency contains:
|
|
|
|
Path (string)
|
|
: Returns the path to this module. This will either be the module path, e.g. "github.com/gohugoio/myshortcodes", or the path below your /theme folder, e.g. "mytheme".
|
|
|
|
Version (string)
|
|
: The module version.
|
|
|
|
Vendor (bool)
|
|
: Whether this dependency is vendored.
|
|
|
|
Time (time.Time)
|
|
: Time version was created.
|
|
|
|
Owner
|
|
: In the dependency tree, this is the first module that defines this module as a dependency.
|
|
|
|
Replace (*Dependency)
|
|
: Replaced by this dependency.
|
|
|
|
An example table listing the dependencies:
|
|
|
|
```html
|
|
<h2>Dependencies</h2>
|
|
<table class="table table-dark">
|
|
<thead>
|
|
<tr>
|
|
<th scope="col">#</th>
|
|
<th scope="col">Owner</th>
|
|
<th scope="col">Path</th>
|
|
<th scope="col">Version</th>
|
|
<th scope="col">Time</th>
|
|
<th scope="col">Vendor</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
{{ range $index, $element := hugo.Deps }}
|
|
<tr>
|
|
<th scope="row">{{ add $index 1 }}</th>
|
|
<td>{{ with $element.Owner }}{{.Path }}{{ end }}</td>
|
|
<td>
|
|
{{ $element.Path }}
|
|
{{ with $element.Replace}}
|
|
=> {{ .Path }}
|
|
{{ end }}
|
|
</td>
|
|
<td>{{ $element.Version }}</td>
|
|
<td>{{ with $element.Time }}{{ . }}{{ end }}</td>
|
|
<td>{{ $element.Vendor }}</td>
|
|
</tr>
|
|
{{ end }}
|
|
</tbody>
|
|
</table>
|
|
``` |