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=""       hostname  (and  path)   to   the   root,   e.g.
32       https://spf13.com/
33
34
35       -D, --buildDrafts[=false]      include content marked as draft
36
37
38       -E, --buildExpired[=false]      include expired content
39
40
41       -F,  --buildFuture[=false]      include content with publishdate in the
42       future
43
44
45       --cacheDir=""      filesystem path to cache directory.  Defaults:  $TM‐
46       PDIR/hugo_cache/
47
48
49       --cleanDestinationDir[=false]       remove  files  from destination not
50       found in static directories
51
52
53       --clock=""       set   the   clock   used   by   Hugo,   e.g.   --clock
54       2021-11-06T22:30:00.00+09:00
55
56
57       -c, --contentDir=""      filesystem path to content directory
58
59
60       -d, --destination=""      filesystem path to write files to
61
62
63       --disableKinds=[]      disable different kind of pages (home, RSS etc.)
64
65
66       --editor=""      edit new content with this editor, if provided
67
68
69       --enableGitInfo[=false]       add Git revision, date, author, and CODE‐
70       OWNERS info to the pages
71
72
73       -e, --environment=""      build environment
74
75
76       -f, --force[=false]      overwrite file if it already exists
77
78
79       --forceSyncStatic[=false]      copy all files when static is changed.
80
81
82       --gc[=false]      enable to run some cleanup tasks (remove unused cache
83       files) after the build
84
85
86       -h, --help[=false]      help for new
87
88
89       --ignoreCache[=false]      ignores the cache directory
90
91
92       --ignoreVendorPaths=""      ignores any _vendor for module paths match‐
93       ing the given Glob pattern
94
95
96       -k, --kind=""      content type to create
97
98
99       -l, --layoutDir=""      filesystem path to layout directory
100
101
102       --minify[=false]      minify any supported  output  format  (HTML,  XML
103       etc.)
104
105
106       --noBuildLock[=false]      don't create .hugo_build.lock file
107
108
109       --noChmod[=false]      don't sync permission mode of files
110
111
112       --noTimes[=false]      don't sync modification time of files
113
114
115       --panicOnWarning[=false]      panic on first WARNING log
116
117
118       --poll=""       set this to a poll interval, e.g --poll 700ms, to use a
119       poll based approach to watch for file system changes
120
121
122       --printI18nWarnings[=false]      print missing translations
123
124
125       --printMemoryUsage[=false]      print memory usage to screen at  inter‐
126       vals
127
128
129       --printPathWarnings[=false]       print  warnings  on  duplicate target
130       paths etc.
131
132
133       --printUnusedTemplates[=false]      print warnings on unused templates.
134
135
136       -s, --source=""      filesystem path to read files relative from
137
138
139       --templateMetrics[=false]      display metrics  about  template  execu‐
140       tions
141
142
143       --templateMetricsHints[=false]       calculate  some  improvement hints
144       when combined with --templateMetrics
145
146
147       -t, --theme=[]      themes to use (located in /themes/THEMENAME/)
148
149
150       --themesDir=""      filesystem path to themes directory
151
152
153       --trace=""      write trace to file (not useful in general)
154
155
156

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO