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       -c, --contentDir=""      filesystem path to content directory
54
55
56       -d, --destination=""      filesystem path to write files to
57
58
59       --disableKinds=[]      disable different kind of pages (home, RSS etc.)
60
61
62       --editor=""      edit new content with this editor, if provided
63
64
65       --enableGitInfo[=false]      add Git revision, date, author, and  CODE‐
66       OWNERS info to the pages
67
68
69       --forceSyncStatic[=false]      copy all files when static is changed.
70
71
72       --gc[=false]      enable to run some cleanup tasks (remove unused cache
73       files) after the build
74
75
76       -h, --help[=false]      help for new
77
78
79       --ignoreCache[=false]      ignores the cache directory
80
81
82       -k, --kind=""      content type to create
83
84
85       -l, --layoutDir=""      filesystem path to layout directory
86
87
88       --minify[=false]      minify any supported  output  format  (HTML,  XML
89       etc.)
90
91
92       --noBuildLock[=false]      don't create .hugo_build.lock file
93
94
95       --noChmod[=false]      don't sync permission mode of files
96
97
98       --noTimes[=false]      don't sync modification time of files
99
100
101       --panicOnWarning[=false]      panic on first WARNING log
102
103
104       --poll=""       set this to a poll interval, e.g --poll 700ms, to use a
105       poll based approach to watch for file system changes
106
107
108       --printI18nWarnings[=false]      print missing translations
109
110
111       --printMemoryUsage[=false]      print memory usage to screen at  inter‐
112       vals
113
114
115       --printPathWarnings[=false]       print  warnings  on  duplicate target
116       paths etc.
117
118
119       --printUnusedTemplates[=false]      print warnings on unused templates.
120
121
122       --templateMetrics[=false]      display metrics  about  template  execu‐
123       tions
124
125
126       --templateMetricsHints[=false]       calculate  some  improvement hints
127       when combined with --templateMetrics
128
129
130       -t, --theme=[]      themes to use (located in /themes/THEMENAME/)
131
132
133       --trace=""      write trace to file (not useful in general)
134
135
136

OPTIONS INHERITED FROM PARENT COMMANDS

138       --clock=""       set   the   clock   used   by   Hugo,   e.g.   --clock
139       2021-11-06T22:30:00.00+09:00
140
141
142       --config=""      config file (default is path/config.yaml|json|toml)
143
144
145       --configDir="config"      config dir
146
147
148       --debug[=false]      debug output
149
150
151       -e, --environment=""      build environment
152
153
154       --ignoreVendorPaths=""      ignores any _vendor for module paths match‐
155       ing the given Glob pattern
156
157
158       --log[=false]      enable Logging
159
160
161       --logFile=""      log File path (if set, logging enabled automatically)
162
163
164       --quiet[=false]      build in quiet mode
165
166
167       -s, --source=""      filesystem path to read files relative from
168
169
170       --themesDir=""      filesystem path to themes directory
171
172
173       -v, --verbose[=false]      verbose output
174
175
176       --verboseLog[=false]      verbose logging
177
178
179

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO