Wiki source code of Tutorial

Last modified by chaney08 on 2021/09/02 17:18

Hide last authors
chaney08 2.1 1 == Purpose ==
chaney08 1.1 2
mmorgan 5.1 3 The purpose of this tutorial is to teach you how to use the Drive. By the end of the tutorial, you should be able to upload, create, delete, and share files on the Drive
chaney08 1.1 4
mmorgan 5.1 5 == How to access the Drive ==
chaney08 1.1 6
chaney08 3.1 7 A Drive is a file-storage and synchronisation service. It allows users to store files, synchronise them across devices, and share them.
chaney08 1.1 8
mmorgan 5.1 9 In order to access the Drive, click on the "Drive" element in the navigation panel of the collab. Once you have done this, you will see the Drive within the Wiki window, as shown in the figure below.
chaney08 1.1 10
mmorgan 5.1 11 //NOTE: you need to be a member of the Team of a collab to be able to access its Drive.//
chaney08 3.1 12
chaney08 10.1 13 [[image:drive.png]]
chaney08 1.1 14
mmorgan 5.1 15 == Uploading files and folders ==
chaney08 1.1 16
mmorgan 5.1 17 Upload can be achieved by using the "Upload" button or by dragging-and-dropping a file or folder from your desktop to the Drive. Note that you need write permissions to the collab (i.e. to be an editor or admin of the collab) to upload files to its Drive.
chaney08 1.1 18
chaney08 2.1 19 == Creating files and folders ==
chaney08 1.1 20
21 Files and folders can be created using the "New" button:
22
chaney08 3.1 23 * **New folder: **Create a folder in order to structure your documents.
chaney08 1.1 24
chaney08 3.1 25 * **New file:** Create a file with no predetermined extension.
chaney08 1.1 26
chaney08 3.1 27 * **New Markdown File**: Create a file with a ".md" extension to use the [[Markdown syntax>>url:https://www.markdownguide.org/basic-syntax/]].
chaney08 1.1 28
mmorgan 5.1 29 * **New Excel / PowerPoint / Word File**: Create a Microsoft Open XML Format document, which can also be edited collaboratively in Collaboratory Office
chaney08 1.1 30
chaney08 2.1 31 == Sharing documents ==
chaney08 1.1 32
mmorgan 5.1 33 The preferred way to share documents is to place them in a collab's Drive and to manage who has access to the collab through its Team app.
chaney08 1.1 34
mmorgan 5.1 35 * //**Viewers **//of the collab have read-only access to the collab's content, including its Drive.
chaney08 3.1 36 * //**Editors **//of the collab have read, modify, create and delete access to the collab's content, including its Drive.
37 * //**Admins **//have the same permission as Editors and can also modify the Team of the collab.
chaney08 1.1 38
chaney08 7.1 39 For a given collab, a user is only a viewer or editor or admin. Adding a user to one role removes that user from the other two roles.
chaney08 1.1 40
chaney08 7.1 41 Users can also be added via the Units or Groups to which they belong. In such a case, a user cumulates the roles, which is the same as the user having the role with the most permissions.
chaney08 1.1 42
mmorgan 5.1 43 Users can also create links to files or folders.
44
chaney08 1.1 45 * //**Public links **//created with the share button [[image:https://wiki.ebrains.eu/bin/download/Collabs/the-collaboratory/how-to/create-documents/WebHome/share%20icon.png?width=26&height=29&rev=1.1||alt="share icon.png" height="29" width="26"]] bypass the collab's team permissions and give read-only access to any person with the link (read-only including for Editors and Admins of the collab's team).
mmorgan 5.1 46 * //**Smart links**// created with the internal link button [[image:https://wiki.ebrains.eu/bin/download/Collabs/the-collaboratory/how-to/create-documents/WebHome/internallink.png?rev=1.1||alt="internallink.png"]] provide read or write access according to each user's role as defined in the collab's Team.
chaney08 1.1 47
chaney08 2.1 48 == Versioning ==
chaney08 1.1 49
50 The Drive maintains a number of older versions of all its files. It is easy to see when the versions were saved, by whom, to retrieve any version for comparison, and to rollback to a prior version.
51
52 To see all available versions of a file, select History from the additional drop down menu of each file.
53
bougault 4.1 54 (% style="text-align:center" %)
chaney08 10.1 55 [[image:drive_filemenu.JPG||height="269" width="215"]]
chaney08 1.1 56
chaney08 3.1 57 The other options in the menu (“Rename,” “Move,” “Copy,” “Comment,” and “Details”) should be self-explanatory.
chaney08 1.1 58
mmorgan 5.1 59 The “Open via Client” option refers to the possibility of running a Seafile client on your computer which will make the Drive appear as an additional storage partition on your computer.
chaney08 1.1 60
chaney08 2.1 61 == Conclusion ==
chaney08 1.1 62
chaney08 3.1 63 By now, you should be able to upload, create, delete, and share files on the Drive. In addition, you should know some of the intricacies of using the Drive such as versioning.
chaney08 1.1 64