hugoDocs/content/troubleshooting/eof-error.md

title, linktitle, description, date, publishdate, lastmod, categories, tags, draft, weight, aliases, toc

title	linktitle	description	date	publishdate	lastmod	categories	tags	draft	weight	aliases	toc
EOF Error	EOF Error	If you find yourself seeing an EOF error in the console whenever you create a new content file from Hugo's archetype feature.	2017-02-01	2017-02-01	2017-02-01	troubleshooting	eof end of file error faqs	false		/troubleshooting/strange-eof-error/	true

Trouble: hugo new Aborts with EOF error

I'm running into an issue where I cannot get archetypes working, when running hugo new showcase/test.md, for example, I see an EOF error thrown by Hugo.

I have set up this test repository to show exactly what I've done, but it is essentially a vanilla installation of Hugo. https://github.com/polds/hugo-archetypes-test

When in that repository, using Hugo v0.12 to run hugo new -v showcase/test.md, I see the following output:

INFO: 2015/01/04 Using config file: /private/tmp/test/config.toml
INFO: 2015/01/04 attempting to create  showcase/test.md of showcase
INFO: 2015/01/04 curpath: /private/tmp/test/archetypes/showcase.md
ERROR: 2015/01/04 EOF

Is there something that I am blatantly missing?

Solution: Carriage Returns

The solution is to add a final newline (i.e., EOL) to the end of your default.md archetype file of your theme. You can do this by adding a carriage return after the closing +++ or --- of your TOML or YAML front matter, respectively.

{{% note "Final EOL Unnecessary in v0.13+" %}} As of v0.13, Hugo's parser has been enhanced to accommodate archetype files without final EOL thanks to the great work by @tatsushid. {{% /note %}}

Discussion Forum References

• http://discuss.gohugo.io/t/archetypes-not-properly-working-in-0-12/544
• http://discuss.gohugo.io/t/eol-f-in-archetype-files/554

Related Hugo Issues

• https://github.com/spf13/hugo/issues/776