mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-29 08:42:08 -05:00
docs: Merge docs commit '37c69054e294bf554be03cf7e4c01e1f586e6943'
This commit is contained in:
commit
e00f5c9c07
39 changed files with 117 additions and 72 deletions
|
@ -1,3 +1,13 @@
|
||||||
# Hugo Docs
|
# Hugo Docs
|
||||||
|
|
||||||
Documentation site for [Hugo](https://github.com/gohugoio/hugo), the very fast and flexible static site generator built with love in GoLang.
|
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).
|
||||||
|
|
|
@ -26,7 +26,7 @@ notAlternative = true
|
||||||
[params]
|
[params]
|
||||||
description = "Documentation of Hugo, a fast and flexible static site generator built with love by spf13, bep and friends in Go"
|
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"
|
author = "Steve Francia (spf13) and friends"
|
||||||
release = "0.25-DEV"
|
release = "0.24.1"
|
||||||
|
|
||||||
[taxonomies]
|
[taxonomies]
|
||||||
tag = "tags"
|
tag = "tags"
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo"
|
title: "hugo"
|
||||||
slug: hugo
|
slug: hugo
|
||||||
url: /commands/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 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
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo benchmark"
|
title: "hugo benchmark"
|
||||||
slug: hugo_benchmark
|
slug: hugo_benchmark
|
||||||
url: /commands/hugo_benchmark/
|
url: /commands/hugo_benchmark/
|
||||||
|
@ -69,4 +69,4 @@ hugo benchmark [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo check"
|
title: "hugo check"
|
||||||
slug: hugo_check
|
slug: hugo_check
|
||||||
url: /commands/hugo_check/
|
url: /commands/hugo_check/
|
||||||
|
@ -34,4 +34,4 @@ Contains some verification checks
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [hugo](/commands/hugo/) - hugo builds your site
|
||||||
* [hugo check ulimit](/commands/hugo_check_ulimit/) - Check system ulimit settings
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo check ulimit"
|
title: "hugo check ulimit"
|
||||||
slug: hugo_check_ulimit
|
slug: hugo_check_ulimit
|
||||||
url: /commands/hugo_check_ulimit/
|
url: /commands/hugo_check_ulimit/
|
||||||
|
@ -38,4 +38,4 @@ hugo check ulimit [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo check](/commands/hugo_check/) - Contains some verification checks
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo config"
|
title: "hugo config"
|
||||||
slug: hugo_config
|
slug: hugo_config
|
||||||
url: /commands/hugo_config/
|
url: /commands/hugo_config/
|
||||||
|
@ -37,4 +37,4 @@ hugo config [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo convert"
|
title: "hugo convert"
|
||||||
slug: hugo_convert
|
slug: hugo_convert
|
||||||
url: /commands/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 toTOML](/commands/hugo_convert_totoml/) - Convert front matter to TOML
|
||||||
* [hugo convert toYAML](/commands/hugo_convert_toyaml/) - Convert front matter to YAML
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo convert toJSON"
|
title: "hugo convert toJSON"
|
||||||
slug: hugo_convert_toJSON
|
slug: hugo_convert_toJSON
|
||||||
url: /commands/hugo_convert_tojson/
|
url: /commands/hugo_convert_tojson/
|
||||||
|
@ -41,4 +41,4 @@ hugo convert toJSON [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo convert toTOML"
|
title: "hugo convert toTOML"
|
||||||
slug: hugo_convert_toTOML
|
slug: hugo_convert_toTOML
|
||||||
url: /commands/hugo_convert_totoml/
|
url: /commands/hugo_convert_totoml/
|
||||||
|
@ -41,4 +41,4 @@ hugo convert toTOML [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo convert toYAML"
|
title: "hugo convert toYAML"
|
||||||
slug: hugo_convert_toYAML
|
slug: hugo_convert_toYAML
|
||||||
url: /commands/hugo_convert_toyaml/
|
url: /commands/hugo_convert_toyaml/
|
||||||
|
@ -41,4 +41,4 @@ hugo convert toYAML [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo env"
|
title: "hugo env"
|
||||||
slug: hugo_env
|
slug: hugo_env
|
||||||
url: /commands/hugo_env/
|
url: /commands/hugo_env/
|
||||||
|
@ -37,4 +37,4 @@ hugo env [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo gen"
|
title: "hugo gen"
|
||||||
slug: hugo_gen
|
slug: hugo_gen
|
||||||
url: /commands/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 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
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo gen autocomplete"
|
title: "hugo gen autocomplete"
|
||||||
slug: hugo_gen_autocomplete
|
slug: hugo_gen_autocomplete
|
||||||
url: /commands/hugo_gen_autocomplete/
|
url: /commands/hugo_gen_autocomplete/
|
||||||
|
@ -55,4 +55,4 @@ hugo gen autocomplete [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo gen doc"
|
title: "hugo gen doc"
|
||||||
slug: hugo_gen_doc
|
slug: hugo_gen_doc
|
||||||
url: /commands/hugo_gen_doc/
|
url: /commands/hugo_gen_doc/
|
||||||
|
@ -44,4 +44,4 @@ hugo gen doc [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo gen man"
|
title: "hugo gen man"
|
||||||
slug: hugo_gen_man
|
slug: hugo_gen_man
|
||||||
url: /commands/hugo_gen_man/
|
url: /commands/hugo_gen_man/
|
||||||
|
@ -40,4 +40,4 @@ hugo gen man [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo import"
|
title: "hugo import"
|
||||||
slug: hugo_import
|
slug: hugo_import
|
||||||
url: /commands/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](/commands/hugo/) - hugo builds your site
|
||||||
* [hugo import jekyll](/commands/hugo_import_jekyll/) - hugo import from Jekyll
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo import jekyll"
|
title: "hugo import jekyll"
|
||||||
slug: hugo_import_jekyll
|
slug: hugo_import_jekyll
|
||||||
url: /commands/hugo_import_jekyll/
|
url: /commands/hugo_import_jekyll/
|
||||||
|
@ -40,4 +40,4 @@ hugo import jekyll [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo import](/commands/hugo_import/) - Import your site from others.
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo list"
|
title: "hugo list"
|
||||||
slug: hugo_list
|
slug: hugo_list
|
||||||
url: /commands/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 expired](/commands/hugo_list_expired/) - List all posts already expired
|
||||||
* [hugo list future](/commands/hugo_list_future/) - List all posts dated in the future
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo list drafts"
|
title: "hugo list drafts"
|
||||||
slug: hugo_list_drafts
|
slug: hugo_list_drafts
|
||||||
url: /commands/hugo_list_drafts/
|
url: /commands/hugo_list_drafts/
|
||||||
|
@ -38,4 +38,4 @@ hugo list drafts [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo list](/commands/hugo_list/) - Listing out various types of content
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo list expired"
|
title: "hugo list expired"
|
||||||
slug: hugo_list_expired
|
slug: hugo_list_expired
|
||||||
url: /commands/hugo_list_expired/
|
url: /commands/hugo_list_expired/
|
||||||
|
@ -39,4 +39,4 @@ hugo list expired [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo list](/commands/hugo_list/) - Listing out various types of content
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo list future"
|
title: "hugo list future"
|
||||||
slug: hugo_list_future
|
slug: hugo_list_future
|
||||||
url: /commands/hugo_list_future/
|
url: /commands/hugo_list_future/
|
||||||
|
@ -39,4 +39,4 @@ hugo list future [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo list](/commands/hugo_list/) - Listing out various types of content
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo new"
|
title: "hugo new"
|
||||||
slug: hugo_new
|
slug: hugo_new
|
||||||
url: /commands/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 site](/commands/hugo_new_site/) - Create a new site (skeleton)
|
||||||
* [hugo new theme](/commands/hugo_new_theme/) - Create a new theme
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo new site"
|
title: "hugo new site"
|
||||||
slug: hugo_new_site
|
slug: hugo_new_site
|
||||||
url: /commands/hugo_new_site/
|
url: /commands/hugo_new_site/
|
||||||
|
@ -42,4 +42,4 @@ hugo new site [path] [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo new theme"
|
title: "hugo new theme"
|
||||||
slug: hugo_new_theme
|
slug: hugo_new_theme
|
||||||
url: /commands/hugo_new_theme/
|
url: /commands/hugo_new_theme/
|
||||||
|
@ -41,4 +41,4 @@ hugo new theme [name] [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo server"
|
title: "hugo server"
|
||||||
slug: hugo_server
|
slug: hugo_server
|
||||||
url: /commands/hugo_server/
|
url: /commands/hugo_server/
|
||||||
|
@ -83,4 +83,4 @@ hugo server [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo undraft"
|
title: "hugo undraft"
|
||||||
slug: hugo_undraft
|
slug: hugo_undraft
|
||||||
url: /commands/hugo_undraft/
|
url: /commands/hugo_undraft/
|
||||||
|
@ -39,4 +39,4 @@ hugo undraft path/to/content [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [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
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
date: 2017-06-22T21:51:29+02:00
|
date: 2017-06-29T08:42:09+02:00
|
||||||
title: "hugo version"
|
title: "hugo version"
|
||||||
slug: hugo_version
|
slug: hugo_version
|
||||||
url: /commands/hugo_version/
|
url: /commands/hugo_version/
|
||||||
|
@ -37,4 +37,4 @@ hugo version [flags]
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [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
|
||||||
|
|
|
@ -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/).
|
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
|
# 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`.
|
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:
|
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).
|
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.
|
Don't forget to accept the contributor license agreement. Click on the yellow badge in the automatically added comment in the pull request.
|
||||||
|
|
||||||
|
|
|
@ -44,7 +44,11 @@ Subject
|
||||||
: commit message subject, e.g. `tpl: Add custom index function`
|
: 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 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).
|
||||||
|
|
||||||
|
|
|
@ -124,13 +124,15 @@ You **must use govendor** to fetch Hugo's dependencies.
|
||||||
|
|
||||||
### Fetch from GitHub
|
### 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
|
go get github.com/kardianos/govendor
|
||||||
govendor get github.com/gohugoio/hugo
|
govendor get github.com/gohugoio/hugo
|
||||||
|
|
||||||
`govendor get` will fetch Hugo and all its dependent libraries to
|
`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
|
(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%`.*
|
*Windows users: where you see the `$HOME` environment variable above, replace it with `%USERPROFILE%`.*
|
||||||
|
|
||||||
|
|
|
@ -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
|
## Fixes
|
||||||
|
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
---
|
---
|
||||||
|
lastmod: 2017-06-30
|
||||||
date: 2016-10-16T13:30:47-04:00
|
date: 2016-10-16T13:30:47-04:00
|
||||||
date: 2016-12-20T17:21:00-05:00
|
|
||||||
description: "Personal site"
|
description: "Personal site"
|
||||||
license: ""
|
license: ""
|
||||||
licenseLink: ""
|
licenseLink: ""
|
||||||
sitelink: https://christianmendoza.me/
|
sitelink: https://www.christianmendoza.me/
|
||||||
sourceLink: https://github.com/christianmendoza/christianmendoza.me
|
sourceLink: https://github.com/christianmendoza/christianmendoza.me
|
||||||
tags:
|
tags:
|
||||||
- personal
|
- personal
|
||||||
|
|
15
docs/content/showcase/invincible.md
Normal file
15
docs/content/showcase/invincible.md
Normal file
|
@ -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
|
||||||
|
---
|
||||||
|
|
|
@ -13,14 +13,28 @@ title: Taxonomy Templates
|
||||||
weight: 30
|
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
|
### All content attached to taxonomy
|
||||||
content in a single html page. This template will be used to generate
|
|
||||||
all the automatically created taxonomy pages.
|
|
||||||
|
|
||||||
A [taxonomy terms template](/templates/terms/) is a template used to
|
A [taxonomy terms template](/templates/terms/) is a template which has access to all the full Taxonomy structure.
|
||||||
generate the list of terms for a given template.
|
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/`)
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
<div class="row">
|
<div class="row">
|
||||||
<div class="footer-panel">
|
<div class="footer-panel">
|
||||||
<p>Last revision: {{ .Lastmod.Format "January 2, 2006" }}{{ if .IsPage }}{{ with .GitInfo }} | <a href="https://github.com/gohugoio/hugo/commit/{{ .Hash }}">{{ .Subject }} ({{ .AbbreviatedHash }})</a>{{end }}{{ end }}
|
<p>Last revision: {{ .Lastmod.Format "January 2, 2006" }}{{ if .IsPage }}{{ with .GitInfo }} | <a href="https://github.com/gohugoio/hugoDocs/commit/{{ .Hash }}">{{ .Subject }} ({{ .AbbreviatedHash }})</a>{{end }}{{ end }}
|
||||||
<span style="float: right;">Hugo v{{ .Site.Params.release }} documentation</span>
|
<span style="float: right;">Hugo v{{ .Site.Params.release }} documentation</span>
|
||||||
</p>
|
</p>
|
||||||
{{ with getenv "REPOSITORY_URL" -}}
|
{{ with getenv "REPOSITORY_URL" -}}
|
||||||
|
|
|
@ -11,7 +11,7 @@
|
||||||
<hr>
|
<hr>
|
||||||
|
|
||||||
<blockquote>
|
<blockquote>
|
||||||
If you want to be added to this page, please send a <a href="https://github.com/gohugoio/hugo/pulls">pull request</a>. Check out the <a href="{{ relref . "community/contributing.md#showcase-additions" }}">how-to guide</a>.
|
If you want to be added to this page, please send a <a href="https://github.com/gohugoio/hugoDocs/pulls">pull request</a>. Check out the <a href="{{ relref . "community/contributing.md#showcase-additions" }}">how-to guide</a>.
|
||||||
</blockquote>
|
</blockquote>
|
||||||
|
|
||||||
{{ partial "footer.html" . }}
|
{{ partial "footer.html" . }}
|
||||||
|
|
BIN
docs/static/img/christianmendoza-tn.jpg
vendored
BIN
docs/static/img/christianmendoza-tn.jpg
vendored
Binary file not shown.
Before Width: | Height: | Size: 55 KiB After Width: | Height: | Size: 41 KiB |
BIN
docs/static/img/invincible-tn.jpg
vendored
Normal file
BIN
docs/static/img/invincible-tn.jpg
vendored
Normal file
Binary file not shown.
After Width: | Height: | Size: 25 KiB |
Loading…
Reference in a new issue