From f357559928e07aaaaa61f62c23508fcdcfa739a7 Mon Sep 17 00:00:00 2001 From: Anthony Fok Date: Tue, 4 Aug 2015 03:15:12 -0600 Subject: [PATCH] Improve formatting of Hugo command descriptions Trying to make them look good both in the terminal (`hugo help [command]`) and in the web browser (http://gohugo.io/commands/). :-) --- content/commands/hugo.md | 46 ++++++++++--------- content/commands/hugo_benchmark.md | 35 +++++++------- content/commands/hugo_check.md | 33 +++++++------- content/commands/hugo_config.md | 31 +++++++------ content/commands/hugo_convert.md | 37 ++++++++------- content/commands/hugo_convert_toJSON.md | 37 +++++++-------- content/commands/hugo_convert_toTOML.md | 37 +++++++-------- content/commands/hugo_convert_toYAML.md | 37 +++++++-------- content/commands/hugo_genautocomplete.md | 58 +++++++++++++----------- content/commands/hugo_gendoc.md | 40 ++++++++-------- content/commands/hugo_help.md | 29 ++++++------ content/commands/hugo_list.md | 33 ++++++++------ content/commands/hugo_list_drafts.md | 31 +++++++------ content/commands/hugo_list_future.md | 32 +++++++------ content/commands/hugo_new.md | 34 +++++++------- content/commands/hugo_new_site.md | 32 ++++++------- content/commands/hugo_new_theme.md | 30 ++++++------ content/commands/hugo_server.md | 35 +++++++------- content/commands/hugo_undraft.md | 33 ++++++++------ content/commands/hugo_version.md | 31 +++++++------ 20 files changed, 371 insertions(+), 340 deletions(-) diff --git a/content/commands/hugo.md b/content/commands/hugo.md index 9334c5ae4..daba877a3 100644 --- a/content/commands/hugo.md +++ b/content/commands/hugo.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo" slug: hugo url: /commands/hugo/ @@ -11,11 +11,12 @@ hugo builds your site ### Synopsis -hugo is the main command, used to build your Hugo site. - -Hugo is a Fast and Flexible Static Site Generator built with love by spf13 and friends in Go. +hugo is the main command, used to build your Hugo site. -Complete documentation is available at http://gohugo.io +Hugo is a Fast and Flexible Static Site Generator +built with love by spf13 and friends in Go. + +Complete documentation is available at http://gohugo.io/. ``` hugo @@ -25,34 +26,35 @@ hugo ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - -h, --help=false: help for hugo - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + -h, --help[=false]: help for hugo + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --noTimes=false: Don't sync modification time of files - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --noTimes[=false]: Don't sync modification time of files + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging - -w, --watch=false: watch filesystem for changes and recreate as needed + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging + -w, --watch[=false]: watch filesystem for changes and recreate as needed ``` ### SEE ALSO -* [hugo benchmark](/commands/hugo_benchmark/) - Benchmark hugo by building a site a number of times +* [hugo benchmark](/commands/hugo_benchmark/) - Benchmark hugo by building a site a number of times. * [hugo check](/commands/hugo_check/) - Check content in the source directory * [hugo config](/commands/hugo_config/) - Print the site configuration -* [hugo convert](/commands/hugo_convert/) - Convert will modify your content to different formats +* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [hugo genautocomplete](/commands/hugo_genautocomplete/) - Generate shell autocompletion script for Hugo * [hugo gendoc](/commands/hugo_gendoc/) - Generate Markdown documentation for the Hugo CLI. * [hugo help](/commands/hugo_help/) - Help about any command @@ -62,4 +64,4 @@ hugo * [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 at 2015-05-21 18:03:19.802527731 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.032773309 +0000 UTC diff --git a/content/commands/hugo_benchmark.md b/content/commands/hugo_benchmark.md index 55d54ed0c..f6722da8f 100644 --- a/content/commands/hugo_benchmark.md +++ b/content/commands/hugo_benchmark.md @@ -1,18 +1,18 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo benchmark" slug: hugo_benchmark url: /commands/hugo_benchmark/ --- ## hugo benchmark -Benchmark hugo by building a site a number of times +Benchmark hugo by building a site a number of times. ### Synopsis -Hugo can build a site many times over and analyze the -running process creating a benchmark. +Hugo can build a site many times over and analyze the running process +creating a benchmark. ``` hugo benchmark @@ -23,7 +23,7 @@ hugo benchmark ``` -n, --count=13: number of times to build the site --cpuprofile="": path/filename for the CPU profile file - -h, --help=false: help for benchmark + -h, --help[=false]: help for benchmark --memprofile="": path/filename for the memory profile file ``` @@ -31,27 +31,28 @@ hugo benchmark ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.80030401 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.029178075 +0000 UTC diff --git a/content/commands/hugo_check.md b/content/commands/hugo_check.md index 3900acd54..9c6638558 100644 --- a/content/commands/hugo_check.md +++ b/content/commands/hugo_check.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo check" slug: hugo_check url: /commands/hugo_check/ @@ -11,8 +11,8 @@ Check content in the source directory ### Synopsis -Hugo will perform some basic analysis on the - content provided and will give feedback. +Hugo will perform some basic analysis on the content provided +and will give feedback. ``` hugo check @@ -21,34 +21,35 @@ hugo check ### Options ``` - -h, --help=false: help for check + -h, --help[=false]: help for check ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.800150805 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.028981006 +0000 UTC diff --git a/content/commands/hugo_config.md b/content/commands/hugo_config.md index 65d3605fc..de1a8d657 100644 --- a/content/commands/hugo_config.md +++ b/content/commands/hugo_config.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo config" slug: hugo_config url: /commands/hugo_config/ @@ -11,7 +11,7 @@ Print the site configuration ### Synopsis -Print the site configuration, both default and custom settings +Print the site configuration, both default and custom settings. ``` hugo config @@ -20,34 +20,35 @@ hugo config ### Options ``` - -h, --help=false: help for config + -h, --help[=false]: help for config ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.800015664 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.028773512 +0000 UTC diff --git a/content/commands/hugo_convert.md b/content/commands/hugo_convert.md index 3f8034de3..2532ab71b 100644 --- a/content/commands/hugo_convert.md +++ b/content/commands/hugo_convert.md @@ -1,48 +1,51 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo convert" slug: hugo_convert url: /commands/hugo_convert/ --- ## hugo convert -Convert will modify your content to different formats +Convert your content to different formats ### Synopsis -Convert will modify your content to different formats +Convert your content (e.g. front matter) to different formats. + +See convert's subcommands toJSON, toTOML and toYAML for more information. ### Options ``` - -h, --help=false: help for convert + -h, --help[=false]: help for convert -o, --output="": filesystem path to write files to - --unsafe=false: enable less safe operations, please backup first + --unsafe[=false]: enable less safe operations, please backup first ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO @@ -51,4 +54,4 @@ Convert will modify your content to different formats * [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 at 2015-05-21 18:03:19.800919 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.029941981 +0000 UTC diff --git a/content/commands/hugo_convert_toJSON.md b/content/commands/hugo_convert_toJSON.md index f1b570140..c3074445c 100644 --- a/content/commands/hugo_convert_toJSON.md +++ b/content/commands/hugo_convert_toJSON.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo convert toJSON" slug: hugo_convert_toJSON url: /commands/hugo_convert_tojson/ @@ -11,8 +11,8 @@ Convert front matter to JSON ### Synopsis -toJSON will convert all front matter in the content - directory to use JSON for the front matter +toJSON converts all front matter in the content directory +to use JSON for the front matter. ``` hugo convert toJSON @@ -21,36 +21,37 @@ hugo convert toJSON ### Options ``` - -h, --help=false: help for toJSON + -h, --help[=false]: help for toJSON ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) -o, --output="": filesystem path to write files to - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - --unsafe=false: enable less safe operations, please backup first - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + --unsafe[=false]: enable less safe operations, please backup first + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO -* [hugo convert](/commands/hugo_convert/) - Convert will modify your content to different formats +* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.800453812 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.029372273 +0000 UTC diff --git a/content/commands/hugo_convert_toTOML.md b/content/commands/hugo_convert_toTOML.md index da296a7e2..072f1ef14 100644 --- a/content/commands/hugo_convert_toTOML.md +++ b/content/commands/hugo_convert_toTOML.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo convert toTOML" slug: hugo_convert_toTOML url: /commands/hugo_convert_totoml/ @@ -11,8 +11,8 @@ Convert front matter to TOML ### Synopsis -toTOML will convert all front matter in the content - directory to use TOML for the front matter +toTOML converts all front matter in the content directory +to use TOML for the front matter. ``` hugo convert toTOML @@ -21,36 +21,37 @@ hugo convert toTOML ### Options ``` - -h, --help=false: help for toTOML + -h, --help[=false]: help for toTOML ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) -o, --output="": filesystem path to write files to - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - --unsafe=false: enable less safe operations, please backup first - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + --unsafe[=false]: enable less safe operations, please backup first + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO -* [hugo convert](/commands/hugo_convert/) - Convert will modify your content to different formats +* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.800610431 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.029568477 +0000 UTC diff --git a/content/commands/hugo_convert_toYAML.md b/content/commands/hugo_convert_toYAML.md index 666eba528..fc7bb688f 100644 --- a/content/commands/hugo_convert_toYAML.md +++ b/content/commands/hugo_convert_toYAML.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo convert toYAML" slug: hugo_convert_toYAML url: /commands/hugo_convert_toyaml/ @@ -11,8 +11,8 @@ Convert front matter to YAML ### Synopsis -toYAML will convert all front matter in the content - directory to use YAML for the front matter +toYAML converts all front matter in the content directory +to use YAML for the front matter. ``` hugo convert toYAML @@ -21,36 +21,37 @@ hugo convert toYAML ### Options ``` - -h, --help=false: help for toYAML + -h, --help[=false]: help for toYAML ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) -o, --output="": filesystem path to write files to - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - --unsafe=false: enable less safe operations, please backup first - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + --unsafe[=false]: enable less safe operations, please backup first + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO -* [hugo convert](/commands/hugo_convert/) - Convert will modify your content to different formats +* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.800758702 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.029752904 +0000 UTC diff --git a/content/commands/hugo_genautocomplete.md b/content/commands/hugo_genautocomplete.md index 51c3ff5c2..d516f3133 100644 --- a/content/commands/hugo_genautocomplete.md +++ b/content/commands/hugo_genautocomplete.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo genautocomplete" slug: hugo_genautocomplete url: /commands/hugo_genautocomplete/ @@ -12,19 +12,22 @@ Generate shell autocompletion script for Hugo Generates a shell autocompletion script for Hugo. - - NOTE: The current version supports Bash only. This should work for *nix systems with Bash installed. - - By default the file is written directly to /etc/bash_completion.d for convenience and the command may need superuser rights, e.g: - - sudo hugo genautocomplete - - Add --completionfile=/path/to/file flag to set alternative file-path and name. - - Logout and in again to reload the completion scripts or just source them in directly: - - . /etc/bash_completion - + +NOTE: The current version supports Bash only. + This should work for *nix systems with Bash installed. + +By default, the file is written directly to /etc/bash_completion.d +for convenience, and the command may need superuser rights, e.g.: + + $ sudo hugo genautocomplete + +Add `--completionfile=/path/to/file` flag to set alternative +file-path and name. + +Logout and in again to reload the completion scripts, +or just source them in directly: + + $ . /etc/bash_completion ``` hugo genautocomplete @@ -34,7 +37,7 @@ hugo genautocomplete ``` --completionfile="/etc/bash_completion.d/hugo.sh": Autocompletion file - -h, --help=false: help for genautocomplete + -h, --help[=false]: help for genautocomplete --type="bash": Autocompletion type (currently only bash supported) ``` @@ -42,27 +45,28 @@ hugo genautocomplete ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.802059052 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.032217938 +0000 UTC diff --git a/content/commands/hugo_gendoc.md b/content/commands/hugo_gendoc.md index 41f844ff9..e962111ab 100644 --- a/content/commands/hugo_gendoc.md +++ b/content/commands/hugo_gendoc.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo gendoc" slug: hugo_gendoc url: /commands/hugo_gendoc/ @@ -12,11 +12,12 @@ Generate Markdown documentation for the Hugo CLI. Generate Markdown documentation for the Hugo CLI. - - This command is, mostly, used to create up-to-date documentation for gohugo.io. - - It creates one Markdown file per command with front matter suitable for rendering in Hugo. - + +This command is, mostly, used to create up-to-date documentation +of Hugo's command-line interface for http://gohugo.io/. + +It creates one Markdown file per command with front matter suitable +for rendering in Hugo. ``` hugo gendoc @@ -26,34 +27,35 @@ hugo gendoc ``` --dir="/tmp/hugodoc/": the directory to write the doc. - -h, --help=false: help for gendoc + -h, --help[=false]: help for gendoc ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.802209793 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.032407873 +0000 UTC diff --git a/content/commands/hugo_help.md b/content/commands/hugo_help.md index 9ebca7f57..d9b129bfe 100644 --- a/content/commands/hugo_help.md +++ b/content/commands/hugo_help.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo help" slug: hugo_help url: /commands/hugo_help/ @@ -21,34 +21,35 @@ hugo help [command] ### Options ``` - -h, --help=false: help for help + -h, --help[=false]: help for help ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.802371739 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.032577924 +0000 UTC diff --git a/content/commands/hugo_list.md b/content/commands/hugo_list.md index d030e9c4d..7fe96f884 100644 --- a/content/commands/hugo_list.md +++ b/content/commands/hugo_list.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo list" slug: hugo_list url: /commands/hugo_list/ @@ -11,36 +11,39 @@ Listing out various types of content ### Synopsis -Listing out various types of content. List requires a subcommand, eg. hugo list drafts +Listing out various types of content. + +List requires a subcommand, e.g. `hugo list drafts`. ### Options ``` - -h, --help=false: help for list + -h, --help[=false]: help for list ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO @@ -48,4 +51,4 @@ Listing out various types of content. List requires a subcommand, eg. hugo list * [hugo list drafts](/commands/hugo_list_drafts/) - List all drafts * [hugo list future](/commands/hugo_list_future/) - List all posts dated in the future -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.801756747 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.031129252 +0000 UTC diff --git a/content/commands/hugo_list_drafts.md b/content/commands/hugo_list_drafts.md index f6ad11a42..8def2e6fe 100644 --- a/content/commands/hugo_list_drafts.md +++ b/content/commands/hugo_list_drafts.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo list drafts" slug: hugo_list_drafts url: /commands/hugo_list_drafts/ @@ -11,7 +11,7 @@ List all drafts ### Synopsis -List all of the drafts in your content directory +List all of the drafts in your content directory. ``` hugo list drafts @@ -20,34 +20,35 @@ hugo list drafts ### Options ``` - -h, --help=false: help for drafts + -h, --help[=false]: help for drafts ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.801489239 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.030650499 +0000 UTC diff --git a/content/commands/hugo_list_future.md b/content/commands/hugo_list_future.md index c370929db..44d1a9e24 100644 --- a/content/commands/hugo_list_future.md +++ b/content/commands/hugo_list_future.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo list future" slug: hugo_list_future url: /commands/hugo_list_future/ @@ -11,7 +11,8 @@ List all posts dated in the future ### Synopsis -List all of the posts in your content directory who will be posted in the future +List all of the posts in your content directory which will be +posted in the future. ``` hugo list future @@ -20,34 +21,35 @@ hugo list future ### Options ``` - -h, --help=false: help for future + -h, --help[=false]: help for future ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.801618973 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.030877499 +0000 UTC diff --git a/content/commands/hugo_new.md b/content/commands/hugo_new.md index 711ce8e8d..781b235cf 100644 --- a/content/commands/hugo_new.md +++ b/content/commands/hugo_new.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo new" slug: hugo_new url: /commands/hugo_new/ @@ -13,9 +13,10 @@ Create new content for your site Create a new content file and automatically set the date and title. It will guess which kind of file to create based on the path provided. -You can also specify the kind with -k KIND -If archetypes are provided in your theme or site, they will be used. +You can also specify the kind with `-k KIND`. + +If archetypes are provided in your theme or site, they will be used. ``` hugo new [path] @@ -25,7 +26,7 @@ hugo new [path] ``` -f, --format="toml": frontmatter format - -h, --help=false: help for new + -h, --help[=false]: help for new -k, --kind="": Content type to create ``` @@ -33,24 +34,25 @@ hugo new [path] ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO @@ -58,4 +60,4 @@ hugo new [path] * [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 at 2015-05-21 18:03:19.80134962 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.030477738 +0000 UTC diff --git a/content/commands/hugo_new_site.md b/content/commands/hugo_new_site.md index 4425e310e..fbbb4e0f4 100644 --- a/content/commands/hugo_new_site.md +++ b/content/commands/hugo_new_site.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo new site" slug: hugo_new_site url: /commands/hugo_new_site/ @@ -13,8 +13,7 @@ Create a new site (skeleton) Create a new site in the provided directory. The new site will have the correct structure, but no content or theme yet. -Use 'hugo new [contentPath]' to create new content. - +Use `hugo new [contentPath]` to create new content. ``` hugo new site [path] @@ -24,34 +23,35 @@ hugo new site [path] ``` -f, --format="toml": config & frontmatter format - -h, --help=false: help for site + -h, --help[=false]: help for site ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo new](/commands/hugo_new/) - Create new content for your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.80106191 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.030129171 +0000 UTC diff --git a/content/commands/hugo_new_theme.md b/content/commands/hugo_new_theme.md index 05b2df32b..04bd7c4a6 100644 --- a/content/commands/hugo_new_theme.md +++ b/content/commands/hugo_new_theme.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo new theme" slug: hugo_new_theme url: /commands/hugo_new_theme/ @@ -15,7 +15,6 @@ Create a new theme (skeleton) called [name] in the current directory. New theme is a skeleton. Please add content to the touched files. Add your name to the copyright line in the license and adjust the theme.toml file as you see fit. - ``` hugo new theme [name] @@ -24,34 +23,35 @@ hugo new theme [name] ### Options ``` - -h, --help=false: help for theme + -h, --help[=false]: help for theme ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo new](/commands/hugo_new/) - Create new content for your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.801202688 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.030301827 +0000 UTC diff --git a/content/commands/hugo_server.md b/content/commands/hugo_server.md index 89d0c7c6f..c61487ffb 100644 --- a/content/commands/hugo_server.md +++ b/content/commands/hugo_server.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo server" slug: hugo_server url: /commands/hugo_server/ @@ -22,41 +22,42 @@ hugo server ### Options ``` - --appendPort=true: append port to baseurl + --appendPort[=true]: append port to baseurl --bind="127.0.0.1": interface to which the server will bind - --disableLiveReload=false: watch without enabling live browser reload on rebuild - -h, --help=false: help for server + --disableLiveReload[=false]: watch without enabling live browser reload on rebuild + -h, --help[=false]: help for server --meminterval=100: interval to poll memory usage (requires --memstats) --memstats="": log memory usage to this file -p, --port=1313: port on which the server will listen - -w, --watch=false: watch filesystem for changes and recreate as needed + -w, --watch[=false]: watch filesystem for changes and recreate as needed ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.799665309 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.028196949 +0000 UTC diff --git a/content/commands/hugo_undraft.md b/content/commands/hugo_undraft.md index e6c0ca96a..ee460473d 100644 --- a/content/commands/hugo_undraft.md +++ b/content/commands/hugo_undraft.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo undraft" slug: hugo_undraft url: /commands/hugo_undraft/ @@ -11,7 +11,9 @@ Undraft changes the content's draft status from 'True' to 'False' ### Synopsis -Undraft changes the content's draft status from 'True' to 'False' and updates the date to the current date and time. If the content's draft status is 'False', nothing is done +Undraft changes the content's draft status from 'True' to 'False' +and updates the date to the current date and time. +If the content's draft status is 'False', nothing is done. ``` hugo undraft path/to/content @@ -20,34 +22,35 @@ hugo undraft path/to/content ### Options ``` - -h, --help=false: help for undraft + -h, --help[=false]: help for undraft ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.801883978 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.031353807 +0000 UTC diff --git a/content/commands/hugo_version.md b/content/commands/hugo_version.md index c4f504552..8eafdeaf4 100644 --- a/content/commands/hugo_version.md +++ b/content/commands/hugo_version.md @@ -1,5 +1,5 @@ --- -date: 2015-05-21T20:03:19+02:00 +date: 2015-08-04T03:11:10-06:00 title: "hugo version" slug: hugo_version url: /commands/hugo_version/ @@ -11,7 +11,7 @@ Print the version number of Hugo ### Synopsis -All software has versions. This is Hugo's +All software has versions. This is Hugo's. ``` hugo version @@ -20,34 +20,35 @@ hugo version ### Options ``` - -h, --help=false: help for version + -h, --help[=false]: help for version ``` ### Options inherited from parent commands ``` -b, --baseUrl="": hostname (and path) to the root eg. http://spf13.com/ - -D, --buildDrafts=false: include content marked as draft - -F, --buildFuture=false: include content with publishdate in the future + -D, --buildDrafts[=false]: include content marked as draft + -F, --buildFuture[=false]: include content with publishdate in the future --cacheDir="": filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/ --config="": config file (default is path/config.yaml|json|toml) -d, --destination="": filesystem path to write files to - --disableRSS=false: Do not build RSS files - --disableSitemap=false: Do not build Sitemap file + --disableRSS[=false]: Do not build RSS files + --disableSitemap[=false]: Do not build Sitemap file --editor="": edit new content with this editor, if provided - --ignoreCache=false: Ignores the cache directory for reading but still writes to it - --log=false: Enable Logging + --ignoreCache[=false]: Ignores the cache directory for reading but still writes to it + --log[=false]: Enable Logging --logFile="": Log File path (if set, logging enabled automatically) - --pluralizeListTitles=true: Pluralize titles in lists using inflect + --pluralizeListTitles[=true]: Pluralize titles in lists using inflect + --preserveTaxonomyNames[=false]: Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu") -s, --source="": filesystem path to read files relative from - --stepAnalysis=false: display memory and timing of different steps of the program + --stepAnalysis[=false]: display memory and timing of different steps of the program -t, --theme="": theme to use (located in /themes/THEMENAME/) - --uglyUrls=false: if true, use /filename.html instead of /filename/ - -v, --verbose=false: verbose output - --verboseLog=false: verbose logging + --uglyUrls[=false]: if true, use /filename.html instead of /filename/ + -v, --verbose[=false]: verbose output + --verboseLog[=false]: verbose logging ``` ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra at 2015-05-21 18:03:19.799870429 +0000 UTC +###### Auto generated by spf13/cobra at 2015-08-04 09:11:10.028562395 +0000 UTC