File:  [mozdev] / calendarhelp / www / calfolder.html
Revision 1.2: download - view: text, annotated - select for diffs - revision graph
Sun Aug 28 15:36:12 2005 UTC (13 years, 8 months ago) by whiteley
Branches: MAIN
CVS tags: HEAD
fix download link

    1: <h2>Calendar Folders</h2>
    2: 
    3: <p>
    4: <b>Calendar Folders</b> is an extension for future versions of Mozilla Calendar and Sunbird.
    5: It provides a way to group calendars in folders.
    6: It also provides a clock.
    7: </p>
    8: 
    9: <img src="./calfo0.png" style="margin-left:2em;">
   10: 
   11: <p>
   12: For installation instructions, see the <a href="#install">bottom</a> of this page.
   13: </p>
   14: 
   15: <p>
   16: The current version of Calendar Folders is a prototype for Sunbird 0.2+ test builds only.
   17: </p>
   18: 
   19: <p>
   20: In this prototype, some features do not work at all and some others are buggy.
   21: </p>
   22: 
   23: <p>
   24: There is no version of Calendar Folders for the current release, Sunbird 0.2,
   25: and there is no version for any Calendar extensions or Lightning.
   26: </p>
   27: 
   28: 
   29: <p>
   30: The <b>Calendar Folders</b> project is a subproject of <b>Calendar Help</b>.
   31: </p>
   32: 
   33: <h3>Why use Calendar Folders?</h3>
   34: <p>
   35: Use Calendar Folders when you often work with many calendars,
   36: so that you can easily view groups of calendars at the same time.
   37: </p>
   38: 
   39: <h3>Example</h3>
   40: <div style="margin-left:-4px; padding:4px; border:1px inset #f99; width:40em;">
   41: <p>
   42: You work on two projects, codenamed <i>Alum</i> and <i>Borax</i>.
   43: You have three colleagues Cedric, Daisy and Evan in your department.
   44: Cedric also works on Alum and Borax, but Daisy only works on Alum and Evan only works on Borax.
   45: </p>
   46: 
   47: <p>
   48: Each of you has a personal calendar and a calendar for each project.
   49: The project calendars are shared on a server.
   50: So there are ten calendars in all:
   51: four personal calendars, and six shared on the server.
   52: </p>
   53: 
   54: <p>
   55: In Sunbird, you can work with your personal calendar and the six shared calendars.
   56: (You cannot work with other people's personal calendars.)
   57: </p>
   58: 
   59: <p>
   60: Here the seven calendars that you can work with:
   61: </p>
   62: <img src="./calfo1.png" style="margin-left:2em;">
   63: 
   64: <h4>Working with your own calendars</h4>
   65: <p>
   66: To work with your own three calendars, you place them in a folder named Me:
   67: </p>
   68: <img src="./calfo2.png" style="margin-left:2em;">
   69: 
   70: <p>
   71: When you select this folder, you see these three calendars but no others.
   72: The default calendar for new entries is Personal.
   73: </p>
   74: 
   75: <h4>Working with project calendars</h4>
   76: <p>
   77: To work with project calendars, you place them in folders:
   78: </p>
   79: <img src="./calfo3.png" style="margin-left:2em;">
   80: 
   81: <p>
   82: When you select a project folder, you see the calendars for that project but no others.
   83: The default calendar for new entries is your calendar for the selected project.
   84: </p>
   85: 
   86: <p>
   87: Using Calendar Folders, you can also give the calendars different names and different
   88: colours in each folder.
   89: </p>
   90: 
   91: </div>
   92: 
   93: 
   94: <h3>Default folders</h3>
   95: <p>
   96: When you install <b>Calendar Folders</b> and restart sunbird,
   97: you two folders are created automatically, named <i>All</i> and <i>Default</i>.
   98: </p>
   99: 
  100: <p>
  101: The folder All is a special folder that contains all you calendars.
  102: It is very like Sunbird's original Calendars list.
  103: You cannot delete this folder (but you can rename it).
  104: </p>
  105: 
  106: <p>
  107: The folder Default contains whatever calendars are active when
  108: <b>Calendar Folders</b> first runs.
  109: You can work with this folder just like any other folder.
  110: </p>
  111: 
  112: 
  113: <h3>Working with calendars and folders</h3>
  114: <p>
  115: To work with calendars and folders, use the entries in the
  116: Calendar Folders list, and use the context menus.
  117: (To obtain a context menu, you can right-click, or use the Menu key
  118: on your keyboard, or use some other method depending on your system.)
  119: </p>
  120: 
  121: 
  122: <h4>Creating and maintaining a folder</h4>
  123: <p>
  124: To create a new folder, choose New Folder from the context menu.
  125: </p>
  126: <img src="./calfo4.png" style="margin-left:2em;">
  127: 
  128: <p>
  129: Give the new folder a name.
  130: </p>
  131: <img src="./calfo5.png" style="margin-left:2em;">
  132: 
  133: <p>
  134: To populate the new folder, drag calendars from the All folder and drop
  135: them in the new folder:
  136: </p>
  137: 
  138: <p>
  139: To specify the default calendar for new entries in the folder,
  140: click one calendar's icon.
  141: The icon displays a radio button to show that it is the default.
  142: </p>
  143: 
  144: <p>
  145: To remove a calendar from the folder, drag it back into All.
  146: </p>
  147: 
  148: 
  149: <h4>Changing calendar properties</h4>
  150: <p>
  151: The names and colours of calendars apply within a folder.
  152: So a calendar can have a different name and a different colour
  153: depending on the folder.
  154: </p>
  155: 
  156: <p>
  157: For example, in each project you might name the project manager's
  158: calendar Project Manager, and colour it blue.
  159: Suppose you are the project manager in one project.
  160: In that project's folder, your calendar is named Project Manager and
  161: has the coloour blue.
  162: But in other folders the same calendar has a different name and colour.
  163: </p>
  164: 
  165: <p>
  166: This feature can be confusing.
  167: Only use it if you have a specific purpose for different names and colours.
  168: </p>
  169: 
  170: <p>
  171: To rename a calendar, select it in the Folders panel, then click on its name.
  172: To change a calendar's colour, click on its colour patch in the Folders panel.
  173: </p>
  174: 
  175: <p>
  176: To reload a remote calendar, click on its reload marker (a small blue circle at the
  177: right of its colour patch).
  178: </p>
  179: 
  180: <h4>Options</h4>
  181: <p>
  182: To set options for Calendar Folders, choose Tools &ndash; Options... from the menu bar.
  183: Go to the Folders page.
  184: </p>
  185: 
  186: <p>
  187: Choose whether to display tabs for the clock and the original Calendars list.
  188: </p>
  189: 
  190: <p>
  191: Specify how to display the date and time in the clock.
  192: To use your operating system's settings, uncheck the Long box for the date
  193: and choose System for the time.
  194: </p>
  195: 
  196: <p>
  197: To ensure that only one folder can be selected at a time, check the Single folder box.
  198: </p>
  199: 
  200: <p>
  201: To lock calendar names or colours so that they remain consistent between folders,
  202: check the Name or Color boxes.
  203: </p>
  204: 
  205: 
  206: <h3 id="install">Installing Calendar Folders</h3>
  207: <p>
  208: To install Calendar Folders, choose Tools &ndash; Extensions... from Sunbird's menu bar.
  209: Drag this link and drop it in the Extensions window:
  210: </p>
  211: 
  212: <p><a href="http://downloads.mozdev.org/calendarhelp/calfolder-0.1-en-US.xpi">calfolder-0.1-en-US.xpi</a></p>
  213: 
  214: <p>
  215: Restart Sunbird.
  216: If the installation succeeds, you see the About Calendar Folders window.
  217: To dismiss it, click on the background of the window (or press Escape).
  218: </p>
  219: 
  220: <h4>Uninstalling Calendar Folders</h4>
  221: <p>
  222: To uninstall, return to the Extensions window.
  223: Select Calendar Folders and press the Uninstall button.
  224: Close Sunbird.
  225: </p>
  226: 
  227: <p>
  228: Go to your profile directory and delete the file <code>calfolder.rdf</code>.
  229: Edit the file <code>prefs.js</code> and remove all the entries that contain <tt>calfolder</tt>.
  230: Restart Sunbird.
  231: </p>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>