Open navClose nav
February 1, 2018 docs

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.

January 2, 2018 docs

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.

January 2, 2018 docs

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

January 2, 2018 docs

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.