Using a Git Submodule for Your Theme
If you have a repository for your Jekyll or Hugo project and you want use a different repository for your theme, you should set up your theme repo as a Git Submodule.
To add a theme as a Git Submodule, run the following command from the root of your project:
git submodule add https://github.com/spf13/hyde.git themes/hyde Be sure to add the correct URL to your theme repo and the correct path to where you want this repo to live within your project.
Can't publish, preview, or save
When publishing, previewing, or saving a draft, there are a multitude of reasons why your site may fail to import. Generally, they boil down to 3 reasons:
Your content files are improperly formatted. Your layout files are improperly formatted or have a build error. Our service messed up. Our bad. We output the error the caused the import to fail and allow you to view it in order to help you debug.
How do I add a CNAME to my site?
For some hosting providers (such as GitHub pages) you will need to place a CNAME file in the root of your site.
You’ll need to ensure that the CNAME file is treated as a static file, so that it is copied to the root of your site during the build.
Make sure you place your CNAME file in your source directory, not your build directory. Otherwise it will be deleted during the next build
CSS, JS, & Media not working
Sometimes you’ll find your assets aren’t loading when you preview or publish your site. This is almost always due to path issues.
The best way to solve this issue is to ensure you’re always allowing your SSG (Static Site Generator) to generate URLs.
For example, we have a CSS file named main.css that isn’t loading when viewing subpages.
In the dev environment, we’re serving the site from localhost:4000, meaning that main.