Releases: gohugoio/hugo
v0.16
0.16.0 June 6th 2016
Hugo 0.16 is our best and biggest release ever. The Hugo community has outdone itself with continued performance improvements, beautiful themes for all types of sites from project sites to documentation to blogs to portfolios, and increased stability.
This release represents over 550 contributions by over 110 contributors to the main Hugo codebase. Since last release Hugo has gained 3500 stars, 90 contributors and 23 additional themes.
This release celebrates 3 years since @spf13 wrote the first lines of Hugo. During those 3 years Hugo has accomplished some major milestones including…
- 10,000+ stars on GitHub
- 320+ contributors
- 90+ themes
- 1000s of happy websites
- Many subprojects like @spf13/cobra , @spf13/viper and @spf13/afero which have experienced broad usage across the Go ecosystem.
@bep led the development of Hugo for the 3rd consecutive release with nearly half of the contributions to 0.16 in addition to his considerable contributions as lead maintainer. @anthonyfok , @DigitalCraftsman , @MooreReason all made significant contributions. A special thanks to @abourget for his considerable work on multilingual support. Due to its broad impact we wanted to spend more time testing it and it will be included in Hugo’s next release.
Highlights
Partial Builds: Prior to this release Hugo would always reread and rebuild the entire site. This release introduces support for reactive site building while watching (hugo server). Hugo will watch the filesystem for changes and only re-read the changed files. Depending on the files change Hugo will intelligently re-render only the needed portion of the site. Performance gains depend on the operation performed and size of the site. In our testing build times decreased anywhere from 10% to 99%.
Template Improvements: Template improvements continue to be a mainstay of each Hugo release. Hugo 0.16 adds support for the new block keyword introduced in Go 1.6 – think base templates with default sections – as well as many new template functions.
Polish: As Hugo matures releases will inevitably contain fewer huge new features. This release represents hundreds of small improvements across ever facet of Hugo which will make for a much better experience for all of our users. Worth mentioning here is the curious bug where live reloading didn’t work in some editors on OS X, including the popular TextMate 2. This is now fixed. Oh, and now any error will exit with an error code, a big thing for automated deployments.
New Features
- Support reading configuration variables from the OS environment #2090
- Add emoji support #1892
- Add
themesDiroption to configuration #1556 - Add support for Go 1.6
blockkeyword in templates #1832 - Partial static sync #1644
- Source file based relative linking (a la Github) 0f6b33
- Add
ByLastmodsort function to pages. #eb627ca16de6fb5e8646279edd295a8bf0f72bf1 - New templates functions:
readFile#1551countwordsandcountrunes#1440default#1943hasPrefix#1243humanize#1818jsonify435e99md5andsha1#1932replaceRE#1845findRE#2048shuffle#1942slice#1902plainify#1915
Enhancements
- Hugo now exits with error code on any error. This is a big thing for automated deployments. #740
- Print error when
/index.htmlis zero-length #947 - Enable dirname and filename bash autocompletion for more flags 666ddd
- Improve error handling in commands #1502
- Add sanity checks for
hugo import jekyll#1625 - Add description to
Page.Params#1484 - Add async version of Google Analytics internal template #1711
- Add autostart option to YouTube shortcode #1784
- Set Date and Lastmod for main home page #1903
- Allow URL with extension in frontmatter #1923
- Add list support in Scratch eaba04
- Add file option to gist shortcode #1955
- Add config layout and content directory CLI options #1698
- Add boolean value comparison to
wheretemplate function f3c74c - Do not write to to cache when
ignoreCacheis set #2067 - Add option to disable rendering of 404 page #2037
- Mercurial is no longer needed to build Hugo #2062
- Do not create
robots.txtby default #2049 - Disable syntax guessing for PygmentsCodeFences by default. To enable syntax guessing again, add the following to your config file:
PygmentsCodeFencesGuessSyntax = true#2034 - Make
ByCountsort consistently #1930 - Add
Scratchto shortcode #2000 - Add support for symbolic links for content, layout, static, theme #1855
- Add ‘+’ as one of the valid characters in URLs specified in the front matter #1290
- Make alias redirect output URLs relative when
RelativeURLs = true#2093 - Hugo injects meta generator tag on homepage if missing #2182
Fixes
- Fix file change watcher for TextMate 2 and friends on OS X #1053
- Make dynamic reloading of config file reliable on all platform #1684
- Hugo now works on Linux/arm64 #1772
plainIDAnchorsnow defaults totrue#2057- Win32 and ARM builds fixed #1716
- Copy static dir files without theme’s static dir #1656
- Make
noTimescommand flag work #1657 - Change most global CLI flags into local ones #1624
- Remove transformation of menu URLs #1239
- Do not fail on unknown Jekyll file #1705
- Use absolute path when editing with editor #1589
- Fix hugo server “Watching for changes” path display #1721
- Do not strip special characters out of URLs #1292
- Fix
RSSLinkwhen uglyurls are enabled #175 - Get BaseURL from viper in server mode #1821
- Fix shortcode handling in RST #1904
- Use default sitemap configuration for homepage #1304
- Exit if specific port is unavailable in server mode #1901
- Fix regression in “section menus for lazy blogger” #2065
.deb packages for Debian, Ubuntu, etc.
Hugo has become part of the official Debian and Ubuntu repositories since January 2016!
Check out the following download links in Debian and Ubuntu:
- Debian: https://packages.debian.org/sid/hugo
- Ubuntu: http://packages.ubuntu.com/yakkety/hugo (awaiting sync from Debian as of 2016-06-12)
And, if you are already running the latest cutting-edge version of Debian or Ubuntu, simply run apt-get install hugo to get it! 😄
Or download the .deb files provided below (amd64, arm64, armhf, i386, ppc64, ppc64el are currently available, hopefully more coming soon). For Raspberry Pi users running Raspbian and alike, the file you want is hugo_0.16-1_armhf.deb.
_Note: The .deb file sizes are smaller than other alternative downloads because the /usr/bin/hugo contained therein were stripped of debug symbols as per Debian policy.
RPM package for Fedora (and Mandriva, openSUSE, etc.)
@jdoss has kindly uploaded and built the Hugo .rpm pack�ages to the Fedora Copr.1 Please visit https://copr.f...
v0.15
The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after the 0.14 release, Hugo has seen massive growth and changes. Most notably, this is Hugo's first release under the Apache 2.0 license. With this license change we hope to expand the great community around Hugo and make it easier for our many users to contribute. This release represents over 377 contributions by 87 contributors to the main Hugo repo and hundreds of improvements to the libraries Hugo uses. Hugo also launched a new theme showcase and participated in Hacktoberfest.
Hugo now has:
- 6700 (+2700) stars on GitHub
- 235 (+75) contributors
- 65 (+30) themes
Template Improvements: This release takes Hugo to a new level of speed and usability. Considerable work has been done adding features and performance to the template system which now has full support of Ace, Amber and Go Templates.
Hugo Import: Have a Jekyll site, but dreaming of porting it to Hugo? This release introduces a new hugo import jekyllcommand that makes this easier than ever.
Performance Improvements: Just when you thought Hugo couldn't get any faster, Hugo continues to improve in speed while adding features. Notably Hugo 0.15 introduces the ability to render and serve directly from memory resulting in 30%+ lower render times.
Huge thanks to all who participated in this release. A special thanks to @bep who led the development of Hugo this release again, @anthonyfok, @eparis, @tatsushid and @DigitalCraftsman.
New features
- new
hugo import jekyllcommand. #1469 - The new
Paramconvenience method onPageandNodecan be used to get the most specific parameter value for a given key. #1462 - Several new information elements have been added to
PageandNode:RuneCount: The number of runes in the content, excluding any whitespace. This may be a good alternative to.WordCountfor Japanese and other CJK languages where a word-split by spaces makes no sense. #1266RawContent: Raw Markdown as a string. One use case may be of embedding remarkjs.com slides.IsHome: tells the truth about whether you're on the home page or not.
Improvements
hugo servernow builds ~30%+ faster by rendering to memory instead of disk. To get the old behavior, start the server with--renderToDisk=true.- Hugo now supports dynamic reloading of the config file when watching.
- We now use a custom-built
LazyFileReaderfor reading file contents, which means we don't read media files in/contentinto memory anymore -- and file reading is now performed in parallel on multicore PCs. #1181 - Hugo is now built with
Go 1.5which, among many other improvements, have fixed the last known data race in Hugo. #917 - Paginator now also supports page groups. #1274
- Markdown improvements:
Scratchnow has built-inmapsupport.- We now fall back to
link titlefor the default page sort. #1299 - Some notable new configuration options:
hugo gencan now generate man files, bash auto complete and markdown documentation- Hugo will now make suggestions when a command is mistyped
- Shortcodes now have a boolean
.IsNamedParamsproperty. #1597
New Template Features
- All template engines:
- The new
dictfunction that could be used to pass maps into a template. #1463 - The new
pluralizeandsingularizetemplate funcs. - The new
base64Decodeandbase64Encodetemplate funcs. - The
sorttemplate func now accepts field/key chaining arguments and pointer values. #1330 - Several fixes for
slicestrandsubstr, most importantly, they now have fullutf-8-support. #1190 #1333 #1347 - The new
lasttemplate function allows the user to select the lastNitems of a slice. #1148 - The new
afterfunc allows the user to select the items after theNthitem. #1200 - Add
time.Timetype support to thewhere,ge,gt,le, andlttemplate functions. - It is now possible to use constructs like
where Values ".Param.key" nilto filter pages that doesn't have a particular parameter. #1232 getJSON/getCSV: Add retry on invalid content. #1166- The new
readDirfunc lists local files. #1204 - The new
safeJSfunction allows the embedding of content into JavaScript contexts in Go templates. - Get the main site RSS link from any page by accessing the
.Site.RSSLinkproperty. #1566
- The new
- Ace templates:
- Full support for Amber templates including all template functions.
- A built-in template for Google Analytics. #1505
- Hugo is now shipped with new built-in shortcodes: #1576
youtubefor YouTube videosvimeofor Vimeo videosgistfor GitHub giststweetfor Twitter Tweetsspeakerdeckfor Speakerdeck slides
Bugfixes
- Fix data races in page sorting and page reversal. These operations are now also cached. #1293
page.HasMenuCurrent()andnode.HasMenuCurrent()now work correctly in multi-level nested menus.- Support
Fish and Chipsstyle section titles. Previously, this would end up asFish And Chips. Now, the first character is made toupper, but the rest are preserved as-is. #1176 - Hugo now removes superfluous p-tags around shortcodes. #1148
Notices
hugo serverwill watch by default now.- Some fields and methods were deprecated in
0.14. These are now removed, so the error message isn't as friendly if you still use the old values. So please change:getJsontogetJSON,getCsvtogetCSV,safeHtmlto
safeHTML,safeCsstosafeCSS,safeUrltosafeURL,UrltoURL,
UrlPathtoURLPath,BaseUrltoBaseURL,RecenttoPages.
Known Issues
Using the Hugo v0.15 32-bit Windows or ARM binary, running hugo server would crash or hang due to a memory alignment issue in Afero. The bug was discovered shortly after the v0.15.0 release and has since been fixed by @tpng. If you encounter this bug, you may either compile Hugo v0.16-DEV from source, or use the following solution/workaround:
- 64-bit Windows users: Please use hugo_0.15_windows_amd64.zip (amd64 == x86-64). It is only the 32-bit hugo_0.15_windows_386.zip that crashes/hangs (see #1621 and #1628).
- 32-bit Windows and ARM users: Please run
hugo server --renderToDiskas a workaround until Hugo v0.16 is released (see “hugo server” returns runtime error on armhf and #1716).
v0.14
The v0.14.0 Hugo release brings of the most demanded features to Hugo. The foundation of Hugo is stabilizing nicely and a lot of polish has been added. We’ve expanded support for additional content types with support for AsciiDoc, Restructured Text, HTML and Markdown. Some of these types depend on external libraries as there does not currently exist native support in Go. We’ve tried to make the experience as seamless as possible. Look for more improvements here in upcoming releases.
A lot of work has been done to improve the user experience, with extra polish to the Windows experience. Hugo errors are more helpful overall and Hugo now can detect if it’s being run in Windows Explorer and provide additional instructions to run it via the command prompt.
The Hugo community continues to grow. Hugo has over 4000 stars on github, 165 contributors, 35 themes and 1000s of happy users. It is now the 5th most popular static site generator (by Stars) and has the 3rd largest contributor community.
This release represents over 240 contributions by 36 contributors to the main Hugo codebase.
Big shout out to @bep who led the development of Hugo this release, @anthonyfok, @eparis, @SchumacherFM, @RickCogley & @mdhender for their significant contributions and @tatsushid for his continuous improvements to the templates. Also a big thanks to all the theme creators. 11 new themes have been added since last release and the hugoThemes repo now has previews of all of them.
Hugo also depends on a lot of other great projects. A big thanks to all of our dependencies inclding:
cobra, viper, blackfriday, pflag, HugoThemes, BurntSushi/Toml, goYaml, and the Go standard library.
New features
- Support for all file types in content directory.
- If dedicated file type handler isn’t found it will be copied to the destination.
- Add
AsciiDocsupport using external helpers. - Add experimental support for
Mmarkmarkdown processor - Bash autocomplete support via
genautocompletecommand - Add section menu support for a Section Menu for "the Lazy Blogger"
- Add support for
Acebase templates - Adding
RelativeURLs = trueto site config will now make all the relative URLs relative to the content root. - New template functions:
getenv- The string functions
substrandslicestr
*seq, a sequence generator very similar to its Gnu countepart absURLandrelURL, both of which takes theBaseURLsetting into account
Improvements
- Highlighting with
Pygmentsis now cached to disk -- expect a major speed boost if you use it! - More Pygments highlighting options, including
line numbers - Show help information to Windows users who try to double click on
hugo.exe. - Add
bindflag tohugo serverto set the interface to which the server will bind - Add support for
canonifyurlsinsrcset - Add shortcode support for HTML (content) files
- Allow the same
shortcodeto be used with or without inline content - Configurable RSS output filename
Bugfixes
- Fix panic with paginator and zero pages in result set.
- Fix crossrefs on Windows.
- Fix
eqandnetemplate functions when used with a raw number combined with the result ofadd,subetc. - Fix paginator with uglyurls
- Fix #998, supporting UTF8 characters in Permalinks.
Notices
- To get variable and function names in line with the rest of the Go community, a set of variable and function names has been deprecated: These will still work in 0.14, but will be removed in 0.15. What to do should be obvious by the build log;
getJsontogetJSON,getCsvtogetCSV,safeHtmltosafeHTML,safeCsstosafeCSS,safeUrltosafeURL,UrltoURL,UrlPathtoURLPath,BaseUrltoBaseURL,RecenttoPages,IndexestoTaxonomies.
v0.13
The v0.13.0 release is the largest Hugo release to date. The release introduced
some long sought after features (pagination, sequencing, data loading, tons of
template improvements) as well as major internal improvements. In addition to
the code changes, the Hugo community has grown significantly and now has over
3000 stars on github, 134 contributors, 24 themes and 1000s of happy users.
This release represents 448 contributions by 65 contributors
A special shout out to @bep and
@anthonyfok for their new role as Hugo
maintainers and their tremendous contributions this release.
New major features
- Support for data files in YAML,
JSON, or TOML
located in thedatadirectory (#885) - Support for dynamic content by loading JSON & CSV
from remote sources via GetJson and GetCsv in short codes or other layout
files (#748) - Pagination support for home page, sections and
taxonomies (#750) - Universal sequencing support
- A new, generic Next/Prev functionality is added to all lists of pages
(sections, taxonomies, etc.) - Add in-section Next/Prev content pointers
- A new, generic Next/Prev functionality is added to all lists of pages
Scratch-- a "scratchpad" for your node- and page-scoped
variables- Cross Reference support to easily link documents
together with the ref and relref shortcodes. - Ace template engine support (#541)
- A new shortcode token of
{{</* */>}}(raw HTML)
alongside the existing{{%/* */%}}(Markdown) - A top level
Hugovariable (on Page & Node) is added with various build
information - Several new ways to order and group content:
ByPublishDateGroupByPublishDate(format, order)GroupByParam(key, order)GroupByParamDate(key, format, order)
- Hugo has undergone a major refactoring, with a new handler system and a
generic file system. This sounds and is technical, but will pave the way for
new features and make Hugo even speedier
Notable enhancements to existing features
- The shortcode handling is rewritten for speed and
better error messages. - Several improvements to the template functions:
whereis now even more powerful and accepts SQL-like syntax with the
operators==,eq;!=,<>,ne;>=,ge;>,gt;<=,
le;<,lt;in,not inwheretemplate function now also accepts dot chaining key argument
(e.g."Params.foo.bar")
- New template functions:
applychompdelimitsortmarkdownifyinandintersecttrimreplacedateFormat
- Several configurable improvements related to Markdown
rendering:- Configuration of footnote rendering
- Optional support for smart angled quotes, e.g.
"Hugo"→ «Hugo» - Enable descriptive header IDs
- URLs in XML output is now correctly canonified (#725, #728, and part
of #789)
Other improvements
- Internal change to use byte buffer pool significantly lowering memory usage
and providing measurable performance improvements overall - Changes to docs:
- A new Troubleshooting section is added
- It's now searchable through Google Custom Search (#753)
- Some new great tutorials:
hugo newnow copies the content in addition to the front matter- Improved unit test coverage
- Fixed a lot of Windows-related path issues
- Improved error messages for template and rendering errors
- Enabled soft LiveReload of CSS and images (#490)
- Various fixes in RSS feed generation (#789)
HasMenuCurrentandIsMenuCurrentis now supported on Nodes- A bunch of bug fixes
v0.12
A lot has happened since Hugo v0.11.0 was released. Most of the work has been
focused on polishing the theme engine and adding critical functionality to the
templates.
This release represents over 90 code commits from 28 different contributors.
- 10 new themes created by the community
- fully themable partials
- 404 template support in themes
- shortcode support in themes
- views support in themes
- inner shortcode content now treated as markdown
- support for header ids in markdown (# header {#myid})
- where template function to filter lists of content, taxonomies, etc
- groupby & groupbydate methods to group pages
- taxonomy pages list now sortable, filterable, limitable & groupable
- general cleanup to taxonomies & documentation to make it more clear and consistent
- showcase returned and has been expanded
- pretty links now always have trailing slashes
- baseurl can now include a subdirectory
- better feedback about draft & future post rendering
- a variety of improvements to the website
v0.11
- Considerably faster... about 3 - 4x faster on average
- Live Reload. Hugo will automatically reload the browser when the build is complete
- Theme engine w/Theme Repository
- Menu system with support for active page
- Builders to quickly create a new site, content or theme
- XML sitemap generation
- Integrated Disqus support
- Streamlined template organization
- Brand new docs site
- Support for publishDate which allows for posts to be dated in the future
- More sort options
- Logging support
- Much better error handling
- More informative verbose output
- Renamed Indexes > Taxonomies
- Renamed Chrome > Partials
v0.10
- Syntax highlighting powered by pygments (slow)
- Ability to sort content many more ways
- Automatic table of contents generation
- Support for unicode urls, aliases and indexes
- Configurable per-section permalink pattern support
- Support for paired shortcodes
- Shipping with some shortcodes (highlight & figure)
- Adding canonify option to keep urls relative
- A bunch of additional template functions
- Watching very large sites now works on mac
- RSS generation improved. Limited to 50 items by default, can limit further in template
- Boolean params now supported in frontmatter
- Launched website showcase. Show off your own hugo site!
- A bunch of bug fixes
v0.9
This is the most significant update to Hugo ever!
It contains contributions from dozens of contributors and represents hundreds of features, fixes and improvements.
Major New Features
- New command based interface similar to git (
hugo server -s ./) - Amber template support
- Full Windows support
- Better index support including ordering by content weight
- Add params to site config, available in
.Site.Paramsfrom templates - Support for html & xml content (with front matter support)
- Support for top level pages (in addition to homepage)
Notable Fixes and Additions
- Friendlier json support
- Aliases (redirects)
- Support for summary content divider (
<!--more-->) - HTML & shortcodes supported in summary (when using divider)
- Complete overhaul of the documentation site
- Added "Minutes to Read" functionality
- Support for a custom 404 page
- Cleanup of how content organization is handled
- Loads of unit and performance tests
- Integration with Travis CI
- Static directory now watched and copied on any addition or modification
- Support for relative permalinks
- Fixed watching being triggered multiple times for the same event
- Watch now ignores temp files (as created by Vim)
- Configurable number of posts on homepage
- Front matter supports multiple types (int, string, date, float)
- Indexes can now use a default template
- Addition of truncated bool to content to determine if should show 'more' link
- Support for
linkTitles - Better handling of most errors with directions on how to resolve
- Support for more date / time formats
- Support for Go 1.2
- Loads more... see commit log for full list.
v0.8
please read the docs as a few options have changed in this release
- Added support for pretty urls (filename/index.html vs filename.html)
- Hugo supports a destination directory
- Will efficiently sync content in static to destination directory
- Cleaned up options.. now with support for short and long options
- Added support for TOML
- Added support for YAML
- Added support for Previous & Next
- Added support for indexes for the indexes
- Better Windows compatibility
- Support for series
- Adding verbose output
- Loads of bugfixes
v0.7
As the first public release here's a bit about what Hugo can do so far.
- 0.7.0 July 4, 2013
- Hugo now includes a simple server
- First public release
- 0.6.0 July 2, 2013
- Hugo includes an example documentation site which it builds
- 0.5.0 June 25, 2013
- Hugo is quite usable and able to build spf13.com