From 37c69054e294bf554be03cf7e4c01e1f586e6943 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Thu, 6 Jul 2017 10:25:46 +0200 Subject: [PATCH] Squashed 'docs/' changes from 5d9a6703..f3c88b08 f3c88b08 Add warning on GitInfo and Shallow Clones fa5be591 Make the two common Taxonomy templates explicit 4a81c507 Update pull request link in showcase.html f751e57a Update christianmendoza.me in the showcase d582419b Remove commit message prefix from showcase addition guide d12791cf Fix path for screenshot in showcase addition guide e487b916 Add invincible.site to the showcase c85cfccf Update guide for showcase additions c44b31c1 Fix spelling dc10d7f6 Add slightly better GitHub install description 2611980f Revert "Add workaround to Fetch from GitHub documentation" b2e56907 Fix Git commit link in footer b025a638 Regenerate commands docs for v0.24.1 0741ad08 Update README.md 942d130a Add branch info to README e8c36390 Set hugoDocs/master to 0.24.1 c4e21471 Add workaround to Fetch from GitHub documentation db0a3c08 Fix typo in release note git-subtree-dir: docs git-subtree-split: f3c88b081022c945f010cdbfcd25e0008e0c3f5b --- README.md | 10 ++++++++ config.toml | 2 +- content/commands/hugo.md | 4 ++-- content/commands/hugo_benchmark.md | 4 ++-- content/commands/hugo_check.md | 4 ++-- content/commands/hugo_check_ulimit.md | 4 ++-- content/commands/hugo_config.md | 4 ++-- content/commands/hugo_convert.md | 4 ++-- content/commands/hugo_convert_toJSON.md | 4 ++-- content/commands/hugo_convert_toTOML.md | 4 ++-- content/commands/hugo_convert_toYAML.md | 4 ++-- content/commands/hugo_env.md | 4 ++-- content/commands/hugo_gen.md | 4 ++-- content/commands/hugo_gen_autocomplete.md | 4 ++-- content/commands/hugo_gen_doc.md | 4 ++-- content/commands/hugo_gen_man.md | 4 ++-- content/commands/hugo_import.md | 4 ++-- content/commands/hugo_import_jekyll.md | 4 ++-- content/commands/hugo_list.md | 4 ++-- content/commands/hugo_list_drafts.md | 4 ++-- content/commands/hugo_list_expired.md | 4 ++-- content/commands/hugo_list_future.md | 4 ++-- content/commands/hugo_new.md | 4 ++-- content/commands/hugo_new_site.md | 4 ++-- content/commands/hugo_new_theme.md | 4 ++-- content/commands/hugo_server.md | 4 ++-- content/commands/hugo_undraft.md | 4 ++-- content/commands/hugo_version.md | 4 ++-- content/community/contributing.md | 8 +++---- content/extras/gitinfo.md | 6 ++++- content/overview/installing.md | 6 +++-- content/release-notes/0.24.1-relnotes.md | 2 +- content/showcase/christianmendoza.md | 4 ++-- content/showcase/invincible.md | 15 ++++++++++++ content/taxonomies/templates.md | 28 ++++++++++++++++------ layouts/partials/footer.html | 2 +- layouts/section/showcase.html | 2 +- static/img/christianmendoza-tn.jpg | Bin 55934 -> 42354 bytes static/img/invincible-tn.jpg | Bin 0 -> 25540 bytes 39 files changed, 117 insertions(+), 72 deletions(-) create mode 100644 content/showcase/invincible.md create mode 100644 static/img/invincible-tn.jpg diff --git a/README.md b/README.md index 9e89a0383..60a554e54 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,13 @@ # Hugo Docs Documentation site for [Hugo](https://github.com/gohugoio/hugo), the very fast and flexible static site generator built with love in GoLang. + +## Branches + +* The `master` branch is the **current Hugo version** and will be auto-deployed to [gohugo.io/](https://gohugo.io/). +* Anything not relevant to the current Hugo version goes into the `dev` branch. +* Changes in [hugo/docs](https://github.com/gohugoio/hugo/tree/master/docs) will, in general, be merged once every release, but can be manually merged/cherry picked if needed. This goes both ways. +* All contributions that is not tightly coupled with code changes, should be made directly to `hugoDocs`. +* But we also merge PRs into [hugo/docs](https://github.com/gohugoio/hugo/tree/master/docs), but preferably changes that is related to the code in the PR itself + +To summarize, we have two branches in this repository: `master` (current Hugo) and `dev` (next Hugo). diff --git a/config.toml b/config.toml index 31f5e0099..a36734186 100644 --- a/config.toml +++ b/config.toml @@ -26,7 +26,7 @@ notAlternative = true [params] description = "Documentation of Hugo, a fast and flexible static site generator built with love by spf13, bep and friends in Go" author = "Steve Francia (spf13) and friends" - release = "0.25-DEV" + release = "0.24.1" [taxonomies] tag = "tags" diff --git a/content/commands/hugo.md b/content/commands/hugo.md index 90862cf21..0e02a8a9b 100644 --- a/content/commands/hugo.md +++ b/content/commands/hugo.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo" slug: hugo url: /commands/hugo/ @@ -77,4 +77,4 @@ hugo [flags] * [hugo undraft](/commands/hugo_undraft/) - Undraft changes the content's draft status from 'True' to 'False' * [hugo version](/commands/hugo_version/) - Print the version number of Hugo -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_benchmark.md b/content/commands/hugo_benchmark.md index 2bfb1c8d3..acef140a3 100644 --- a/content/commands/hugo_benchmark.md +++ b/content/commands/hugo_benchmark.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo benchmark" slug: hugo_benchmark url: /commands/hugo_benchmark/ @@ -69,4 +69,4 @@ hugo benchmark [flags] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_check.md b/content/commands/hugo_check.md index ae686559a..1cab62f3e 100644 --- a/content/commands/hugo_check.md +++ b/content/commands/hugo_check.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo check" slug: hugo_check url: /commands/hugo_check/ @@ -34,4 +34,4 @@ Contains some verification checks * [hugo](/commands/hugo/) - hugo builds your site * [hugo check ulimit](/commands/hugo_check_ulimit/) - Check system ulimit settings -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_check_ulimit.md b/content/commands/hugo_check_ulimit.md index 90ef8b030..33dae348f 100644 --- a/content/commands/hugo_check_ulimit.md +++ b/content/commands/hugo_check_ulimit.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo check ulimit" slug: hugo_check_ulimit url: /commands/hugo_check_ulimit/ @@ -38,4 +38,4 @@ hugo check ulimit [flags] ### SEE ALSO * [hugo check](/commands/hugo_check/) - Contains some verification checks -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_config.md b/content/commands/hugo_config.md index 1504c0788..f15d28f04 100644 --- a/content/commands/hugo_config.md +++ b/content/commands/hugo_config.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo config" slug: hugo_config url: /commands/hugo_config/ @@ -37,4 +37,4 @@ hugo config [flags] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_convert.md b/content/commands/hugo_convert.md index 67b9f870b..62005e6f9 100644 --- a/content/commands/hugo_convert.md +++ b/content/commands/hugo_convert.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo convert" slug: hugo_convert url: /commands/hugo_convert/ @@ -41,4 +41,4 @@ See convert's subcommands toJSON, toTOML and toYAML for more information. * [hugo convert toTOML](/commands/hugo_convert_totoml/) - Convert front matter to TOML * [hugo convert toYAML](/commands/hugo_convert_toyaml/) - Convert front matter to YAML -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_convert_toJSON.md b/content/commands/hugo_convert_toJSON.md index a2da44ec4..f6136ad4a 100644 --- a/content/commands/hugo_convert_toJSON.md +++ b/content/commands/hugo_convert_toJSON.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo convert toJSON" slug: hugo_convert_toJSON url: /commands/hugo_convert_tojson/ @@ -41,4 +41,4 @@ hugo convert toJSON [flags] ### SEE ALSO * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_convert_toTOML.md b/content/commands/hugo_convert_toTOML.md index 8a48f52f7..229004e78 100644 --- a/content/commands/hugo_convert_toTOML.md +++ b/content/commands/hugo_convert_toTOML.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo convert toTOML" slug: hugo_convert_toTOML url: /commands/hugo_convert_totoml/ @@ -41,4 +41,4 @@ hugo convert toTOML [flags] ### SEE ALSO * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_convert_toYAML.md b/content/commands/hugo_convert_toYAML.md index 5d85825fe..3c0cafe46 100644 --- a/content/commands/hugo_convert_toYAML.md +++ b/content/commands/hugo_convert_toYAML.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo convert toYAML" slug: hugo_convert_toYAML url: /commands/hugo_convert_toyaml/ @@ -41,4 +41,4 @@ hugo convert toYAML [flags] ### SEE ALSO * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_env.md b/content/commands/hugo_env.md index 7e268546f..857f03701 100644 --- a/content/commands/hugo_env.md +++ b/content/commands/hugo_env.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo env" slug: hugo_env url: /commands/hugo_env/ @@ -37,4 +37,4 @@ hugo env [flags] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_gen.md b/content/commands/hugo_gen.md index 7e753c4e1..c2521aeba 100644 --- a/content/commands/hugo_gen.md +++ b/content/commands/hugo_gen.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo gen" slug: hugo_gen url: /commands/hugo_gen/ @@ -36,4 +36,4 @@ A collection of several useful generators. * [hugo gen doc](/commands/hugo_gen_doc/) - Generate Markdown documentation for the Hugo CLI. * [hugo gen man](/commands/hugo_gen_man/) - Generate man pages for the Hugo CLI -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_gen_autocomplete.md b/content/commands/hugo_gen_autocomplete.md index 455322def..df89faab6 100644 --- a/content/commands/hugo_gen_autocomplete.md +++ b/content/commands/hugo_gen_autocomplete.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo gen autocomplete" slug: hugo_gen_autocomplete url: /commands/hugo_gen_autocomplete/ @@ -55,4 +55,4 @@ hugo gen autocomplete [flags] ### SEE ALSO * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_gen_doc.md b/content/commands/hugo_gen_doc.md index d7b2f719b..48402d12c 100644 --- a/content/commands/hugo_gen_doc.md +++ b/content/commands/hugo_gen_doc.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo gen doc" slug: hugo_gen_doc url: /commands/hugo_gen_doc/ @@ -44,4 +44,4 @@ hugo gen doc [flags] ### SEE ALSO * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_gen_man.md b/content/commands/hugo_gen_man.md index 14c403d9a..efec000ee 100644 --- a/content/commands/hugo_gen_man.md +++ b/content/commands/hugo_gen_man.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo gen man" slug: hugo_gen_man url: /commands/hugo_gen_man/ @@ -40,4 +40,4 @@ hugo gen man [flags] ### SEE ALSO * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_import.md b/content/commands/hugo_import.md index ce58bb3af..aafe8e4f7 100644 --- a/content/commands/hugo_import.md +++ b/content/commands/hugo_import.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo import" slug: hugo_import url: /commands/hugo_import/ @@ -36,4 +36,4 @@ Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_p * [hugo](/commands/hugo/) - hugo builds your site * [hugo import jekyll](/commands/hugo_import_jekyll/) - hugo import from Jekyll -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_import_jekyll.md b/content/commands/hugo_import_jekyll.md index 89c4c47c5..f3427d04d 100644 --- a/content/commands/hugo_import_jekyll.md +++ b/content/commands/hugo_import_jekyll.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo import jekyll" slug: hugo_import_jekyll url: /commands/hugo_import_jekyll/ @@ -40,4 +40,4 @@ hugo import jekyll [flags] ### SEE ALSO * [hugo import](/commands/hugo_import/) - Import your site from others. -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_list.md b/content/commands/hugo_list.md index d9c609596..818c1520e 100644 --- a/content/commands/hugo_list.md +++ b/content/commands/hugo_list.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo list" slug: hugo_list url: /commands/hugo_list/ @@ -39,4 +39,4 @@ List requires a subcommand, e.g. `hugo list drafts`. * [hugo list expired](/commands/hugo_list_expired/) - List all posts already expired * [hugo list future](/commands/hugo_list_future/) - List all posts dated in the future -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_list_drafts.md b/content/commands/hugo_list_drafts.md index d84dd56f5..4ca7319b1 100644 --- a/content/commands/hugo_list_drafts.md +++ b/content/commands/hugo_list_drafts.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo list drafts" slug: hugo_list_drafts url: /commands/hugo_list_drafts/ @@ -38,4 +38,4 @@ hugo list drafts [flags] ### SEE ALSO * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_list_expired.md b/content/commands/hugo_list_expired.md index e4304a40c..fcc48085d 100644 --- a/content/commands/hugo_list_expired.md +++ b/content/commands/hugo_list_expired.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo list expired" slug: hugo_list_expired url: /commands/hugo_list_expired/ @@ -39,4 +39,4 @@ hugo list expired [flags] ### SEE ALSO * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_list_future.md b/content/commands/hugo_list_future.md index 530b4a68f..46e472534 100644 --- a/content/commands/hugo_list_future.md +++ b/content/commands/hugo_list_future.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo list future" slug: hugo_list_future url: /commands/hugo_list_future/ @@ -39,4 +39,4 @@ hugo list future [flags] ### SEE ALSO * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_new.md b/content/commands/hugo_new.md index bf230a25b..25eb3d803 100644 --- a/content/commands/hugo_new.md +++ b/content/commands/hugo_new.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo new" slug: hugo_new url: /commands/hugo_new/ @@ -47,4 +47,4 @@ hugo new [path] [flags] * [hugo new site](/commands/hugo_new_site/) - Create a new site (skeleton) * [hugo new theme](/commands/hugo_new_theme/) - Create a new theme -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_new_site.md b/content/commands/hugo_new_site.md index 8c097e727..586d4db12 100644 --- a/content/commands/hugo_new_site.md +++ b/content/commands/hugo_new_site.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo new site" slug: hugo_new_site url: /commands/hugo_new_site/ @@ -42,4 +42,4 @@ hugo new site [path] [flags] ### SEE ALSO * [hugo new](/commands/hugo_new/) - Create new content for your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_new_theme.md b/content/commands/hugo_new_theme.md index 317de98b7..355978fc1 100644 --- a/content/commands/hugo_new_theme.md +++ b/content/commands/hugo_new_theme.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo new theme" slug: hugo_new_theme url: /commands/hugo_new_theme/ @@ -41,4 +41,4 @@ hugo new theme [name] [flags] ### SEE ALSO * [hugo new](/commands/hugo_new/) - Create new content for your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_server.md b/content/commands/hugo_server.md index 4c23c93fc..3171a8556 100644 --- a/content/commands/hugo_server.md +++ b/content/commands/hugo_server.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo server" slug: hugo_server url: /commands/hugo_server/ @@ -83,4 +83,4 @@ hugo server [flags] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_undraft.md b/content/commands/hugo_undraft.md index e082d0a15..5cac7b401 100644 --- a/content/commands/hugo_undraft.md +++ b/content/commands/hugo_undraft.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo undraft" slug: hugo_undraft url: /commands/hugo_undraft/ @@ -39,4 +39,4 @@ hugo undraft path/to/content [flags] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/commands/hugo_version.md b/content/commands/hugo_version.md index a4bdbce01..d1ee4a4c9 100644 --- a/content/commands/hugo_version.md +++ b/content/commands/hugo_version.md @@ -1,5 +1,5 @@ --- -date: 2017-06-22T21:51:29+02:00 +date: 2017-06-29T08:42:09+02:00 title: "hugo version" slug: hugo_version url: /commands/hugo_version/ @@ -37,4 +37,4 @@ hugo version [flags] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 22-Jun-2017 +###### Auto generated by spf13/cobra on 29-Jun-2017 diff --git a/content/community/contributing.md b/content/community/contributing.md index 98530f4b5..052311911 100644 --- a/content/community/contributing.md +++ b/content/community/contributing.md @@ -60,7 +60,7 @@ You **must use govendor** to fetch Hugo's dependencies. You got your new website running and it's powered by Hugo? Great. You can add your website with a few steps to the [showcase](/showcase/). -First, make sure that you created a [fork](https://help.github.com/articles/fork-a-repo/) of Hugo on GitHub and cloned your fork on your local computer. Next, create a separate branch for your additions: +First, make sure that you created a [fork](https://help.github.com/articles/fork-a-repo/) of the [`hugoDocs`](https://github.com/gohugoio/hugodocs) repository on GitHub and cloned your fork on your local computer. **Next, create a separate branch for your additions**: ``` # You can choose a different descriptive branch name if you like @@ -94,7 +94,7 @@ title: example Add at least values for `sitelink`, `title`, `description` and a path for `thumbnail`. -Furthermore, we need to create the thumbnail of your website. **It's important that the thumbnail has the required dimensions of 600px by 400px.** Give your thumbnail a name like `example-tn.png`. Save it under `docs/static/img/`. +Furthermore, we need to create the thumbnail of your website. **It's important that the thumbnail has the required dimensions of 600px by 400px.** Give your thumbnail a name like `example-tn.png`. Save it under `static/img/`. Check a last time that everything works as expected. Start Hugo's built-in server in order to inspect your local copy of the showcase in the browser: @@ -102,9 +102,9 @@ Check a last time that everything works as expected. Start Hugo's built-in serve If everything looks fine, we are ready to commit your additions. For the sake of best practices, please make sure that your commit follows our [code contribution guideline](https://github.com/gohugoio/hugo#code-contribution-guideline). - git commit -m"docs: Add example.com to the showcase" + git commit -m"Add example.com to the showcase" -Last but not least, we're ready to create a [pull request](https://github.com/gohugoio/hugo/compare). +Last but not least, we're ready to create a [pull request](https://github.com/gohugoio/hugoDocs/compare). Don't forget to accept the contributor license agreement. Click on the yellow badge in the automatically added comment in the pull request. diff --git a/content/extras/gitinfo.md b/content/extras/gitinfo.md index d29641bcb..d267e0e3f 100644 --- a/content/extras/gitinfo.md +++ b/content/extras/gitinfo.md @@ -44,7 +44,11 @@ Subject : commit message subject, e.g. `tpl: Add custom index function` -## Performance Considerations +## Other Considerations The Git integrations should be fairly performant, but it does add some time to the build, which depends somewhat on the Git history size. +The accuracy of data depends on the underlying local git respository. If the local repository is a *shallow clone*, then any file that hasn't been modified in the truncated history will default to data in the oldest commit. In particular, if the respository has been cloned using `--depth=1` then every file will the exact same `GitInfo` data -- that of the only commit in the repository. + +In particular, many CI/CD systems such as [travis-ci.org](https://travis-ci.org) default to a clone depth of 50 which is unlikely to be deep enough. You can explicitly add back the missing history using using `git fetch --unshallow` or [make the initial checkout deeper](https://docs.travis-ci.com/user/customizing-the-build#Git-Clone-Depth). + diff --git a/content/overview/installing.md b/content/overview/installing.md index 895fae2af..fb7315c19 100644 --- a/content/overview/installing.md +++ b/content/overview/installing.md @@ -123,14 +123,16 @@ Therefore, a simple `go get` is not supported since `go get` is not vendor-aware You **must use govendor** to fetch Hugo's dependencies. ### Fetch from GitHub + + The commands below assume that you have [Go](https://golang.org/dl/) installed with your `$GOPATH` set. go get github.com/kardianos/govendor govendor get github.com/gohugoio/hugo `govendor get` will fetch Hugo and all its dependent libraries to -`$HOME/go/src/github.com/gohugoio/hugo`, and compile everything into a final `hugo` +`$GOPATH/src/github.com/gohugoio/hugo`, and compile everything into a final `hugo` (or `hugo.exe`) executable, which you will find sitting inside -`$HOME/go/bin/`, all ready to go! +`$GOPATH/go/bin/`, all ready to go! *Windows users: where you see the `$HOME` environment variable above, replace it with `%USERPROFILE%`.* diff --git a/content/release-notes/0.24.1-relnotes.md b/content/release-notes/0.24.1-relnotes.md index 1c7e57c70..438c5c433 100644 --- a/content/release-notes/0.24.1-relnotes.md +++ b/content/release-notes/0.24.1-relnotes.md @@ -6,7 +6,7 @@ title: 0.24.1 -This release fixes some important **archetype-related regressions** from the recent Hugo 0.24-relase. +This release fixes some important **archetype-related regressions** from the recent Hugo 0.24-release. ## Fixes diff --git a/content/showcase/christianmendoza.md b/content/showcase/christianmendoza.md index 6d18735d9..6b36a53d8 100644 --- a/content/showcase/christianmendoza.md +++ b/content/showcase/christianmendoza.md @@ -1,10 +1,10 @@ --- +lastmod: 2017-06-30 date: 2016-10-16T13:30:47-04:00 -date: 2016-12-20T17:21:00-05:00 description: "Personal site" license: "" licenseLink: "" -sitelink: https://christianmendoza.me/ +sitelink: https://www.christianmendoza.me/ sourceLink: https://github.com/christianmendoza/christianmendoza.me tags: - personal diff --git a/content/showcase/invincible.md b/content/showcase/invincible.md new file mode 100644 index 000000000..2030e93fb --- /dev/null +++ b/content/showcase/invincible.md @@ -0,0 +1,15 @@ +--- +date: 2017-07-01T01:11:00Z +description: "The Invincible: The tale of a disillusioned prince" +license: "Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License" +licenseLink: "https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode" +sitelink: https://invincible.site/ +sourceLink: https://github.com/shazic/the_invincible +tags: +- personal +- blog +- graphic novel +thumbnail: /img/invincible-tn.jpg +title: Invincible +--- + diff --git a/content/taxonomies/templates.md b/content/taxonomies/templates.md index 0a44d5b19..fdb6cd530 100644 --- a/content/taxonomies/templates.md +++ b/content/taxonomies/templates.md @@ -13,14 +13,28 @@ title: Taxonomy Templates weight: 30 --- -There are two different templates that the use of taxonomies will require you to provide. +Taxonomy templates should be placed in the folder `layouts/taxonomy`. +When Taxonomy term template is provided for a Taxonomy, a section is rendered for it at `/SINGULAR/`. (eg. `/tag/` or `/category/`) -Both templates are covered in detail in the templates section. +There are two different templates that the use of taxonomies will require you to provide: -A [list template](/templates/list/) is any template that will be used to render multiple pieces of -content in a single html page. This template will be used to generate -all the automatically created taxonomy pages. +### All content attached to taxonomy -A [taxonomy terms template](/templates/terms/) is a template used to -generate the list of terms for a given template. +A [taxonomy terms template](/templates/terms/) is a template which has access to all the full Taxonomy structure. +This Template is commonly used to generate the list of terms for a given template. + +#### layouts/taxonomy/SINGULAR.terms.html + +For example: `tag.terms.html`, `category.terms.html`, or your custom Taxonomy: `actor.terms.html` + +### All content attached to term + +A [list template](/templates/list/) is used to automatically generate pages for each unique term found. + + +#### layouts/taxonomy/SINGULAR.html + +For example: `tag.html`, `category.html`, or your custom Taxonomy: `actor.html` + +Terms are rendered at `SINGULAR/TERM/`. (eg. `/tag/book/` or `/category/news/`) diff --git a/layouts/partials/footer.html b/layouts/partials/footer.html index 9734aa983..6f9976448 100644 --- a/layouts/partials/footer.html +++ b/layouts/partials/footer.html @@ -1,6 +1,6 @@