![Bjørn Erik Pedersen](/assets/img/avatar_default.png)
3b1a8579d Update theme b1f04fd47 params: Adjust the twitter handle 2c8ba029f Fix typo 4421e46ec Update Where.md 5f9fec6a5 Update glossary.md fb16945cf collections.Where - Clarify description of "collection" 4d6d7018b Update Include.md - improve return statement example 037151073 Update IncludeCached - improve return statement example b053fa09c Improve return types f7d615267 Describe minimum required Windows version e97762b2a Update front matter in math.Sub 9e4d03a79 Fix data.GetJSON examples 9029ee123 Update spellcheck GitHub Action c852fe421 Add version verification step to quick start guide 8fafca49c Correct front matter example b412fdf65 Fix closing tag in notes docs 9a64d9579 Add hreflang Tag to Translation Link example 2d2a82101 Fix inverted examples in Permalink and RelPermalink ff3e67e3f Correct spelling 3904b72e3 Fix documentation contribution steps enumeration 348fd3c02 Fix some typos in the content summaries page a5823459a Fix two links, one to bonsai.io and one to digital.gov c36978686 Fix typo 0ee3ff44f Vendor theme 6b0a9b75d Fix typo 44e4cb5c6 Fix typos 815071742 Update min Go version to build from source 192d14df5 Fix typo e4a18946e Miscellaneous corrections f12b7b74e netlify: Hugo 0.121.2 97dbc1ea1 Merge branch 'tempv0.121.2' dc1c0aeeb Add cache note to resources.Concat a8d1a6020 Correct return type eca22e97c Fix front matter 7de247a03 Correct return type 5058bc520 collections.Seq: Specify max slice size e24d81a4b Fix typo on FAQ page ff8cf5a88 Correct 'related' front matter values 88b21fae0 Adjust deprecation handling f7e19a25b Update terminology on shortcode templates page 01e10942a Adjust formatting 6ed2e19c2 tpl/math: Add math.Rand template function b494a8d8d Update js.md 6d78035f4 Add interval description to glossary (#2378) f9b612b64 Templates Lookup Order: Add missing parenthesis 741ab1bb2 Show vendorClosest in module default config eb8cb878f Fix Babel headings cdcdfc8e8 Change project name in Codeowners example f31fe0d63 Update link to image filters 9dee1ee0e Update Solus installation instructions 716636fee Add TOC to collections.Sort f7c64143c Update collections.Sort 4b8f6b991 Add id attributes to Scratch and Store methods 2a1adea79 Add id attributes to GitInfo, File, and Resources methods b12d9cb8f Add Alpine Linux installation instructions dfbebeec7 Change writeStats to buildStats 175b8aac8 resources/images: Create AutoOrient image filter ba8e05c31 Update img shortcode 7fc15a6cc Fix default value of pluralizeListTitles a0be4fd8a Add Comentario to available comment engines 71aa7d8ab Update GitInfo.md 348441491 EXIF: describe applicable image types 743497eda Disable TOC for lang.Translate b3b1df75d Describe lang.Translate fallback behavior a6d9c362c Categorize CLI commands to improve search results 08cc2da4b Document canonical config for enabling inline shortcodes 8945be9c6 Update description of the humanize ordinal conversion b8b4ccb6f Fix grammatical error f53f9f936 Fix description of strings.HasSuffix cdbe19b5b Update Params.md e00c4eea2 Reformat site config descriptions 6f50c0755 Enumerate root configuration keys 1f2e7b9b2 Use canonical key when documenting menu configs 7d5a13d8d Update images.Text filter 315d2f8c3 Add math.Counter example to warnf 8ed9cdaa9 Miscellaneous edits 2bda491eb Fix front matter example 5c5bbbe3a netlify: Bump to Hugo 0.121.1 ed08f5943 Update Gentoo installation instructions e4eb48457 Miscellaneous edits 8c3700d12 netlify: Bump to Hugo 0.121.0 1bb5a377f Merge branch 'tempv0.121.0' 8cba89504 Improve where function 0dfc00b0f docs: Regen docshelper 028076a66 Fix link to Gentoo package 52d2db4ff Fix typo 120025c19 Improve Gentooo installation instructions 0c31a4b45 Update GitHub hosting workflow example dee99c36a Defend against missing aliases in quick-reference shortcode d305278f1 Add Gentoo installation instructions be98a37e1 docs: Adjust last merge from docs repository a703dab53 docs: Regen docs helper 2e9c3532f Merge commit '35dec7c96f7ee3eb17dd444f7067f0c776fb56ae' f57fdb44b deps: Update github.com/tdewolff/minify/v2 v2.20.7 => v2.20.8 50cad5e38 tpl/transform: Add transform.XMLEscape template function git-subtree-dir: docs git-subtree-split: 3b1a8579d2e032c1aab8a74d4cf63849ba11e7a8
4.6 KiB
title | description | categories | keywords | menu | weight | toc | aliases | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Performance | Use template metrics and timers to identify opportunities to improve performance. |
|
|
60 | true |
|
Template metrics
Hugo is fast, but inefficient templates impede performance. Enable template metrics to determine which templates take the most time, and to identify caching opportunities:
hugo --templateMetrics --templateMetricsHints
The result will look something like this:
Template Metrics:
cumulative average maximum cache percent cached total
duration duration duration potential cached count count template
---------- -------- -------- --------- ------- ------ ----- --------
36.037476822s 135.990478ms 225.765245ms 11 0 0 265 partials/head.html
35.920040902s 164.018451ms 233.475072ms 0 0 0 219 articles/single.html
34.163268129s 128.917992ms 224.816751ms 23 0 0 265 partials/head/meta/opengraph.html
1.041227437s 3.92916ms 186.303376ms 47 0 0 265 partials/head/meta/schema.html
805.628827ms 27.780304ms 114.678523ms 0 0 0 29 _default/list.html
624.08354ms 15.221549ms 108.420729ms 8 0 0 41 partials/utilities/render-page-collection.html
545.968801ms 775.523µs 105.045775ms 0 0 0 704 _default/summary.html
334.680981ms 1.262947ms 127.412027ms 100 0 0 265 partials/head/js.html
272.763205ms 2.050851ms 24.371757ms 0 0 0 133 _default/_markup/render-codeblock.html
230.490038ms 8.865001ms 177.4615ms 0 0 0 26 shortcodes/template.html
176.921913ms 176.921913ms 176.921913ms 0 0 0 1 examples.tmpl
163.951469ms 14.904679ms 70.267953ms 0 0 0 11 articles/list.html
153.07021ms 577.623µs 73.593597ms 100 0 0 265 partials/head/init.html
150.910984ms 150.910984ms 150.910984ms 0 0 0 1 _default/single.html
146.785804ms 146.785804ms 146.785804ms 0 0 0 1 _default/contact.html
115.364617ms 115.364617ms 115.364617ms 0 0 0 1 authors/term.html
87.392071ms 329.781µs 10.687132ms 100 0 0 265 partials/head/css.html
86.803122ms 86.803122ms 86.803122ms 0 0 0 1 _default/home.html
From left to right, the columns represent:
- cumulative duration
- The cumulative time spent executing the template.
- average duration
- The average time spent executing the template.
- maximum duration
- The maximum time spent executing the template.
- cache potential
- Displayed as a percentage, any partial template with a 100% cache potential should be called with the
partialCached
function instead of thepartial
function. See the caching section below. - percent cached
- The number of times the rendered templated was cached divided by the number of times the template was executed.
- cached count
- The number of times the rendered templated was cached.
- total count
- The number of times the template was executed.
- template
- The path to the template, relative to the layouts directory.
{{% note %}} Hugo builds pages in parallel where multiple pages are generated simultaneously. Because of this parallelism, the sum of "cumulative duration" values is usually greater than the actual time it takes to build a site. {{% /note %}}
Caching
Some partial templates such as sidebars or menus are executed many times during a site build. Depending on the content within the partial template and the desired output, the template may benefit from caching to reduce the number of executions. The partialCached
template function provides caching capabilities for partial templates.
{{% note %}}
Note that you can create cached variants of each partial by passing additional parameters to partialCached
beyond the initial context. See the partialCached
documentation for more details.
{{% /note %}}
Timers
Use the debug.Timer
function to determine execution time for a block of code, useful for finding performance bottle necks in templates. See details.