Search code examples
githubgithub-pages

Trying to get started with pages


I'm following the guidance to set up pages and am having no luck:

  1. I set it to use the master branch and use the docs folder. I clicked Save and - the docs folder was not created.
  2. It discusses how to add a Jekyll theme - but there is no _config.yml file. Where can I find that file?
  3. What will the url be to the root page?
  4. Is there a good getting started guide? I found this but it does not show how to set it up.
  5. How do I get the default README.md?

Solution

  • Firstly, GitHub Pages must be enabled for your repository in "Settings > Pages". Then you can manually add the _config.yml file in GitHub with "Add file > Create new file". Then the installation information for the Cayman theme is in their GitHub repo. Add the necessary lines to the file, save and commit your changes, and it should work. Make sure that, on the bottom-right of the main page, "github-pages" is listed as a Deployment 😊