mirror of
				https://github.com/McShelby/hugo-theme-relearn.git
				synced 2025-11-04 02:04:49 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			132 lines
		
	
	
		
			No EOL
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			132 lines
		
	
	
		
			No EOL
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
+++
 | 
						|
title = "Menu extra shortcuts"
 | 
						|
weight = 5
 | 
						|
+++
 | 
						|
 | 
						|
You can define additional menu entries or shortcuts in the navigation menu without any link to content.
 | 
						|
 | 
						|
## Basic configuration
 | 
						|
 | 
						|
Edit the website configuration `config.toml` and add a `[[menu.shortcuts]]` entry for each link your want to add.
 | 
						|
 | 
						|
Example from the current website:
 | 
						|
 | 
						|
````toml
 | 
						|
[[menu.shortcuts]]
 | 
						|
name = "<i class='fab fa-fw fa-github'></i> GitHub repo"
 | 
						|
identifier = "ds"
 | 
						|
url = "https://github.com/McShelby/hugo-theme-relearn"
 | 
						|
weight = 10
 | 
						|
 | 
						|
[[menu.shortcuts]]
 | 
						|
name = "<i class='fas fa-fw fa-camera'></i> Showcases"
 | 
						|
url = "more/showcase/"
 | 
						|
weight = 11
 | 
						|
 | 
						|
[[menu.shortcuts]]
 | 
						|
name = "<i class='fas fa-fw fa-bookmark'></i> Hugo Documentation"
 | 
						|
identifier = "hugodoc"
 | 
						|
url = "https://gohugo.io/"
 | 
						|
weight = 20
 | 
						|
 | 
						|
[[menu.shortcuts]]
 | 
						|
name = "<i class='fas fa-fw fa-bullhorn'></i> Credits"
 | 
						|
url = "more/credits/"
 | 
						|
weight = 30
 | 
						|
 | 
						|
[[menu.shortcuts]]
 | 
						|
name = "<i class='fas fa-fw fa-tags'></i> Tags"
 | 
						|
url = "tags/"
 | 
						|
weight = 40
 | 
						|
````
 | 
						|
 | 
						|
By default, shortcuts are preceded by a title. This title can be disabled by setting `disableShortcutsTitle=true`.
 | 
						|
However, if you want to keep the title but change its value, it can be overridden by changing your local i18n translation string configuration.
 | 
						|
 | 
						|
For example, in your local `i18n/en.toml` file, add the following content
 | 
						|
 | 
						|
````toml
 | 
						|
[Shortcuts-Title]
 | 
						|
other = "<Your value>"
 | 
						|
````
 | 
						|
 | 
						|
Read more about [hugo menu](https://gohugo.io/extras/menus/) and [hugo i18n translation strings](https://gohugo.io/content-management/multilingual/#translation-of-strings)
 | 
						|
 | 
						|
## Configuration for Multilingual mode {#i18n}
 | 
						|
 | 
						|
When using a multilingual website, you can set different menus for each language. In the `config.toml` file, prefix your menu configuration by `Languages.<language-id>`.
 | 
						|
 | 
						|
Example from the current website:
 | 
						|
 | 
						|
````toml
 | 
						|
[Languages]
 | 
						|
  [Languages.en]
 | 
						|
    title = "Hugo Relearn Theme"
 | 
						|
    weight = 1
 | 
						|
    languageName = "English"
 | 
						|
    landingPageURL = "/"
 | 
						|
    landingPageName = "<i class='fas fa-home'></i> Home"
 | 
						|
 | 
						|
  [[Languages.en.menu.shortcuts]]
 | 
						|
    name = "<i class='fab fa-fw fa-github'></i> GitHub repo"
 | 
						|
    identifier = "ds"
 | 
						|
    url = "https://github.com/McShelby/hugo-theme-relearn"
 | 
						|
    weight = 10
 | 
						|
 | 
						|
  [[Languages.en.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-camera'></i> Showcases"
 | 
						|
    url = "more/showcase/"
 | 
						|
    weight = 11
 | 
						|
 | 
						|
  [[Languages.en.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-bookmark'></i> Hugo Documentation"
 | 
						|
    identifier = "hugodoc"
 | 
						|
    url = "https://gohugo.io/"
 | 
						|
    weight = 20
 | 
						|
 | 
						|
  [[Languages.en.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-bullhorn'></i> Credits"
 | 
						|
    url = "more/credits/"
 | 
						|
    weight = 30
 | 
						|
 | 
						|
  [[Languages.en.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-tags'></i> Tags"
 | 
						|
    url = "tags/"
 | 
						|
    weight = 40
 | 
						|
 | 
						|
  [Languages.pir]
 | 
						|
    title = "Cap'n Hugo Relearrrn Theme"
 | 
						|
    weight = 1
 | 
						|
    languageName = "Arrr! Pirrrates"
 | 
						|
    landingPageURL = "/pir/"
 | 
						|
    landingPageName = "<i class='fas fa-home'></i> Arrr! Home"
 | 
						|
 | 
						|
  [[Languages.pir.menu.shortcuts]]
 | 
						|
    name = "<i class='fab fa-fw fa-github'></i> GitHub repo"
 | 
						|
    identifier = "ds"
 | 
						|
    url = "https://github.com/McShelby/hugo-theme-relearn"
 | 
						|
    weight = 10
 | 
						|
 | 
						|
  [[Languages.pir.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-camera'></i> Showcases"
 | 
						|
    url = "more/showcase/"
 | 
						|
    weight = 11
 | 
						|
 | 
						|
  [[Languages.pir.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-bookmark'></i> Cap'n Hugo Documentat'n"
 | 
						|
    identifier = "hugodoc"
 | 
						|
    url = "https://gohugo.io/"
 | 
						|
    weight = 20
 | 
						|
 | 
						|
  [[Languages.pir.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-bullhorn'></i> Crrredits"
 | 
						|
    url = "more/credits/"
 | 
						|
    weight = 30
 | 
						|
 | 
						|
  [[Languages.pir.menu.shortcuts]]
 | 
						|
    name = "<i class='fas fa-fw fa-tags'></i> Arrr! Tags"
 | 
						|
    url = "tags/"
 | 
						|
    weight = 40
 | 
						|
````
 | 
						|
 | 
						|
Read more about [hugo menu](https://gohugo.io/extras/menus/) and [hugo multilingual menus](https://gohugo.io/content-management/multilingual/#menus) |