hugo-new(1)

1HUGO-NEW(1)                       Hugo Manual                      HUGO-NEW(1)
2
3
4

NAME

6       hugo-new - Create new content for your site
7
8
9

SYNOPSIS

11       hugo new [path] [flags]
12
13
14

DESCRIPTION

16       Create a new content file and automatically set the date and title.  It
17       will guess which kind of file to create based on the path provided.
18
19
20       You can also specify the kind with -k KIND.
21
22
23       If archetypes are provided in your theme or site, they will be used.
24
25
26       Ensure you run this within the root directory of your site.
27
28
29

OPTIONS

31       -b, --baseURL=""
32           hostname (and path) to the root, e.g.  ⟨http://spf13.com/⟩
33
34
35       -D, --buildDrafts[=false]
36           include content marked as draft
37
38
39       -E, --buildExpired[=false]
40           include expired content
41
42
43       -F, --buildFuture[=false]
44           include content with publishdate in the future
45
46
47       --cacheDir=""
48           filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
49
50
51       --cleanDestinationDir[=false]
52           remove files from destination not found in static directories
53
54
55       -c, --contentDir=""
56           filesystem path to content directory
57
58
59       -d, --destination=""
60           filesystem path to write files to
61
62
63       --disableKinds=[]
64           disable different kind of pages (home, RSS etc.)
65
66
67       --editor=""
68           edit new content with this editor, if provided
69
70
71       --enableGitInfo[=false]
72           add Git revision, date and author info to the pages
73
74
75       -e, --environment=""
76           build environment
77
78
79       --forceSyncStatic[=false]
80           copy all files when static is changed.
81
82
83       --gc[=false]
84           enable to run some cleanup tasks (remove unused cache files) after
85       the build
86
87
88       -h, --help[=false]
89           help for new
90
91
92       --i18n-warnings[=false]
93           print missing translations
94
95
96       --ignoreCache[=false]
97           ignores the cache directory
98
99
100       -k, --kind=""
101           content type to create
102
103
104       -l, --layoutDir=""
105           filesystem path to layout directory
106
107
108       --minify[=false]
109           minify any supported output format (HTML, XML etc.)
110
111
112       --noChmod[=false]
113           don't sync permission mode of files
114
115
116       --noTimes[=false]
117           don't sync modification time of files
118
119
120       --path-warnings[=false]
121           print warnings on duplicate target paths etc.
122
123
124       -s, --source=""
125           filesystem path to read files relative from
126
127
128       --templateMetrics[=false]
129           display metrics about template executions
130
131
132       --templateMetricsHints[=false]
133           calculate some improvement hints when combined with
134       --templateMetrics
135
136
137       -t, --theme=[]
138           themes to use (located in /themes/THEMENAME/)
139
140
141       --themesDir=""
142           filesystem path to themes directory
143
144
145       --trace=""
146           write trace to file (not useful in general)
147
148
149

OPTIONS INHERITED FROM PARENT COMMANDS

151       --config=""
152           config file (default is path/config.yaml|json|toml)
153
154
155       --configDir="config"
156           config dir
157
158
159       --debug[=false]
160           debug output
161
162
163       --log[=false]
164           enable Logging
165
166
167       --logFile=""
168           log File path (if set, logging enabled automatically)
169
170
171       --quiet[=false]
172           build in quiet mode
173
174
175       -v, --verbose[=false]
176           verbose output
177
178
179       --verboseLog[=false]
180           verbose logging
181
182
183

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO