Troubleshooting

dev helper script

I get a No such file or directory error when running the dev script

Check your terminal working directory is within the cs-unplugged directory, the root directory of the project. Running the ls command in this directory should list the dev file.

I have an error when running ./dev start

If you are having issues running the start command, try rebuilding the system images with ./dev build. Changes may be have been made to the system images since you initally created them.

If this still doesn’t solve your problem, you could also try deleting any existing images with ./dev wipe, and then build and start the system with ./dev start.

If issue still persists, log a bug on our issue tracker.

Viewing website

Images are not displayed when I view the website

Firstly check the image is located in the staticfiles/ directory. If the image isn’t located within the directory, check the original image is located within the static directory.

Normal Images (not Scratch block images)

If the image is located within the static/ directory, check the filepath is correct. When running ./dev update, the script will report an error if an image cannot be found.

Scratch block images

Check the .txt files located within the temp/ directory for a file containing the Scratch block syntax for the image missing (project wide find & replace is your friend here).

If you can find the file with the same block syntax and there isn’t a image in the staticfiles/ directory with the same filename (.svg instead of .txt), try running ./dev update. If this doesn’t fix the problem, the problem is in our scripts so log a bug on our issue tracker.

If you can’t find a file within the temp/ directory, check the syntax used in the text is valid. If the syntax is valid, the problem is in our Markdown to HTML converter to log a bug on our issue tracker.

Changed CSS/SCSS styles are not updated when I view the website

Firstly check the compiled CSS is located in the staticfiles/ directory, and that the changes have appeared in the compiled CSS file. If the CSS file does not include the changes made, run ./dev static. If you are editing SCSS files, check the ./dev static command isn’t reporting SCSS compilation errors.

The website isn’t displaying when I open cs-unplugged.localhost in a browser

Check you have run the ./dev start command, and that it hasn’t reported any errors.