blogs/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2026-09-02 03:32:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

Misc edits

Browse Source
This commit is contained in:
Joe Mooring
2025-01-18 15:20:47 -08:00
committed by Joe Mooring
parent 6a06a8de75
commit 586970df2c
5 changed files with 82 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/en/about/features.md
-1
View File
@@ -11,7 +11,6 @@ weight: 30
toc: true
---
{{% gt bool %}}
## Framework
[Multiplatform]
content/en/content-management/urls.md
+1 -1
View File
@@ -448,7 +448,7 @@ public/
└── index.html
```
The alias from the previous URL to the new URL is a client side redirect:
The alias from the previous URL to the new URL is a client-side redirect:
{{< code file=posts/previous-file-name/index.html >}}
<!DOCTYPE html>
content/en/contribute/documentation.md
+78 -27
View File
@@ -54,6 +54,11 @@ Please link to the [glossary of terms] when necessary, and use the terms consist
- Capitalize the word "Markdown"
- Hyphenate the term "open-source" when used an adjective.
Use the [glossary link] (`gl`) shortcode to insert a link to the glossary entry for the given term, and use the [glossary term] (`gt`) shortcode to insert the definition of the given term.
[glossary link]: #glossary-link
[glossary term]: #glossary-term
#### Page titles and headings
Please follow these guidelines for page titles and headings:
@@ -105,7 +110,7 @@ For example:
[functions]: /functions
[methods]: /methods
## Directory names, file names, and file paths
#### Directory names, file names, and file paths
Enclose directory names, file names, and file paths within backticks, with the following exceptions:
@@ -118,7 +123,6 @@ Enclose directory names, file names, and file paths within backticks, with the f
Other guidelines to consider:
- Wrap directory names, file names, and file paths within a pair of backticks.
- Do not place list items directly under a heading; include an introductory sentence or phrase before the list.
- Avoid use of **bold** text. Use the [note shortcode] to draw attention to important content.
- Do not place description terms (`dt`) within backticks unless required for syntactic clarity.
@@ -143,8 +147,6 @@ Always include the language code when using a fenced code block:
```
````
Rendered:
```go-html-template
{{ if eq $foo "bar" }}
{{ print "foo is bar" }}
@@ -160,8 +162,6 @@ Use this syntax to include shortcodes calls within your code examples:
{{%/*/* foo */*/%}}
```
Rendered:
```text
{{</* foo */>}}
{{%/* foo */%}}
@@ -179,8 +179,6 @@ title = 'My Site'
{{</* /code-toggle */>}}
```
Rendered:
{{< code-toggle file=hugo >}}
baseURL = 'https://example.org/'
languageCode = 'en-US'
@@ -199,8 +197,6 @@ draft = false
{{</* /code-toggle */>}}
```
Rendered:
{{< code-toggle file=content/posts/my-first-post.md fm=true >}}
title = 'My first post'
date = 2023-11-09T12:56:07-08:00
@@ -219,8 +215,6 @@ Use the [code shortcode] for other code examples that require a file name:
{{</* /code */>}}
```
Rendered:
{{< code file=layouts/_default/single.html >}}
{{ range .Site.RegularPages }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
@@ -233,7 +227,7 @@ These shortcodes are commonly used throughout the documentation. Other shortcode
### code
Use the "code" shortcode for other code examples that require a file name. See the [code examples] above. This shortcode takes these arguments:
Use the `code` shortcode for other code examples that require a file name. See the [code examples] above. This shortcode takes these arguments:
copy
: (`bool`) Whether to display a copy-to-clipboard button. Default is `false`.
@@ -244,23 +238,60 @@ file
lang
: (`string`) The code language. If you do not provide a `lang` argument, the code language is determined by the file extension. If the file extension is `html`, sets the code language to `go-html-template`. Default is `text`.
```text
{{</* code file=content/something/foo.md lang=text copy=true */>}}
Some code here
{{</* /code */>}}
```
{{< code file=content/something/foo.md lang=text copy=true >}}
Some code here
{{< /code >}}
### code-toggle
Use the "code-toggle" shortcode to display examples of site configuration, front matter, or data files. See the [code examples] above. This shortcode takes these arguments:
Use the `code-toggle` shortcode to display examples of site configuration, front matter, or data files. See the [code examples] above. This shortcode takes these arguments:
config
: (`string`) The section of `site.Data.docs.config` to render.
copy
: (`bool`) Whether to display a copy-to-clipboard button. Default is `false`.
file
: (`string`) The file name to display. Omit the file extension for site configuration examples.
: (`string`) The file name to display. Omit the file extension for site configuration examples. Default is `hugo`
fm
: (`bool`) Whether the example is front matter. Default is `false`.
skipHeader
: (`bool`) Whether to omit top level key(s) when rendering a section of `site.Data.docs.config`.
```text
{{</* code-toggle */>}}
title: Example
draft: false
{{</* /code-toggle */>}}
```
{{< code-toggle >}}
title: Example
draft: false
{{< /code-toggle >}}
### comment
Use the `comment` shortcode to include comments in your content. Hugo will ignore the text within these comments when rendering your site.
```text
{{%/* comment */%}}
This will be hidden when rendering the page.
{{%/* /comment */%}}
```
### deprecated-in
Use the “deprecated-in” shortcode to indicate that a feature is deprecated:
Use the `deprecated-in` shortcode to indicate that a feature is deprecated:
```text
{{%/* deprecated-in 0.127.0 */%}}
@@ -270,8 +301,6 @@ Use [`hugo.IsServer`] instead.
{{%/* /deprecated-in */%}}
```
Rendered:
{{% deprecated-in 0.127.0 %}}
Use [`hugo.IsServer`] instead.
@@ -280,7 +309,7 @@ Use [`hugo.IsServer`] instead.
### eturl
Use the embedded template URL (eturl) shortcode to insert an absolute URL to the source code for an embedded template. The shortcode takes a single argument, the base file name of the template (omit the file extension).
Use the embedded template URL (`eturl`) shortcode to insert an absolute URL to the source code for an embedded template. The shortcode takes a single argument, the base file name of the template (omit the file extension).
```text
This is a link to the [embedded alias template].
@@ -288,27 +317,51 @@ This is a link to the [embedded alias template].
[embedded alias template]: {{%/* eturl alias */%}}
```
Rendered:
This is a link to the [embedded alias template].
[embedded alias template]: {{% eturl alias %}}
### glossary link
Use the glossary link (`gl`) shortcode to insert a link to the given glossary term.
```text
{{%/* gl scalar */%}}
```
{{% gl scalar %}}
### glossary term
Use the glossary term (`gt`) shortcode to insert the definition of the given glossary term.
```text
{{%/* gt scalar */%}}
```
{{% gt scalar %}}
### include
Use the `include` shortcode to include content from another page.
```text
{{%/* include "functions/_common/glob-patterns" */%}}
```
### new-in
Use the "new-in" shortcode to indicate a new feature:
Use the `new-in` shortcode to indicate a new feature:
```text
{{</* new-in 0.127.0 */>}}
```
Rendered:
{{< new-in 0.127.0 >}}
### note
Use the "note" shortcode with `{{%/* */%}}` delimiters to call attention to important content:
Use the `note` shortcode with `{{%/* */%}}` delimiters to call attention to important content:
```text
{{%/* note */%}}
@@ -318,8 +371,6 @@ Use the [`math.Mod`] function to control...
{{%/* /note */%}}
```
Rendered:
{{% note %}}
Use the [`math.Mod`] function to control...
content/en/getting-started/glossary/scalar.md
+1 -1
View File
@@ -2,6 +2,6 @@
title: scalar
---
A single value, one of [string], [integer], [floating point], or [boolean].
A _scalar_ is a single value, one of [string], [integer], [floating point], or [boolean].
{{% include "/getting-started/glossary/_link-reference-definitions" %}}
content/en/tools/search.md
+2 -2
View File
@@ -38,10 +38,10 @@ A static website with a dynamic search function? Yes, Hugo provides an alternati
: A usability and speed update to "GitHub Gist for Fuse.js integration" — global, keyboard-optimized search.
[JS & Fuse.js tutorial](https://makewithhugo.com/add-search-to-a-hugo-site/)
: A simple client side search solution, using FuseJS (does not require jQuery).
: A simple client-side search solution, using FuseJS (does not require jQuery).
[Hugo Lyra](https://github.com/paolomainardi/hugo-lyra)
: Hugo-Lyra is a JavaScript module to integrate [Lyra](https://github.com/LyraSearch/lyra) into a Hugo website. It contains the server-side part to generate the index and the client side library (optional) to bootstrap the search engine easily.
: Hugo-Lyra is a JavaScript module to integrate [Lyra](https://github.com/LyraSearch/lyra) into a Hugo website. It contains the server-side part to generate the index and the client-side library (optional) to bootstrap the search engine easily.
[INFINI Pizza for WebAssembly](https://github.com/infinilabs/pizza-docsearch)
: Pizza is a super-lightweight yet fully featured search engine written in Rust. You can quickly add offline search functionality to your Hugo website in just five minutes with only three lines of code. For a step-by-step guide on integrating it with Hugo, check out [this blog tutorial](https://dev.to/medcl/adding-search-functionality-to-a-hugo-static-site-based-on-infini-pizza-for-webassembly-4h5e).