Merge commit '87de22d7464e239c775fbd48ebce1665d5b1e80d'

This commit is contained in:
Bjørn Erik Pedersen
2023-07-29 11:17:28 +02:00
177 changed files with 1623 additions and 1556 deletions

View File

@@ -1,11 +1,13 @@
---
title: Troubleshoot
linkTitle: Overview
description: Frequently asked questions and known issues pulled from the Hugo Discuss forum.
menu:
docs:
identifier: troubleshooting-overview
parent: troubleshooting
weight: 1
weight: 1
weight: 10
weight: 10
aliases: [/troubleshooting/faqs/,/faqs/]
---

View File

@@ -1,14 +1,15 @@
---
title: Build Performance
title: Build performance
description: An overview of features used for diagnosing and improving performance issues in site builds.
menu:
docs:
parent: troubleshooting
weight: 3
weight: 30
weight: 30
toc: true
---
## Template Metrics
## Template metrics
Hugo is a very fast static site generator, but it is possible to write
inefficient templates. Hugo's _template metrics_ feature is extremely helpful
@@ -63,14 +64,14 @@ Template Metrics:
```
{{% note %}}
**A Note About Parallelism**
**A note about parallelism**
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 %}}
## Cached Partials
## Cached partials
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

View File

@@ -1,13 +1,14 @@
---
title: Frequently Asked Questions
linktitle: FAQ
title: Frequently asked questions
linkTitle: Frequently asked questions
description: Solutions to some common Hugo problems.
categories: [troubleshooting]
menu:
docs:
parent: troubleshooting
weight: 20
weight: 20
keywords: [faqs]
weight: 2
toc: true
aliases: [/faq/]
---
@@ -18,7 +19,7 @@ aliases: [/faq/]
## I can't see my content!
Is your Markdown file [in draft mode](https://gohugo.io/content-management/front-matter/#front-matter-variables)? When testing, run `hugo server` with the `-D` or `--buildDrafts` [switch](https://gohugo.io/getting-started/usage/#draft-future-and-expired-content).
Is your Markdown file [in draft mode](/content-management/front-matter/#front-matter-variables)? When testing, run `hugo server` with the `-D` or `--buildDrafts` [switch](/getting-started/usage/#draft-future-and-expired-content).
Is your Markdown file part of a [leaf bundle](/content-management/page-bundles/)? If there is an `index.md` file in the same or any parent directory then other Markdown files will not be rendered as individual pages.
@@ -28,7 +29,7 @@ Yes you can! See [Configure with Environment Variables](/getting-started/configu
## How do I schedule posts?
1. Set `publishDate` in the page [Front Matter](/content-management/front-matter/) to a datetime in the future. If you want the creation and publication datetime to be the same, it's also sufficient to only set `date`[^date-hierarchy].
1. Set `publishDate` in the page [front matter](/content-management/front-matter/) to a datetime in the future. If you want the creation and publication datetime to be the same, it's also sufficient to only set `date`[^date-hierarchy].
2. Build and publish at intervals.
How to automate the "publish at intervals" part depends on your situation:
@@ -42,7 +43,7 @@ Also see this Twitter thread:
{{< tweet user="ChrisShort" id="962380712027590657" >}}
[^date-hierarchy]: See [Configure Dates](https://gohugo.io/getting-started/configuration/#configure-dates) for the order in which the different date variables are complemented by each other when not explicitly set.
[^date-hierarchy]: See [Configure Dates](/getting-started/configuration/#configure-dates) for the order in which the different date variables are complemented by each other when not explicitly set.
## Can I use the latest Hugo version on Netlify?