Troubleshooting & General Tips

  1. When trying to identify what has gone wrong with your website, work backwards from the last change that you made.
  2. Keep the “Code” tab open in one browser window where you’re making edits, the “Actions” tab open in a second window so you can see the results of your edits, and the public-facing website ([yourusername].github.io) open in a third window so you can see what users will see.

The “Actions” tab has a running log of how the changes you’ve made to your files match up with what is published for users to see. Each change you make creates a “workflow” run, or a series of processes that interprets your metadata and images as web pages.

A green icon means the workflow run was successful. A yellow icon means the workflow run is still going. A red icon mean the publication step ran into some issues.

There are a few things you can do to make error checking easier.

  1. While you’re learning, commit changes to 1 file at a time and check the Actions tab to make sure your changes successfully published.
  2. Open up the error reporting completely to see if a specific file is named as a problem.

As always, before manipulating/editing your files, be sure to make a backup!

Table of contents