Compare commits

..

2 Commits

2 changed files with 20 additions and 18 deletions

View File

@@ -4,6 +4,8 @@ Blackboard Gradebook Organiser - main (functional) changes and new features log
## **Notable updates**
2024-03-01 Allow customisation of default settings - most useful default to edit is `IGNORE_DIRS`: the list of names for directories, or files, to ignore when extracting from compressed files
2023-07-17 Documentation updated and web docs added at [docs.vangef.net/BBGradebookOrganiser](https://docs.vangef.net/BBGradebookOrganiser)
2023-03-16 Hyperlinks for file paths and names listed in generated CSV files by *inspect by hash*

View File

@@ -1,23 +1,5 @@
# **Instructions**
## **Download gradebook**
1. Go to the course page on Blackboard
2. Go to *Grade Centre -> Full Grade Centre*
3. Find the assignment and click on the arrow for more options, and select *Assignment File Download*
4. Select all (click *Show All* at the bottom first, to display all users) and click submit to generate the gradebook zip file
5. Wait for the generated download link to appear, and click to download
## **Extract gradebook**
Extract the downloaded gradebook in a new directory inside *BB_gradebooks*.
- e.g. for `AssignmentX` extract the gradebook in *BB_gradebooks*/`AssignmentX`
## **Script requirements**
Before running the script for the first time, install the required python packages:
@@ -52,6 +34,24 @@ Ignored directories by default:
- `node_modules` (npm)
## **Download gradebook**
1. Go to the course page on Blackboard
2. Go to *Grade Centre -> Full Grade Centre*
3. Find the assignment and click on the arrow for more options, and select *Assignment File Download*
4. Select all (click *Show All* at the bottom first, to display all users) and click submit to generate the gradebook zip file
5. Wait for the generated download link to appear, and click to download
## **Extract gradebook**
Extract the downloaded gradebook in a new directory inside *BB_gradebooks*.
- e.g. for `AssignmentX` extract the gradebook in *BB_gradebooks*/`AssignmentX`
## **Organise gradebook**
To organise the gradebook run **`organise_gradebook.py`** and provide the name of the directory with the *extracted* gradebook (from section *Extract gradebook* above) as an argument.