I am investigating migrating an existing website from Jekyll across to Hugo. Note: this isn’t a blog. It’s technical documentation, currently hosted via GitHub pages. The primary reason for this investigation is that the current Jekyll website is just taking too long to generate. This is partially due to the website size (a couple of thousand pages) but also due to the inherent speed of the liquid engine to create things like site navigation and breadcrumbs.
I’m trying to move some content across logically in order to test Hugo. I have not touched the themes yet, for example. I have followed the quickstart and have copied across some markdown pages from the current site. Performance is good (1,000 sample files copied), but I am very much at the start of this journey and I expect a lot of pain when it comes to migrating some of the liquid functionality we have.
The website itself consists of content many levels deep (https://site/A/B/C/D). In my new Hugo structure, I have copied “A/B/C/D” into the content folder. Each of the folders has an index.md file and, optionally, other .md files, along with supporting images and things. This is where things are going wrong. I have made Hugo write the generated files to disk so that I can see what’s going on.
In the generated folder I only see “A/index.html” being generated. “B” (and sub-folders) may be generated, but only if they contain images; it seems that the markdown content isn’t being converted at anything below this top level.
Is this expected? I’m very much a newbie but I can’t see any way to control this.