Readme instruction is incomplete

[jevgen]

Describe the bug If one is going through steps of making site and adds my-first-post.md to the project root /contents folder, the following errors are shown in terminal and no site is generated. Something is missing. Perhaps instruction about contents hierarchy.

To Reproduce Do everything as it is in readme. Then add my-first-post.md to the project root /contents folder and run hugo server -D

Expected behavior Site builds and shows at localhost:1313.

Screenshots https://otkuda.to/2EdNvOA

Additional context Building sites … ERROR 2018/10/12 11:00:58 Error while rendering "taxonomy" in "": template: _default/list.html:11:4: executing "frontmenu" at <partial "nav.html" .>: error calling partial: template: partials/nav.html:39:19: executing "partials/nav.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer ERROR 2018/10/12 11:00:58 Error while rendering "section" in "": template: posts/section.html:18:8: executing "posts/section.html" at <partial "flip.html" ...>: error calling partial: template: partials/flip.html:8:9: executing "partials/flip.html" at <readFile "/content/a...>: error calling readFile: stat /Users/jev/blog_project/content/content/about.md: no such file or directory ERROR 2018/10/12 11:00:58 Error while rendering "taxonomyTerm" in "": template: categories/terms.html:8:4: executing "frontmenu" at <partial "nav.html" .>: error calling partial: template: partials/nav.html:39:19: executing "partials/nav.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer ERROR 2018/10/12 11:00:58 Error while rendering "page" in "posts/": template: posts/single.html:18:8: executing "posts/single.html" at <partial "flip.html" ...>: error calling partial: template: partials/flip.html:8:9: executing "partials/flip.html" at <readFile "/content/a...>: error calling readFile: stat /Users/jev/blog_project/content/content/about.md: no such file or directory ERROR 2018/10/12 11:00:58 Error while rendering "home" in "": template: index.html:3:4: executing "frontmenu" at <partial "nav.html" .>: error calling partial: template: partials/nav.html:39:19: executing "partials/nav.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer ERROR 2018/10/12 11:00:58 Error while rendering "taxonomyTerm" in "": template: taxonomy/terms.html:8:4: executing "frontmenu" at <partial "nav.html" .>: error calling partial: template: partials/nav.html:39:19: executing "partials/nav.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer ERROR 2018/10/12 11:00:58 Error while rendering "404" in "": template: 404.html:6:4: executing "frontmenu" at <partial "nav.html" .>: error calling partial: template: partials/nav.html:39:19: executing "partials/nav.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer

Hugo version v0.49.2

[webD97]

I can confirm this

[UtkarshVerma]

@jevgen Thanks for pointing this out. I had noticed this sometime back but forgot. I am improving the documentation right now. If you're curious about the error messages, it's because of some undefined config variables which are required by Hugo while building.

[UtkarshVerma]

@jevgen @webD97 I have added the instructions to the documentation in edd6fd3 and b60efbb. Using the config files provided in exampleSite as a base is advised since it takes care of the variables.

[jevgen]

@UtkarshVerma so basically you may put as readme "copy exampleSite contents to the project root, amend to your liking and run hugo server", right?

[UtkarshVerma]

@jevgen Copying the exampleSite folder as a whole will work but it isn't necessary. Only the config.toml file carries the build instructions for the machine, so simply copying it alone would do the trick. Rest of the work includes creating your content, which if you don't have, then you may refer to the exampleSite files as a basis of how your files are supposed to be(frontmatter etc).