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       --noChmod[=false]      don't sync permission mode of files
93
94
95       --noTimes[=false]      don't sync modification time of files
96
97
98       --panicOnWarning[=false]      panic on first WARNING log
99
100
101       --poll=""       set this to a poll interval, e.g --poll 700ms, to use a
102       poll based approach to watch for file system changes
103
104
105       --printI18nWarnings[=false]      print missing translations
106
107
108       --printMemoryUsage[=false]      print memory usage to screen at  inter‐
109       vals
110
111
112       --printPathWarnings[=false]       print  warnings  on  duplicate target
113       paths etc.
114
115
116       --printUnusedTemplates[=false]      print warnings on unused templates.
117
118
119       --templateMetrics[=false]      display metrics  about  template  execu‐
120       tions
121
122
123       --templateMetricsHints[=false]       calculate  some  improvement hints
124       when combined with --templateMetrics
125
126
127       -t, --theme=[]      themes to use (located in /themes/THEMENAME/)
128
129
130       --trace=""      write trace to file (not useful in general)
131
132
133

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO