Annotation of calendarhelp/www/calfolder.html, revision 1.3

1.1       whiteley    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: 
1.3     ! whiteley  212: <p><a href="http://downloads.mozdev.org/calendarhelp/calfolder-0.2-en-US.xpi">calfolder-0.2-en-US.xpi</a></p>
1.1       whiteley  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>