Skip to content
Ahmad Ammar

6. When something goes wrong

What you see What to do
python is not recognised Python is missing from the PATH. Run the installer again, tick Add python.exe to PATH, then close and reopen VS Code. On a Mac or on Linux, try python3.
git is not recognised Close and reopen VS Code. If that does not help, install Git again.
Please tell me who you are Run the git config lines with your name and email, then repeat the commit.
nothing to commit Git sees no changes. Check that the file is saved and that you ran python build.py.
failed to push and fetch first GitHub has a version you do not, perhaps from an edit on the website. Run git pull, then git push.
The site shows a 404 page Check the repository is named exactly your-name.github.io, that it is public, and that Pages is set to the main branch. Then wait two minutes.
The site looks unchanged Your browser may be showing a saved copy. Hold Ctrl (Cmd on a Mac) and press R.
The page has no colours or layout Check that the url line in site.toml is right and that the assets folder is still there.
A word in my page looks strange An angle bracket or tag may be unclosed. Compare it with the sample tags in the chapter on making the site yours.

6.1 Taking a newer version of the theme

The template’s look is kept apart from your words, and its versions are listed in CHANGELOG.md in the template repository. To take a newer theme, download the new assets folder and build.py, replace yours, and run python build.py. Your site.toml and src/pages stay as they are.