From a1c8d046f9980db615fdac67ccf7f3bf87a7d0e0 Mon Sep 17 00:00:00 2001 From: Ryan Watters Date: Mon, 13 Mar 2017 10:51:22 -0500 Subject: [PATCH] Add GH milestones to roadmap, and update Snap/Ubuntu in installing.md --- content/about/roadmap.md | 12 +++++--- content/functions/urlize.md | 2 +- content/functions/where.md | 10 +++---- content/getting-started/installing.md | 41 ++++++++++++++++++--------- 4 files changed, 42 insertions(+), 23 deletions(-) diff --git a/content/about/roadmap.md b/content/about/roadmap.md index 33e6c8012..50e9d43cf 100644 --- a/content/about/roadmap.md +++ b/content/about/roadmap.md @@ -13,13 +13,15 @@ aliases: [/meta/roadmap] toc: false --- -In no particular order, here is what is currently being worked on for the Hugo project: +To track Hugo's progress, see our [GitHub Milestones][milestones]. + +In no particular order, here are some other features currently being worked on for the Hugo project: * Intelligently related posts ({{< gh 98 >}}) * Even easier deployment to S3, SSH, GitHub, rsync. Give the [hosting and deployment][] section a shot. * Import from other website systems. There are already [existing migration tools][migrate], but they don’t cover all major platforms. -* An interactive web-based editor (See the [related Discuss thread][]) -* Additional [themes][], which are always ongoing and contributions are welcome! +* An interactive web-based editor (See the [related forum thread][]) +* Additional [themes][], which are always ongoing and [contributions are welcome][themescontrib]! * Dynamic image resizing via shortcodes ({{< gh 1014 >}}) * Native support for additional content formats (AsciiDoc {{< gh 1435>}}, reST {{< gh 1436 >}}) * And, last but not least, [***your*** best ideas!][] @@ -36,8 +38,10 @@ Feel free to [contribute to Hugo's development][devcontribute], [improve Hugo's [doccontribute]: /contribute/documentation/ [hosting and deployment]: /hosting-and-deployment/ [migrate]: /tools/migrations/ +[milestones]: https://github.com/spf13/hugo/milestone/14 [newissue]: https://github.com/spf13/hugo/issues/ -[related Discuss thread]: https://discuss.gohugo.io/t/web-based-editor/155 +[related forum thread]: https://discuss.gohugo.io/t/web-based-editor/155 [themes]: /themes/ +[themescontrib]: /contribute/themes/ [tutorials]: /tutorials [***your*** best ideas!]: /contribute/ \ No newline at end of file diff --git a/content/functions/urlize.md b/content/functions/urlize.md index a3a5b61cc..0ed1529a8 100644 --- a/content/functions/urlize.md +++ b/content/functions/urlize.md @@ -31,7 +31,7 @@ tags = ["pizza","beer","hot dogs"] The following might be used as a partial within a [single page template][singletemplate]: -{{% code file="layouts/partials/content-header.html" %}} +{{% code file="layouts/partials/content-header.html" download="content-header.html" %}} ```html

{{.Title}}

diff --git a/content/functions/where.md b/content/functions/where.md index 7ef59694c..10e7801d7 100644 --- a/content/functions/where.md +++ b/content/functions/where.md @@ -11,7 +11,7 @@ tags: [filtering] signature: workson: [lists,taxonomies,terms,groups] hugoversion: -relatedfuncs: [intersect,first] +relatedfuncs: [intersect,first,after,last] deprecated: false toc: true needsexample: true @@ -19,7 +19,7 @@ needsexample: true `where` filters an array to only the elements containing a matching value for a given field. -```golang +```html {{ range where .Data.Pages "Section" "post" }} {{ .Content }} {{ end }} @@ -33,7 +33,7 @@ series: golang +++ ``` -```golang +```html {{ range where .Site.Pages "Params.series" "golang" }} {{ .Content }} {{ end }} @@ -41,7 +41,7 @@ series: golang It can also be used with the logical operators `!=`, `>=`, `in`, etc. Without an operator, `where` compares a given field with a matching value equivalent to `=`. -```golang +```html {{ range where .Data.Pages "Section" "!=" "post" }} {{ .Content }} {{ end }} @@ -114,7 +114,7 @@ The following grabs the first five content files in `post` using the [default or You can also nest `where` clauses to drill down on lists of content by more than one parameter. The following first grabs all pages in the "blog" section and then ranges through the result of the first `where` clause and finds all pages that are *not* featured: -``` +```html {{ range where (where .Data.Pages "Section" "blog" ) ".Params.featured" "!=" "true" }} ``` diff --git a/content/getting-started/installing.md b/content/getting-started/installing.md index 6500c6b72..adbcef3cc 100644 --- a/content/getting-started/installing.md +++ b/content/getting-started/installing.md @@ -418,7 +418,33 @@ C:\Hugo\Sites\example.com>dir ## Linux -### Installing From Snap +### Debian/Ubuntu and Arch + +Hugo has been included in Debian and Ubuntu since 2016 and can be installed as a traditional `.deb` package via `apt`: + +```sh +sudo apt install hugo +``` + +#### Pros + +* Native Debian/Ubuntu package maintained by Debian Developers +* Pre-installed bash completion script and `man` pages + +#### Cons + +* Might not be the latest version, especially if you are using an older, stable version (e.g., Ubuntu 16.04 LTS). Until backports and PPA are available, you may consider installing the Hugo snap package to get the latest version of Hugo, as described below. + +You can also install Hugo from the [Arch user repository](https://aur.archlinux.org/) on Arch Linux or derivatives such as Manjaro. + +Be aware that Hugo is built from source. This means that additional tools like [Git](https://git-scm.com) and [Go](https://golang.org/doc/install) will be installed as well. + +```bash +sudo pacman -S yaourt +yaourt -S hugo +``` + +### Installing Hugo as a Snap Package In any of the [Linux distributions that support snaps](http://snapcraft.io/docs/core/install): @@ -427,20 +453,9 @@ snap install hugo ``` {{% note %}} -Snap Hugo users may get a `Resource temporarily unavailable` runtime error. This is because non-root users may only write inside two specific directories for most snaps. You can find a workaround using the `home` plug at [snapcraft.io](https://snapcraft.io/docs/reference/interfaces). More information is also available [in this related GitHub issue](https://github.com/spf13/hugo/issues/3143). +Hugo-as-a-snap can write only inside the user’s `$HOME `directory---and gvfs-mounted directories owned by the user---because of Snaps’ confinement and security model. More information is also available [in this related GitHub issue](https://github.com/spf13/hugo/issues/3143). {{% /note %}} -### Arch-based distributions - -Install Hugo from the [Arch user repository](https://aur.archlinux.org/) on Arch Linux or derivatives like Manjaro. - -Be aware that Hugo is built from source. This means that additional tools like [Git](https://git-scm.com) and [Go](https://golang.org/doc/install) will be installed as well. - -```bash -sudo pacman -S yaourt -yaourt -S hugo -``` - ## Upgrading Hugo Upgrading Hugo is as easy as downloading and replacing the executable you’ve