hugo/content/en/news/0.28-relnotes/index.md
Bjørn Erik Pedersen b9bd35d72e Squashed 'docs/' content from commit fdea5430f
git-subtree-dir: docs
git-subtree-split: fdea5430f89dfd849d39212abdf5ace0a4763e5a
2019-10-21 10:22:28 +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"] 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