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       http://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 and author info  to
66       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       --i18n-warnings[=false]      print missing translations
80
81
82       --ignoreCache[=false]      ignores the cache directory
83
84
85       -k, --kind=""      content type to create
86
87
88       -l, --layoutDir=""      filesystem path to layout directory
89
90
91       --minify[=false]      minify any supported  output  format  (HTML,  XML
92       etc.)
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       --path-warnings[=false]       print  warnings on duplicate target paths
102       etc.
103
104
105       --print-mem[=false]      print memory usage to screen at intervals
106
107
108       --templateMetrics[=false]      display metrics  about  template  execu‐
109       tions
110
111
112       --templateMetricsHints[=false]       calculate  some  improvement hints
113       when combined with --templateMetrics
114
115
116       -t, --theme=[]      themes to use (located in /themes/THEMENAME/)
117
118
119       --trace=""      write trace to file (not useful in general)
120
121
122

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO