mirror/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2025-08-18 21:11:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge commit 'a024bc7d76fcc5e49e8210f9b0896db9ef21861a'

Browse Source
This commit is contained in:
Bjørn Erik Pedersen
2025-02-13 10:40:34 +01:00
parent c054e18827 a024bc7d76
commit 304a7e5e74
817 changed files with 5301 additions and 14766 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/content/en/troubleshooting/_index.md
View File

@@ -1,6 +1,6 @@
---
title: Troubleshooting
linkTitle: In this section
description: Use these techniques when troubleshooting your site.
categories: []
keywords: []

10
docs/content/en/troubleshooting/deprecation.md
View File

@@ -29,10 +29,16 @@ Common [reasons for deprecation]:
After the project team deprecates something in code, Hugo will:
1. Log an INFO message for 6 minor releases[^1]
1. Log a WARN message for another 6 minor releases
1. Log an INFO message for 3 minor releases[^1]
1. Log a WARN message for another 12 minor releases
1. Log an ERROR message and fail the build thereafter
The project team will:
1. On the deprecation date, update the documentation with a note describing the deprecation and any relevant alternatives.
1. Remove the code six or more minor releases after Hugo begins logging ERROR messages and failing the build. At that point, Hugo will throw an error, but the error message will no longer mention the deprecation.
1. Remove the corresponding documentation two years after the deprecation date.
To see the INFO messages, you must use the `--logLevel` command line flag:
```text

6
docs/content/en/troubleshooting/faq.md
View File

@@ -51,11 +51,11 @@ If the answer to any of these questions is yes, either change the field values,
###### Why can't I see any of a page's descendants?
You may have an `index.md` file instead of an `_index.md` file. See [details](/content-management/page-bundles/).
You may have an `index.md` file instead of an `_index.md` file. See [details](/content-management/page-bundles/).
###### What is the difference between an index.md file and an _index.md file?
###### What is the difference between an `index.md` file and an `_index.md` file?
A directory with an `index.md file` is a [leaf bundle](g). A directory with an `_index.md` file is a [branch bundle](g). See [details](/content-management/page-bundles/).
A directory with an `index.md file` is a [leaf bundle](g). A directory with an `_index.md` file is a [branch bundle](g). See [details](/content-management/page-bundles/).
###### Why is my partial template not rendered as expected?