Troubleshooting

csu helper script

I get a No such file or directory error when running the csu 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 csu file.

I have an error when running ./csu start

If you are having issues running the start command, try rebuilding the system images with ./csu 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 ./csu wipe, and then build and start the system with ./csu 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 ./csu 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 ./csu 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 ./csu static. If you are editing SCSS files, check the ./csu static command isn’t reporting SCSS compilation errors.

The website isn’t displaying when I open localhost in a browser

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