hugo/content/news/0.28-relnotes-ready.md
Bjørn Erik Pedersen 9d68f695e7 Squashed 'docs/' changes from 20959c7b..36d7e22f
36d7e22f Document fmt.{print, println} template functions
79a72fce Fix link to page variables
00342ca9 Fix broken link on highlight page
15f44952 Fix link in v0.28 release notes
0100df73 Fix code examples for math.{Ceil, Floor, Round}
a354a69b Fix broken netlify.toml
4995e5df Merge branch 'master' of github.com:gohugoio/hugoDocs
9cdd990a Hugo 0.29
463558f9 Document math.Log template function
588499af Add nohup.out to .gitignore
db8ddcf7 Change name of post files in example to use post prefix
296ec01f Add ox-hugo Emacs package to the tools section
f060d6d1 Fix math.Ceil, Floor, and Round naming
a2262d24 Document strings.TrimPrefix and TrimSuffix template functions
80c1ce63 Document strings.TrimLeft and TrimRight template functions
2921088d Document urls.Parse template function
f0133079 Document math.{ceil, floor, round} template functions
82863808 Fix typo in migration tools section
d5215d61 Add link to syntax hl docs in release notes
541f0686 Update versions
275ce2b4 Update 0.28 release notes
886713a1 Add release notes for 0.28
bed02e5f Merge branch 'next'
8e3b1ac4 Add a note about branches
1662b9d0 Add missing Disqus links in templates/internal.md

git-subtree-dir: docs
git-subtree-split: 36d7e22f5c21c550bd87782d2ddca666178fe1ff
2017-09-28 17:20:10 +02:00

4.5 KiB


date: 2017-09-25 title: "Hugo 0.28: High-speed Syntax Highlighting!" description: "Chroma is the new default syntax highlighter in Hugo." categories: ["Releases"] slug: "0.28-relnotes" images:

  • images/blog/hugo-28-poster.png

Hugo `0.28` brings **blistering fast and native syntax highlighting** from [Chroma](https://github.com/alecthomas/chroma) ([fb33d828](https://github.com/gohugoio/hugo/commit/fb33d8286d78a78a74deb44355b621852a1c4033) [@bep](https://github.com/bep) [#3888](https://github.com/gohugoio/hugo/issues/3888)). A big thank you to [Alec Thomas](https://github.com/alecthomas) for taking on this massive task of porting the popular python highlighter Pygments to Go.

Hugo has been caching the highlighter output to disk, so for repeated builds it has been fine, but this little snippet, showing a build of the gohugo.io site without cache and with both Pygments and Chroma, should illustrate the improvement:

{{< asciicast Lc5iwTVny2kuUC8lqvNnL6oDU >}}

See the Updated Documentation for more information about how this works.

Worth mentioning is also the liveReloadPort flag on hugo server, which makes it possible to do "live reloads" behind a HTTPS proxy, which makes for very cool remote customer demos.

One example would be a Hugo server running behind a ngrok tunnel:

ngrok http 1313

Then start the Hugo server with:

hugo server -b https://youridhere.ngrok.io --appendPort=false --liveReloadPort=443 --navigateToChanged

The navigateToChanged flag is slightly unrelated, but it is super cool ...

This release represents 15 contributions by 2 contributors to the main Hugo code base.

Many have also been busy writing and fixing the documentation in hugoDocs, which has received 9 contributions by 7 contributors. A special thanks to @bep, @i-give-up, @muhajirframe, and @icannotfly for their work on the documentation site.

Hugo now has:

Notes

  • Hugo now uses Chroma as new default syntax highlighter. This should in most cases work out-of-the box or with very little adjustments. But if you want to continue to use Pygments, set pygmentsUseClassic=true in your site config.
  • We now add a set of "no cache" headers to the responses for hugo server, which makes the most sense in most development scenarios. Run with hugo server --noHTTPCache=false to get the old behaviour.

Enhancements

Templates

Other