Skip to content

theNewDynamic/language-hugo-vscode

Repository files navigation

language-hugo README

Syntax highlighting and snippets for Hugo websites.

Features

Makes Hugo templating fit in with the rest of your HTML.

Includes 24 completion snippets for Go Template, see full list below.

Includes snippets for Hugo Shortcodes in Markdown and TOML file, list to come.

Template Snippets

Snippet Tab Trigger Output
Curlies x {{ }}
Dot xx {{ . }}
If if {{ if }} {{ end }}
If Inline ifi Same as above but inline
If/Else ife {{ if }} {{ else }} {{ end }}
If/Else if ifei {{ if }} {{ else if }} {{ end }}
With with {{ with }} {{ end }}
With/Else withe {{ with }} {{ else }} {{ end }}
Range range {{ range }} {{ end }}
Partial partial {{ partial "" . }}
partialCached partialc {{ partialCached "" . variant }}
Naked partial xpartial partial "" .
Block block {{ block "main" . }} {{ end }}
Block define define {{ define "block" }} {{ end }}
Scratch  scra `{{ .Scratch.Set
String str {{ printf "Something about %s" . }}
printF  print  `printf "%s
Variable vars {{ $var := what }}
Return  ret  {{ return $return }}
Debug debug {{ printf "%#v" . }}
Error error {{ errorf "%#v" . }}
Comment comm {{/* */}}

Known Issues

For Hugo Shortcode snippets to work in your Markdown files, enable quickSuggestions in your User Settings

"[markdown]": {
  "editor.quickSuggestions": true
}

Release Notes

See the Changelog

Roadmap

  • More Snippets/Completions
  • Add syntax highlighting for shortcodes in markdown files.
  • Add support for Hugo syntax highlighting in JSON files

Acknowledgments

Thank you to Matt Stratton for creating the Atom Language-hugo plugin, from which this borrows heavily.

Thank you to Steve Francia, Bjørn Erik and the Hugo community of contributors and users.