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.