~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to ivle/webapp/filesystem/browser/help.html

Add an XHTMLUnauthorizedView which redirects unauthenticated users to the
login page if a page raises an Unauthorized. Alter UserSettingsView to raise
one in the right cases, for testing.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<div class="helpfile">
2
 
<p>The IVLE <strong>File Browser</strong> allows you to access and edit any files that you have stored in IVLE.</p>
3
 
<p>See also: <a href="Subversion">Subversion</a>, <a href="Running%20and%20Serving">Running and Serving</a>.</p>
4
 
 
5
 
<h2>Getting started</h2>
6
 
<h3>Navigating</h3>
7
 
<p>The IVLE file browser works rather like other file browsers. Upon opening it you will be presented with a series of icons representing the directories (the folder icons) and files (the paper icons) in your home directory.</p>
8
 
 
9
 
<p>Clicking the name of a directory will open the directory, while clicking the name or icon of a directory or file will select it - multiple directories or files may be selected by toggling the checkboxes in the far left column. The breadcrumb trail at the top of the file browser window can be used to navigate to a directory higher in the hierarchy.</p>
10
 
 
11
 
<h3>Performing actions</h3>
12
 
<p>Most possible actions can be found immediately below the breadcrumbs, near the top of the file browser window. Those more often used can be seen immediately, while others are found inside the <strong>More actions...</strong> dropdown input.</p>
13
 
 
14
 
<p>Actions will be enabled or disabled depending on the current directory and selected files or directories. Regardless of the state, hovering over any action will display a description.</p>
15
 
 
16
 
<p>Note that although most actions will not require further input, some may display a prompt for confirmation or other input.</p>
17
 
 
18
 
<h2>Common tasks</h2>
19
 
<h3>Adding and removing files or directories</h3>
20
 
<p>There are two methods of adding files to your IVLE home directory - <a href="#uploading_files">uploading files</a> from your local computer, and creating new files or directories.</p>
21
 
 
22
 
<p>Creation actions can be found inside the <strong>Directory actions</strong> section of the <strong>More actions...</strong> dropdown, as <strong>New Directory</strong> and <strong>New File</strong>. In either case, a prompt will be displayed to request the name of the new path.</p>
23
 
 
24
 
<p>Deletion is accomplished in a similar manner. The <strong>Delete</strong> file action will always prompt before performing the removal, to protect you from potentially destructive mistakes. Please note that directories are removed recursively - all of their contents will be removed as well!</p>
25
 
 
26
 
<h3>Editing files</h3>
27
 
<p>The IVLE file browser also includes a handy text editor. This is easily accessed by means of the <strong>Open</strong> action on any file. The editor behaves much like traditional text editing applications, but has some features that you may not have seen before - syntax highlighting and line numbers, for example.</p>
28
 
 
29
 
<p>Whilst inside the editor, a subset of the usual directory actions are available, as well as some editor-specific features. Saving behaves as in a normal application - <strong>Save As...</strong> requests a new file name (prompting to overwrite if needed), with <strong>Save</strong> using the existing filename. Pressing Ctrl+S will also save the current file. Although the appropriate syntax highlighting language should be automatically detected, it may be overridden with the dropdown input in the editor actions area.</p>
30
 
 
31
 
<p>To return to a directory listing, use the breadcrumbs at the top of the editor window.</p>
32
 
 
33
 
<h3><a name="uploading_files">Uploading files</a></h3>
34
 
<p>IVLE offers a simple facility to upload files from your local computer, through the <strong>Upload File</strong> directory action. If the <strong>Unpack zip file</strong> checkbox is selected and the file is a ZIP file, the contents will be extracted into the current directory. This eases uploading of large numbers of files or complex directory hierarchies. Unchecking this option allows upload of the ZIP file itself to your home directory.</p>
35
 
 
36
 
<h3>Copying and moving files and directories</h3>
37
 
<p>The <strong>Cut</strong> and <strong>Copy</strong> file actions and the <strong>Paste</strong> directory action allow easy copying and moving of files or entire directory trees. They work quite similarly to the functions in normal file browsers - selecting one or more files and selecting <strong>Cut</strong> or <strong>Copy</strong> will attach them to the clipboard. Navigating to another directory and selecting <strong>Paste</strong> will move or copy the file to that directory respectively.</p>
38
 
<p>Note that this is probably not what you want when using files under Subversion. You should instead use the <strong>Svn Cut</strong> and <strong>Svn Copy</strong> actions, which also update the repository. See <a href="Subversion">Subversion</a>.</p>
39
 
</div>