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

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: 
        !           212: <p><a href="">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>