mirror of
				https://github.com/gohugoio/hugo.git
				synced 2024-05-11 05:54:58 +00:00 
			
		
		
		
	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/). :-)
This commit is contained in:
		@@ -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
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user