Issue with Cloning and Running Hextra This Repository

[Welding-Torch]

Hi, I'd like to clone this repo and quickly make a few edits for a different project of mine. I am aware of the Hextra Starter Template repo, but I wanna start with this repository instead because there's already content in place and it's easier to edit. However, when I clone this repo and run the following commands:

git clone https://github.com/imfing/hextra.git
cd hextra
hugo mod
# Start the server
hugo mod tidy
hugo server --logLevel debug --disableFastRender -p 1313

I see this output in the browser:

Which is obviously an issue, so I was hoping for a way to fix this. Any ideas?

♥ Cheers, love this theme.

[imfing]

@Welding-Torch
This repository is primarily designed for theme development. If you're interested in the site content, you'll find it in the exampleSite directory. The command required to run the development server is different in this case, as you can see in this specific line of our package.json file:

hextra/package.json

Line 4 in 8e8f7f2

"dev": "hugo server --source=exampleSite --themesDir=../.. --disableFastRender -D --port 1313",

I strongly recommend against running or modifying the content directly within this repository. For a more manageable approach, it's better to start with the template repository. You can then copy the content and configuration files from this exampleSite directory into your new project. This way, you maintain a clean separation between theme development and your own site content.

[Welding-Torch]

@imfing This command

hextra/package.json

Line 4 in 8e8f7f2

"dev": "hugo server --source=exampleSite --themesDir=../.. --disableFastRender -D --port 1313",

worked perfectly, thank you!

Also from a quick go-through of this repository, I understand that the content of this site isn't store in exampleSite but it actually is stored in layouts. The homepage is layouts/hextra-home.html.

If there's a way for me to copy all the content and dependencies for said content from this theme repository to the template repository, do let me know.

[imfing]

If there's a way for me to copy all the content and dependencies for said content from this theme repository to the template repository, do let me know.

just need to copy the exampleSite/content and exampleSite/hugo.yaml to the root of the template repository

[Welding-Torch]

Hey, I followed your instructions and copied the above files to the root of the template repository, but I was unable to see the layouts/hextra-home.html Homepage when I ran the server from the template. This is because the contents of https://imfing.github.io/hextra/ are not stored in the exampleSite folder but instead in the layouts folder.

I think there may have been a misunderstanding, I would actually like the contents of the layouts folder as starter material for a different project. This is because the layouts folder includes a homepage, which the hextra-starter-template does not have.

Hope this clears up any confusion 👍.

[imfing]

Gotcha, you also need to copy the layouts/hextra-home.html to the layouts directory of your site, which will override the default hextra-home.
Make sure you set the layout property in the frontmatter of your _index.md file