132 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			132 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| +++
 | |
| title = "Menu extra shortcuts"
 | |
| weight = 25
 | |
| +++
 | |
| 
 | |
| 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 overriden 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) |