We plan on hosting a large collection of resources for the WACE exam. We have a database of tagged and filterable practice questions for a variety of ATAR subjects from past WACE exams as well as some simple study tools, some of which we created and can not be found anywhere else. If you are a year 11 / 12 student preparing for ATAR, this respostory could help you out, whether you are revising for smaller tests or exams. We could also use your help if you are intrested in expanding this project or wish to help out fellow students through the most challenging years of high school.
Feel free to email me if you are interested in joining, alternatively create a pull request with things you want to add.
Also MacELine™ is not a real company.
We have a discord now: https://discord.gg/ydSxYFNv
Site can be accessed from:
https://wacedatabase.pages.dev/ (most up to date)
https://grimreaper2654.github.io/WACE-Database/ (updates slower)
A localhost of a clone of the repo would work as well and can function without internet.
Not all questions have been added and tagged yet, wace database is still under construction.
We are in need of people who are willing to help us set tags for questions as well as upload more questions. A guide for doing both of these is below. If you have contributions to make, create a pull request and a contributor will accept it. Tagging questions can be done on github's online editor, but scanning the questions requires a decently good moniter as well as python installed. We are working on a more automated method of scanning questions but having python is still going to be necessary.
Go to https://wacedatabase.pages.dev/dev
Everything needed for setting tags is there. You will need a github account in order to create a token with full repo access, which you can then input into the site. Then select a question using the search function, filtering by year is usually good as it separates the questions into more managable chunks. The footer will show the possible tags of the question, which you can click to add and remove. Your changes will be saved until you leave the page. After making all your changes, the site will automatically create a pull request when you press the Submit Pull Request button. Then, wait for the site to update (check the repo or the discord server) and reload to see your changes. Alternatively, you can modify questions.json and create a pull request manually if you don't want to use the built in tagging system.
It is strongly recommended to install python and the required libraries from requirements.txt.
Otherwise, you will have to manually photoshop the images which is rather time consuming.
For those who don't want to use python, just manually do what is described in the steps (may take several hours per exam).
Open the past paper pdf that you found online and screenshot the individual questions.
Each question image should not have any borders so the resizing program does not break. Also crop out any headders and footers, like the page number. Keep the question number and number of marks as that is rather important.
Multiple question parts can be put in the same image, this is fine. Only use multiple images if the questions spans several pages.
If a question requires multiple images as it spans muliple pages, crop out any repeated question numbers like 'Question 1 (continued)'.
If the first (or only) image in the question does not have a question number in the form of Question n you will need to manually rename it.
The images would be named WACE2023Q1.1.png, WACE2023Q1.2.png, WACE2023Q1.3.png and so on for a multi part question or simply WACE2023Q1 for a single part question.
If the image contains the question number, there is no need to rename the question. Just make sure you screenshot the parts in order.
Make sure to only get the questions and NOT the marking keys as well. All images should be .png and the images to be automatically renamed should contain 'screenshot' in their name (can be changed in the python program)
screenshotter.py is avalaible to make screenshotting easier by simplifying the keybind. Just input the keybind for screenshotting and run the program (maybe with sudo if it needs perms). Its a minor time save, but stops your hand from getting as tired so it is quite useful. THis program is not necessary though so don't worry if you can't get it working.
Edit the template variable in renamer.py, don't worry if you forget, it is still salvageable.
Make sure you have all the questions in the image processing folder, then run questionProcessing.py. This will automatically process all the images. It will delete your screenshots and replace them with question PDFs and .webp images. When the program is complete, there will be a message logged to the terminal as well as a robot voice telling you that it has finished. This audio sometimes breaks if python is not focused.
After processing is finished, move the PDFs into the PDF downloads folder under the correct subject and move the WEBPs into the question bank under the correct subject.
Repeat step 2 but for the marking keys. Use the same naming format. Each marking key and question should have the same name but are in different folders so they do not conflict.
Put the marking key images into the image processing folder which should not have any images in it at this stage.
Run keyProcessing.py on the marking keys. The output images can then be moved to the markingKeys folder under the correct subject folder.
Open dataSynthesiser.py and edit the template until the question data is correct. The question data will be outputed to the terminal and can be copy pasted into questions.json.
If you want to set tags, add the tags to the tags array for each question. Its fine if you don't want to do tags, somebody else will have to do them.
This step can be done while your questions or marking keys are being processed. Just need to open a new terminal to run the program.
If you are a contributor, just commit changes and push to main. Otherwise, create a pull request and wait for a contributor to accept.