<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
    <title>Gossamer FileMan - File Manager</title>
    <meta http-equiv="content-type" content="text/shtml; charset=iso-8859-1" />
    <link type="text/css" rel="stylesheet" href="<%cfg.static_url%>/<%cfg.template%>/luna.css" />
    <script type="text/javascript" src="<%cfg.static_url%>/js/jquery.min.js"></script>
    <script type="text/javascript">
    //<![CDATA[
    var help_section = 'introduction';
    var icons = {
      plus : "<%GT::FileMan::image_url('plus.gif')%>",
      minus : "<%GT::FileMan::image_url('minus.gif')%>"
    }

    $(document).ready(function() {
      $('#leftsidebar img[name]').css('cursor', 'pointer').each(function() {
        var $img = $(this);
        $img.click(function() {
          var ul = $('#nav' + $img.attr('name'));
          if (ul.is(':hidden')) {
            ul.show();
            $img.attr('src', icons.minus);
          }
          else {
            ul.hide();
            $img.attr('src', icons.plus);
          }
        });
      });

      $('.helpnav a[rel]').each(function() {
        var link = $(this);
        link.click(function() {
          if (help_section && help_section != link.attr('rel')) $('#' + help_section).hide();
          $('#' + link.attr('rel')).show();
          help_section = link.attr('rel');
        });
      });
    });
    //]]>
    </script>
</head>
<body id="help" style="overflow: auto">
    <div id="ocwrapper" class="clear">
        <div id="icwrapper" class="clear">
            <div id="leftsidebar">
                <div id="helpbar">
                    <h3 class="header">Help Contents</h3>
                    <ul class="helpnav">
                        <li>
                          <img name="usefm" src="<%GT::FileMan::image_url('minus.gif')%>" title="FileMan" />
                          <a href="#" rel="introduction">Using Gossamer FileMan</a>
                          <ul id="navusefm">
                              <li><a href="#" rel="introduction">Welcome to FileMan</a></li>
                              <li class="end"><a href="#" rel="interface">Interface</a></li>
                          </ul>
                        </li>
                        <li>
                          <img name="commands" src="<%GT::FileMan::image_url('plus.gif')%>" title="The Toolbar" />
                          <a href="#" rel="commands-content">The Toolbar</a>
                          <ul id="navcommands" class="hide">
                              <li><a href="#" rel="search">Search</a></li>
                              <li><a href="#" rel="replace">Replace</a></li>
                              <li><a href="#" rel="command">Command</a></li>
                              <li><a href="#" rel="upload">Upload</a></li>
                              <li><a href="#" rel="file">New File</a></li>
                              <li><a href="#" rel="folder">New Folder</a></li>
                              <li><a href="#" rel="protect">Protect</a></li>
                              <li class="end">
                                <img name="settings" src="<%GT::FileMan::image_url('plus.gif')%>" title="Settings" />
                                <a href="#" rel="toolbar-settings" class="subnav">Settings</a>
                                <ul id="navsettings" class="hide">
                                    <li><a href="#" rel="setup">Setup</a></li>
                                    <li><a href="#" rel="preferences">Preferences</a></li>
                                    <%~if cfg.fversion eq 'multiple'%>
                                    <li><a href="#" rel="users">User Management</a></li>
                                    <li><a href="#" rel="logs">Browser Logs</a></li>
                                    <%endif~%>
                                    <li class="end"><a href="#" rel="env">Environment</a></li>
                                </ul>
                              </li>
                          </ul>
                        </li>
                        <li>
                          <img name="actions" src="<%GT::FileMan::image_url('plus.gif')%>" title="The Actions" />
                          <a href="#" rel="actions-content">The Actions</a>
                          <ul id="navactions" class="hide">
                              <li><a href="#" rel="download">Download</a></li>
                              <li><a href="#" rel="symlink">Symlink</a></li>
                              <li><a href="#" rel="copy">Copy</a></li>
                              <li><a href="#" rel="move">Move</a></li>
                              <li><a href="#" rel="rename">Rename</a></li>
                              <li><a href="#" rel="delete">Delete</a></li>
                              <li><a href="#" rel="compress">Compress</a></li>
                              <li><a href="#" rel="uncompress">Uncompress</a></li>
                              <li><a href="#" rel="chmod">Chmod</a></li>
                              <li><a href="#" rel="tail">Tail</a></li>
                              <li><a href="#" rel="perl">Perl Check</a></li>
                              <li><a href="#" rel="diff">Diff</a></li>
                              <li class="end"><a href="#" rel="print">Print</a></li>
                          </ul>
                        </li>
                    </ul>
                </div>
            </div>
            <div id="contentwrapper" class="shadowleft">
                <div class="shadowtop"><div class="shadowtopleft"></div><div class="shadowtopright"></div></div>
                <div class="shadowright">
                    <div id="content">
                        <div id="introduction">
                            <h1>Introduction</h1>
                            <div class="clear">
                                <p style="float: right"><img src="<%cfg.static_url%>/help/dir-structure.gif" alt="Directory Structure" /></p>
                                <p>FileMan users who are unfamiliar with file management should read this section to gain a basic understanding of directories, paths, and other related concepts.  Users who feel confident in their understanding of these concepts can proceed to the next three sections, which will deal with FileMan's structure and features.</p>
                                <p>File management is key to all computer systems, from basic home PC's to elaborate servers.  A well-structured system of files not only enables you to find resources quickly and easily, but also lets you provide web access to files you wish to make accessible online.</p>
                                <p>Files are organized using directories (folders).  Directories contain files and other directories.  When using FileMan, you will have one root directory which will contain all other directories and files.  It might help to visualize your directory structure as a sort of tree diagram, with directories and files "branching down" from your one root directory.</p>
                                <p>This illustration shows the structure of a hypothetical web domain account.  In FileMan, as well as many other applications, file locations are specified using paths.  Paths are strings of text that define the location of a file by providing the name of each directory and sub-directory (separated by forward slashes) that must be opened to find the file.  Paths usually begin with a forward slash: /.  The forward slash symbolizes the root directory.  The path to the "currentlogo.jpg" file in this illustration would be: <br /><b>since the "currentlogo.jpg" file is found in the "logos" directory, found in the "images" folder which is itself located in the root directory.</b></p>
                                <p>FileMan allows you to view and manage your files using directories and paths.  While managing files in FileMan, the path to a directory will be displayed in the Toolbar (see below for details), with all of the files and directories in that directory displayed in the Files menu (see below for details).</p>
                                <p>It is recommended that you do not use any blank spaces while naming directories or files; some web browsers cannot process them.  It is also recommended that you do not use upper-case letters in directory and file names; paths are case sensitive online, and upper-case letters are usually avoided to avoid confusion.</p>
                            </div>
                        </div>
                        <div id="interface" class="hide">
                          <h1>Interface</h1>
                          <p>There are three main components of FileMan: the Toolbar (appears at the top of the page), the Files menu (the list of directories, files and statistics in the middle of the page) and the Actions menu (the drop-down menu at the top of the Files menu). While these three components do not operate separately from one another, they and their features will be discussed separately for the purposes of organization.</p>
                          <p><img src="<%cfg.static_url%>/help/fig2.gif" alt="Figure 2" /><br /><span>A sample FileMan v.3 window.</span></p>
                          <h3>The Files Menu</h3>
                          <p>The Files Menu displays the files and directories in the directory you are viewing and provides detailed information about each of them through a series of columns. The checkboxes at the left of the Files Menu allows you to select files or directories for the commands found in the Actions menu (the drop-down menu displaying "More Actions" in the above screenshot). Clicking the checkbox at the top of the menu automatically selects all displayed files and directories.</p>

                          <h3>File Name</h3>
                          <p>The file/folder name is listed in this column.  Clicking the "Name" heading will sort the files and directories by file name in ascending order.  Clicking the "Name" heading a second time will sort them in descending alphabetical order.</p>
                          <h3>File Size</h3>
                          <p>The file size of each file is listed in this column.  Clicking the "Size" heading will sort the files and directories by file size in ascending order.  Clicking the "Size" heading a second time will sort them in descending alphabetical order.</p>
                          <h3>File Type</h3>
                          <p>The file type of each file (directories are called "file folder"s) is listed in this column.  Clicking the "File Type" heading will sort the files and directories by file type in ascending alphabetical order.  Clicking the "File Type" heading a second time will sort them in descending alphabetical order.</p>

                          <h3>Modified</h3>
                          <p>The date that each file or directory was last modified is listed in this column.  Clicking the "Modified" heading will sort the files and directories by modification date in ascending order.  Clicking the "Modified" heading a second time will sort them in descending alphabetical order.</p>
                          <h3>Owner</h3>
                          <p>The username of the owner of each file and directory is listed in this column.  Clicking the "Owner" heading will sort the files and directories by owner in ascending alphabetical order.  Clicking the "Owner" heading a second time will sort them in descending alphabetical order.</p>
                          <h3>Permissions</h3>
                          <p>The permission settings of each file and directory are listed in this column.  Clicking the "Permissions" heading will sort the files and directories by permission settings in ascending alphabetical order.  Clicking the "Permissions" heading a second time will sort them in descending alphabetical order.  Clicking on the permission settings of a specific file or directory will display a form allowing you to modify the file or directory's permission settings by checking individual permissions or by entering the numeric code for the desired permissions.  If you need more information, a tutorial explaining how to configure permissions is available here: <a href="http://www.itc.virginia.edu/desktop/web/permissions/" target="helpinfo">http://www.itc.virginia.edu/desktop/web/permissions/</a></p>

                          <h3>The Toolbar</h3>
                          <p>The Toolbar displays the directory location you are currently viewing in FileMan, as well as a series of tools that allow you to manage your files.  Click on "The Toolbar" in the navigation menu at the left of this help page for information on specific Toolbar functions.</p>
                          <p>In the top left corner of the Toolbar, the location of the directory you are currently viewing will be displayed; /templates/luna would be a possible location.  Thus, all files and directories in that location will be displayed in the Files menu (see below for details).  You can click on any of the directory names listed in the location to view a specific directory.</p>
                          <p class="figure"><img src="<%cfg.static_url%>/help/fig3.gif" alt="Figure 3" /><br /><span>The Toolbar.</span></p>
                          <p>The text field in the top right corner of the Toolbar allows you to open a directory found in the location currently being displayed.  If you are viewing a directory which contains another directory called "images", for example, entering "images" in the field and clicking "Go" will open the "images" directory and display its contents in the Files menu.</p>
                          <h3>The Actions Menu</h3>

                          <p>The Actions Menu drops-down to allow you to perform various actions on files and directories you select via checkboxes in the Files Menu.  Click on "The Actions" in the navigation menu at the left of this help page for information on specific actions.</p>
                          <p><img src="<%cfg.static_url%>/help/actions.gif" alt="Figure 2" /><br /><span>The Actions Menu.</span></p>

                          <h3>Multi-User Version</h3>
                          <p class="figure"><img src="<%cfg.static_url%>/help/fig7.gif" alt="Figure 7" /></p>
                          <p>The multi-user version of FileMan v.3 features a dropdown menu for directories, allowing users to choose which path they wish to work in.   Simply click on the down-pointing green arrow beside the directory name and a list of accessible directories will appear. </p>
                          <p>Access to these directories is defined by the admin in the "Users Manager" option in the Tools link.  Enter the paths to the directories that you want the user to have access to in the "Access Directories" section.</p>

                          <h3>Logout</h3>
                          <p>Clicking the "Logout" link will sign you out of your current FileMan session and return you to the login page.</p>
                        </div>
                        <div id="commands-content" class="hide">
                            <h1>The Toolbar</h1>
                            <p><img src="<%cfg.static_url%>/help/toolbar.jpg" alt="Toolbar" /></p>
                            <p>The commands available to you in the Toolbar are your primary methods of managing the files and directories on your FileMan installation.  Click on the names of specific commands to learn more about them individually.</p>
                        </div>
                        <div id="actions-content" class="hide">
                            <h1>Actions</h1>
                            <p><img src="<%cfg.static_url%>/help/fig6.gif" alt="Action Bar" /></p>
                            <p>The Command Bar allows you to perform commands and actions upon files and directories that you have selected in the <b>Files menu</b>. Each action is listed in the "<b>More Actions</b>" dropdown menu.  </p>
                        </div>
                        <div id="toolbar-settings" class="hide">
                            <h1>Settings</h1>
                            <p><img src="<%cfg.static_url%>/help/tools.gif" alt="search" /></p>
                            <p>Clicking the "Settings" link displays a drop-down list of sub-menus allowing you to customize your FileMan installation.</p>
                        </div>
                        <div id="setup" class="hide">
                            <h1>Setup</h1>
                            <%include help_setup.html%>
                        </div>
                        <div id="password" class="hide">
                            <h1>Change Password</h1>
                            <%include help_password.html%>
                        </div>
                        <div id="preferences" class="hide">
                            <h1>Preferences</h1>
                            <%include help_preferences.html%>
                        </div>
                        <div id="users" class="hide">
                            <h1>Users Managerment</h1>
                            <%include help_user.html%>
                        </div>
                        <div id="logs" class="hide">
                            <h1>Browser Logs</h1>
                            <%include help_logs.html%>
                        </div>
                        <div id="env" class="hide">
                            <h1>Environment</h1>
                            <p>The "Environment" link displays a detailed list of system information about your FileMan installation.  This list can be useful for identifying system errors.</p>
                        </div>
                        <div id="search" class="hide">
                            <h1>Search</h1>
                            <p><img src="<%cfg.static_url%>/help/search.gif" alt="search" /></p>
                            <%include help_search.html%>
                        </div>
                        <div id="replace" class="hide">
                            <h1>Replace</h1>
                            <p><img src="<%cfg.static_url%>/help/replace.gif" alt="search" /></p>
                            <%include help_replace.html%>
                        </div>
                        <div id="command" class="hide">
                            <h1>Command</h1>
                            <p><img src="<%cfg.static_url%>/help/command.gif" alt="search" /></p>
                            <%include help_command.html%>
                        </div>
                        <div id="upload" class="hide">
                            <h1>Upload</h1>
                            <p><img src="<%cfg.static_url%>/help/upload.gif" alt="search" /></p>
                            <%include help_upload.html%>
                        </div>
                        <div id="file" class="hide">
                            <h1>New File</h1>
                            <p><img src="<%cfg.static_url%>/help/newfile.gif" alt="New file" /></p>
                            <%include help_file.html%>
                        </div>
                        <div id="folder" class="hide">
                            <h1>New Folder</h1>
                            <p><img src="<%cfg.static_url%>/help/newfolder.gif" alt="New Folder" /></p>
                            <%include help_makedir.html%>
                        </div>
                        <div id="protect" class="hide">
                            <h1>Protect</h1>
                            <p><img src="<%cfg.static_url%>/help/protect.gif" alt="search" /></p>
                            <%include help_protect.html%>
                        </div>
                        <div id="download" class="hide">
                            <h1>Download</h1>
                            <%include help_download.html%>
                        </div>
                        <div id="symlink" class="hide">
                            <h1>Symlink</h1>
                            <p><img src="<%cfg.static_url%>/help/command-symlink.gif" alt="command bar" />
                            <%include help_symlink.html%>
                        </div>
                        <div id="copy" class="hide">
                            <h1>Copy</h1>
                            <p><img src="<%cfg.static_url%>/help/command-copy.gif" alt="command bar" />
                            <%include help_copy.html%>
                        </div>
                        <div id="move" class="hide">
                            <h1>Move</h1>
                            <p><img src="<%cfg.static_url%>/help/command-move.gif" alt="command bar" />
                            <%include help_move.html%>
                        </div>
                        <div id="rename" class="hide">
                            <h1>Rename</h1>
                            <p><img src="<%cfg.static_url%>/help/command-rename.gif" alt="command bar" />
                            <%include help_rename.html%>
                        </div>
                        <div id="delete" class="hide">
                            <h1>Delete</h1>
                            <p><img src="<%cfg.static_url%>/help/command-delete.gif" alt="command bar" />
                            <p>After checking off one or more files or directories, selecting the "Delete" option will permanently delete them.  If you've selected multiple files, you can choose to skip the deletion of individual files you've mistakenly checked, or to delete all files simultaneously.</p>
                        </div>
                        <div id="compress" class="hide">
                            <h1>Compress</h1>
                            <p><img src="<%cfg.static_url%>/help/command-compress.gif" alt="command bar" />
                            <%include help_compress.html%>
                        </div>
                        <div id="uncompress" class="hide">
                            <h1>Uncompress</h1>
                            <p><img src="<%cfg.static_url%>/help/command-uncompress.gif" alt="command bar" />
                            <%include help_uncompress.html%>
                        </div>
                        <div id="chmod" class="hide">
                            <h1>Chmod</h1>
                            <p><img src="<%cfg.static_url%>/help/command-chmod.gif" alt="command bar" />
                            <%include help_chmod.html%>
                        </div>
                        <div id="perl" class="hide">
                            <h1>Perl Check</h1>
                            <%include help_perl.html%>
                        </div>
                        <div id="tail" class="hide">
                            <h1>Tail</h1>
                            <%include help_tail.html%>
                        </div>
                        <div id="diff" class="hide">
                            <h1>Diff</h1>
                            <%include help_diff.html%>
                        </div>
                        <div id="print" class="hide">
                            <h1>Print</h1>
                            <p>After selecting one or more files, selecting the "Print" link will open a window displaying a preview of the file's printed appearance, as well as your regular print window.  If you select multiple files to be printed, you will be given the option of printing them separately or as one document.</p>
                        </div>
                    </div>
                </div>
                <div class="shadowbottom"><div class="shadowbottomleft"></div><div class="shadowbottomright"></div></div>
            </div>
        </div>
    </div>
</body>
</html>
