Add gh shortcode to docs site

The `gh` shortcode has two modes: users and issues.  For user mode, pass a list
of `@username` arguments.  For the issues/PR mode, pass a list of issue or PR
numbers.  PRs link to the "issues/" URL since Github redirects to the correct
URL.

Thanks to @ryanclarke for suggesting an improved template.
This commit is contained in:
Cameron Moore 2015-11-25 09:01:22 -06:00 committed by Anthony Fok
parent d48781badf
commit 6812229bb8
2 changed files with 61 additions and 64 deletions

View file

@ -43,64 +43,64 @@ introduces the ability to render and serve directly from memory resulting in
30%+ lower render times. 30%+ lower render times.
Huge thanks to all who participated in this release. A special thanks to Huge thanks to all who participated in this release. A special thanks to
[@bep](https://github.com/bep) who led the development of Hugo this release again, {{< gh "@bep" >}} who led the development of Hugo this release again,
[@anthonyfok](https://github.com/anthonyfok), {{< gh "@anthonyfok" >}},
[@eparis](https://github.com/eparis), {{< gh "@eparis" >}},
[@tatsushid](https://github.com/tatsushid) and {{< gh "@tatsushid" >}} and
[@DigitalCraftsman](https://github.com/digitalcraftsman/) {{< gh "@DigitalCraftsman" >}}
## New features ## New features
* new `hugo import jekyll` command. [1469](https://github.com/spf13/hugo/pull/1469) * new `hugo import jekyll` command. {{< gh 1469 >}}
* The new `Param` convenience method on `Page` and `Node` can be used to get the most specific parameter value for a given key. [1462](https://github.com/spf13/hugo/issues/1462) * The new `Param` convenience method on `Page` and `Node` can be used to get the most specific parameter value for a given key. {{< gh 1462 >}}
* Several new information elements have been added to `Page` and `Node`: * Several new information elements have been added to `Page` and `Node`:
* `RuneCount`: The number of [runes](http://blog.golang.org/strings) in the content, excluding any whitespace. This may be a good alternative to `.WordCount` for Japanese and other CJK languages where a word-split by spaces makes no sense. [1266](https://github.com/spf13/hugo/issues/1266) * `RuneCount`: The number of [runes](http://blog.golang.org/strings) in the content, excluding any whitespace. This may be a good alternative to `.WordCount` for Japanese and other CJK languages where a word-split by spaces makes no sense. {{< gh 1266 >}}
* `RawContent`: Raw Markdown as a string. One use case may be of embedding remarkjs.com slides. * `RawContent`: 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. * `IsHome`: tells the truth about whether you're on the home page or not.
## Improvements ## Improvements
* `hugo server` now builds ~30%+ faster by rendering to memory instead of disk. To get the old behavior, start the server with `--renderToDisk=true`. * `hugo server` now 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. * Hugo now supports dynamic reloading of the config file when watching.
* We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. [1181](https://github.com/spf13/hugo/issues/1181) * We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. {{< gh 1181 >}}
* Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. [917] (https://github.com/spf13/hugo/issues/917) * Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. {{< gh 917 >}}
* Paginator now also supports page groups. [1274](https://github.com/spf13/hugo/issues/1274) * Paginator now also supports page groups. {{< gh 1274 >}}
* Markdown improvements: * Markdown improvements:
* Hugo now supports GitHub-flavoured markdown code fences for highlighting for `md`-files (Blackfriday rendered markdown) and `mmark` files (MMark rendered markdown). [362] (https://github.com/spf13/hugo/issues/362)[1258](https://github.com/spf13/hugo/issues/1258) * Hugo now supports GitHub-flavoured markdown code fences for highlighting for `md`-files (Blackfriday rendered markdown) and `mmark` files (MMark rendered markdown). {{< gh 362 1258 >}}
* Several new Blackfriday options are added: * Several new Blackfriday options are added:
* Option to disable Blackfriday's `Smartypants`. * Option to disable Blackfriday's `Smartypants`.
* Option for Blackfriday to open links in a new window/tab. [1220](https://github.com/spf13/hugo/issues/1220) * Option for Blackfriday to open links in a new window/tab. {{< gh 1220 >}}
* Option to disable Blackfriday's LaTeX style dashes [1231](https://github.com/spf13/hugo/issues/1231) * Option to disable Blackfriday's LaTeX style dashes {{< gh 1231 >}}
* Definition lists extension support. * Definition lists extension support.
* `Scratch` now has built-in `map` support. * `Scratch` now has built-in `map` support.
* We now fall back to `link title` for the default page sort. [1299](https://github.com/spf13/hugo/issues/1299) * We now fall back to `link title` for the default page sort. {{< gh 1299 >}}
* Some notable new configuration options: * Some notable new configuration options:
* `IgnoreFiles` can be set with a list of Regular Expressions that matches files to be ignored during build. [1189](https://github.com/spf13/hugo/issues/1189) * `IgnoreFiles` can be set with a list of Regular Expressions that matches files to be ignored during build. {{< gh 1189 >}}
* `PreserveTaxonomyNames`, when set to `true`, will preserve what you type as the taxonomy name both in the folders created and the taxonomy `key`, but it will be normalized for the URL. [1180](https://github.com/spf13/hugo/issues/1180) * `PreserveTaxonomyNames`, when set to `true`, will preserve what you type as the taxonomy name both in the folders created and the taxonomy `key`, but it will be normalized for the URL. {{< gh 1180 >}}
* `hugo gen` can now generate man files, bash auto complete and markdown documentation * `hugo gen` can now generate man files, bash auto complete and markdown documentation
* Hugo will now make suggestions when a command is mistyped * Hugo will now make suggestions when a command is mistyped
* Shortcodes now have a boolean `.IsNamedParams` property. [1597](https://github.com/spf13/hugo/pull/1597) * Shortcodes now have a boolean `.IsNamedParams` property. {{< gh 1597 >}}
## New Template Features ## New Template Features
* All template engines: * All template engines:
* The new `dict` function that could be used to pass maps into a template.[1463](https://github.com/spf13/hugo/pull/1463) * The new `dict` function that could be used to pass maps into a template.{{< gh 1463 >}}
* The new `pluralize` and `singularize` template funcs. * The new `pluralize` and `singularize` template funcs.
* The new `base64Decode` and `base64Encode` template funcs. * The new `base64Decode` and `base64Encode` template funcs.
* The `sort` template func now accepts field/key chaining arguments and pointer values. [1330](https://github.com/spf13/hugo/issues/1330) * The `sort` template func now accepts field/key chaining arguments and pointer values. {{< gh 1330 >}}
* Several fixes for `slicestr` and `substr`, most importantly, they now have full `utf-8`-support. [1190](https://github.com/spf13/hugo/issues/1190) [1333](https://github.com/spf13/hugo/issues/1333) [1347](https://github.com/spf13/hugo/issues/1347) * Several fixes for `slicestr` and `substr`, most importantly, they now have full `utf-8`-support. {{< gh 1190 1333 1347 >}}
* The new `last` template function allows the user to select the last `N` items of a slice. [1148](https://github.com/spf13/hugo/issues/1148) * The new `last` template function allows the user to select the last `N` items of a slice. {{< gh 1148 >}}
* The new `after` func allows the user to select the items after the `Nth` item. [1200] (https://github.com/spf13/hugo/pull/1200) * The new `after` func allows the user to select the items after the `Nth` item. {{< gh 1200 >}}
* Add `time.Time` type support to the `where`, `ge`, `gt`, `le`, and `lt` template functions. * Add `time.Time` type support to the `where`, `ge`, `gt`, `le`, and `lt` template functions.
* It is now possible to use constructs like `where Values ".Param.key" nil` to filter pages that doesn't have a particular parameter. [1232](https://github.com/spf13/hugo/issues/1232) * It is now possible to use constructs like `where Values ".Param.key" nil` to filter pages that doesn't have a particular parameter. {{< gh 1232 >}}
* `getJSON`/`getCSV`: Add retry on invalid content. [1166](https://github.com/spf13/hugo/issues/1166) * `getJSON`/`getCSV`: Add retry on invalid content. {{< gh 1166 >}}
* The new `readDir` func lists local files. [1204](https://github.com/spf13/hugo/pull/1204) * The new `readDir` func lists local files. {{< gh 1204 >}}
* The new `safeJS` function allows the embedding of content into JavaScript contexts in Go templates. * The new `safeJS` function allows the embedding of content into JavaScript contexts in Go templates.
* Get the main site RSS link from any page by accessing the `.Site.RSSLink` property. [1566](https://github.com/spf13/hugo/pull/1566) * Get the main site RSS link from any page by accessing the `.Site.RSSLink` property. {{< gh 1566 >}}
* Ace templates: * Ace templates:
* Base templates now also works in themes. [1215](https://github.com/spf13/hugo/issues/1215). * Base templates now also works in themes. {{< gh 1215 >}}.
* And now also on Windows. [1178](https://github.com/spf13/hugo/issues/1178) * And now also on Windows. {{< gh 1178 >}}
* Full support for Amber templates including all template functions. * Full support for Amber templates including all template functions.
* A built-in template for Google Analytics. [1505](https://github.com/spf13/hugo/pull/1505) * A built-in template for Google Analytics. {{< gh 1505 >}}
* Hugo is now shipped with new built-in shortcodes: [1576](https://github.com/spf13/hugo/issues/1576) * Hugo is now shipped with new built-in shortcodes: {{< gh 1576 >}}
* `youtube` for YouTube videos * `youtube` for YouTube videos
* `vimeo` for Vimeo videos * `vimeo` for Vimeo videos
* `gist` for GitHub gists * `gist` for GitHub gists
@ -109,10 +109,10 @@ Huge thanks to all who participated in this release. A special thanks to
## Bugfixes ## Bugfixes
* Fix data races in page sorting and page reversal. These operations are now also cached. [1293](https://github.com/spf13/hugo/issues/1293) * Fix data races in page sorting and page reversal. These operations are now also cached. {{< gh 1293 >}}
* `page.HasMenuCurrent()` and `node.HasMenuCurrent()` now work correctly in multi-level nested menus. * `page.HasMenuCurrent()` and `node.HasMenuCurrent()` now work correctly in multi-level nested menus.
* Support `Fish and Chips` style section titles. Previously, this would end up as `Fish And Chips`. Now, the first character is made toupper, but the rest are preserved as-is. [1176](https://github.com/spf13/hugo/issues/1176) * Support `Fish and Chips` style section titles. Previously, this would end up as `Fish And Chips`. Now, the first character is made toupper, but the rest are preserved as-is. {{< gh 1176 >}}
* Hugo now removes superfluous p-tags around shortcodes. [1148](https://github.com/spf13/hugo/issues/1148) * Hugo now removes superfluous p-tags around shortcodes. {{< gh 1148 >}}
## Notices ## Notices
* `hugo server` will watch by default now. * `hugo server` will watch by default now.
@ -144,13 +144,13 @@ community.
This release represents over **240 contributions by 36 contributors** to the main This release represents over **240 contributions by 36 contributors** to the main
Hugo codebase. Hugo codebase.
Big shout out to [@bep](https://github.com/bep) who led the development of Hugo Big shout out to {{< gh "@bep" >}} who led the development of Hugo
this release, [@anthonyfok](https://github.com/anthonyfok), this release, {{< gh "@anthonyfok" >}},
[@eparis](https://github.com/eparis), {{< gh "@eparis" >}},
[@SchumacherFM](https://github.com/SchumacherFM), {{< gh "@SchumacherFM" >}},
[@RickCogley](https://github.com/RickCogley) & {{< gh "@RickCogley" >}} &
[@mdhender](https://github.com/mdhender) for their significant contributions {{< gh "@mdhender" >}} for their significant contributions
and [@tatsushid](https://github.com/tatsushid) for his continuous improvements and {{< gh "@tatsushid" >}} for his continuous improvements
to the templates. Also a big thanks to all the theme creators. 11 new themes 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 have been added since last release and the [hugoThemes repo now has previews of
all of all of
@ -177,7 +177,7 @@ Hugo also depends on a lot of other great projects. A big thanks to all of our d
* New template functions: * New template functions:
* `getenv` * `getenv`
* The string functions `substr` and `slicestr` * The string functions `substr` and `slicestr`
*`seq`, a sequence generator very similar to its Gnu counterpart * `seq`, a sequence generator very similar to its Gnu counterpart
* `absURL` and `relURL`, both of which takes the `BaseURL` setting into account * `absURL` and `relURL`, both of which takes the `BaseURL` setting into account
## Improvements ## Improvements
@ -195,7 +195,7 @@ Hugo also depends on a lot of other great projects. A big thanks to all of our d
* Fix crossrefs on Windows. * Fix crossrefs on Windows.
* Fix `eq` and `ne` template functions when used with a raw number combined with the result of `add`, `sub` etc. * Fix `eq` and `ne` template functions when used with a raw number combined with the result of `add`, `sub` etc.
* Fix paginator with uglyurls * Fix paginator with uglyurls
* Fix [#998](https://github.com/spf13/hugo/issues/988), supporting UTF8 characters in Permalinks. * Fix {{< gh 998 >}}, supporting UTF8 characters in Permalinks.
## Notices ## Notices
* To get variable and function names in line with the rest of the Go community, * To get variable and function names in line with the rest of the Go community,
@ -216,19 +216,19 @@ the code changes, the Hugo community has grown significantly and now has over
This release represents **448 contributions by 65 contributors** This release represents **448 contributions by 65 contributors**
A special shout out to [@bep](https://github.com/bep) and A special shout out to {{< gh "@bep" >}} and
[@anthonyfok](https://github.com/anthonyfok) for their new role as Hugo {{< gh "@anthonyfok" >}} for their new role as Hugo
maintainers and their tremendous contributions this release. maintainers and their tremendous contributions this release.
### New major features ### New major features
* Support for [data files](/extras/datafiles/) in [YAML](http://yaml.org/), * Support for [data files](/extras/datafiles/) in [YAML](http://yaml.org/),
[JSON](http://www.json.org/), or [TOML](https://github.com/toml-lang/toml) [JSON](http://www.json.org/), or [TOML](https://github.com/toml-lang/toml)
located in the `data` directory ([#885][]) located in the `data` directory ({{< gh 885 >}})
* Support for [dynamic content](/extras/dynamiccontent/) by loading JSON & CSV * Support for [dynamic content](/extras/dynamiccontent/) by loading JSON & CSV
from remote sources via GetJson and GetCsv in short codes or other layout from remote sources via GetJson and GetCsv in short codes or other layout
files ([#748][]) files ({{< gh 748 >}})
* [Pagination support](/extras/pagination/) for home page, sections and * [Pagination support](/extras/pagination/) for home page, sections and
taxonomies ([#750][]) taxonomies ({{< gh 750 >}})
* Universal sequencing support * Universal sequencing support
* A new, generic Next/Prev functionality is added to all lists of pages * A new, generic Next/Prev functionality is added to all lists of pages
(sections, taxonomies, etc.) (sections, taxonomies, etc.)
@ -237,7 +237,7 @@ maintainers and their tremendous contributions this release.
variables variables
* [Cross Reference](/extras/crossreferences/) support to easily link documents * [Cross Reference](/extras/crossreferences/) support to easily link documents
together with the ref and relref shortcodes. together with the ref and relref shortcodes.
* [Ace](http://ace.yoss.si/) template engine support ([#541][]) * [Ace](http://ace.yoss.si/) template engine support ({{< gh 541 >}})
* A new [shortcode](/extras/shortcodes/) token of `{{</* */>}}` (raw HTML) * A new [shortcode](/extras/shortcodes/) token of `{{</* */>}}` (raw HTML)
alongside the existing `{{%/* */%}}` (Markdown) alongside the existing `{{%/* */%}}` (Markdown)
* A top level `Hugo` variable (on Page & Node) is added with various build * A top level `Hugo` variable (on Page & Node) is added with various build
@ -276,8 +276,8 @@ maintainers and their tremendous contributions this release.
* Configuration of footnote rendering * Configuration of footnote rendering
* Optional support for smart angled quotes, e.g. `"Hugo"` → «Hugo» * Optional support for smart angled quotes, e.g. `"Hugo"` → «Hugo»
* Enable descriptive header IDs * Enable descriptive header IDs
* URLs in XML output is now correctly canonified ([#725][], [#728][], and part * URLs in XML output is now correctly canonified ({{< gh 725 728 >}}, and part
of [#789][]) of {{< gh 789 >}})
### Other improvements ### Other improvements
@ -285,7 +285,7 @@ maintainers and their tremendous contributions this release.
and providing measurable performance improvements overall and providing measurable performance improvements overall
* Changes to docs: * Changes to docs:
* A new [Troubleshooting](/troubleshooting/overview/) section is added * A new [Troubleshooting](/troubleshooting/overview/) section is added
* It's now searchable through Google Custom Search ([#753][]) * It's now searchable through Google Custom Search ({{< gh 753 >}})
* Some new great tutorials: * Some new great tutorials:
* [Automated deployments with * [Automated deployments with
Wercker](/tutorials/automated-deployments/) Wercker](/tutorials/automated-deployments/)
@ -294,21 +294,11 @@ maintainers and their tremendous contributions this release.
* Improved unit test coverage * Improved unit test coverage
* Fixed a lot of Windows-related path issues * Fixed a lot of Windows-related path issues
* Improved error messages for template and rendering errors * Improved error messages for template and rendering errors
* Enabled soft LiveReload of CSS and images ([#490][]) * Enabled soft LiveReload of CSS and images ({{< gh 490 >}})
* Various fixes in RSS feed generation ([#789][]) * Various fixes in RSS feed generation ({{< gh 789 >}})
* `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes * `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes
* A bunch of [bug fixes](https://github.com/spf13/hugo/commits/master) * A bunch of [bug fixes](https://github.com/spf13/hugo/commits/master)
[#490]: https://github.com/spf13/hugo/pull/490 "Pull Request #490: Livereload CSS and images without browser refresh"
[#541]: https://github.com/spf13/hugo/pull/541 "Pull Request #541: Add Ace template engine support"
[#725]: https://github.com/spf13/hugo/issues/725 "Issue #725: CanonifyUrls does not canonicalize urls in RSS"
[#728]: https://github.com/spf13/hugo/issues/728 "Pull Request #728: Add ability to canonify URLs in rendered XML output."
[#748]: https://github.com/spf13/hugo/issues/748 "Feature: GetJson and GetJson in short codes or other layout files"
[#750]: https://github.com/spf13/hugo/issues/750 "Pull Request: Add pagination support for home page, sections and taxonomies"
[#753]: https://github.com/spf13/hugo/issues/753 "Add search to documentation"
[#789]: https://github.com/spf13/hugo/issues/789 "Issue #789: RSS feeds do not validate"
[#885]: https://github.com/spf13/hugo/issues/885 "Feature/datadir"
## **0.12.0** Sept 1, 2014 ## **0.12.0** Sept 1, 2014

View file

@ -0,0 +1,7 @@
{{ range .Params }}
{{ if eq (substr . 0 1) "@" }}
<a href="//github.com/{{ substr . 1 }}">{{ . }}</a>
{{ else }}
<a href="//github.com/spf13/hugo/issues/{{ . }}">{{ . }}</a>
{{ end }}
{{ end }}