From 39bb759f680ba497222613993207af66b15de499 Mon Sep 17 00:00:00 2001 From: Allison Beemer <66966224+anbeemer@users.noreply.github.com> Date: Tue, 23 Jul 2024 21:07:38 -0500 Subject: [PATCH] Added info on meta.json file in uploading_files doc --- docs/tutorials/uploading_files.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/tutorials/uploading_files.rst b/docs/tutorials/uploading_files.rst index 4a97c26..93169b0 100644 --- a/docs/tutorials/uploading_files.rst +++ b/docs/tutorials/uploading_files.rst @@ -1,12 +1,13 @@ How to upload a file -------------------------------------------------------------------------- - +When uploading a file `FILE.XXX`, a `meta.json` file should be created in a folder named `FILE.file`, +specifying where the file is sent on Canvas. The `meta.json` file ==================== -Filenames and titles of files are distinct on canvas: +Filenames and titles of files are distinct on Canvas: the latter is what you will see when the file is placed in a module, while the former is what is shown in the file structure. You can place a file in as many modules as you wish by specifying the modules in the `meta.json` file. @@ -16,7 +17,7 @@ If no module with the specified name exists, a module will be created to house t The `destination` key specifies where in the file structure you would like the file to be placed. Note that while a file cannot be simultaneously placed in multiple file structure locations using `meta.json`, if `meta.json` is updated, -the file will not automatically be deleted from any previous location unless that instance is specifically deleted. +the file will **not** automatically be deleted from any previous location unless that instance is specifically deleted. Example @@ -34,7 +35,7 @@ If the `meta.json` file looks like: "destination": "course_info/syllabus_schedule" } -then the file `F24_Math100_syllabus.pdf` will be put into two modules: `Course Information` and `Week 1`. +then the file in question will be named `F24_Math100_syllabus.pdf` and put into two modules: `Course Information` and `Week 1`. Within these two modules, its title will appear to students as `Syllabus`. The file will be located in `course_info/syllabus_schedule`, which will be created if it did not already exist.