Modules A module is a cnxml/mathml page that contains information on a specific subject. The length of modules will vary, depending on the author. What is important is to remember that the author should attempt to make each module as independent as possible. While it is understood that some knowledge is always a prerequisite for understanding, it is our goal to make it so that anyone reading the module will be able to understand the module with little supplemental material.

Managing modules There are three ways you are able to manage the modules: Create a new module Add existing modules to your workgroup Edit/Preview modules Each of these management options will be explained further below.

Creating Modules Authors can create modules from two places: Workgroup Homepage Module Management Homepage

Creating modules from the Workgroup Homepage If you are not currently in a workgroup, enter a workgroup (click on "Module Authoring" under "Author Home" in the sidebar and then click on "Enter Group" next to a workgroup). If you are already in a workgroup, click on its name at the top of the screen to return to its home page. Click on "Create New Module". You will be asked to enter a module title and to decide whether you want the module initialized for MathML use. If you will be using math in the module, check this box. When you're done, press the "Create Module" button. You will be taken to a screen confirming that the module has been created (if it was not successfully created, there will be an error message here). Click on the name of your workgroup to return to its home page. The module you have just created will be listed under "Modules" in the workgroup contents overview.

Creating modules from the 'Manage Modules' page If you are not currently in a workgroup, enter a workgroup (click on "Module Authoring" under "Author Home" in the sidebar and then click on the group name that you wish to enter). Click on "Create New Module". You will be asked to enter a module title and to decide whether you want the module initialized for MathML use. If you will be using math in the module, check this box. When you're done, press the "Create Module" button. You will be taken to a screen confirming that the module has been created (if it was not successfully created, there will be an error message here). Click on the name of your workgroup to return to its home page. The module you have just created will be listed under "Object" in the manage workgroup contents page.

Adding/Removing Modules from a Workgroup To add or remove modules from a workgroup simply click on the 'manage modules' link on the workgroup homepage. This will take you to another page where you can search for existing modules and add them to your workgroup.

Screenshot of add/remove page.

Adding Modules to a Workgroup Use the search field at the bottom of the page to search for module by id, title, author, keyword, or maintainer. Enter search items in the text field and hit the "search button". The matching modules will be listed below the search field and above the add to workgroup button as shown in the Add/Remove Figure. Simply check the boxes of the modules that you would like added to the workgroup and click on the "Add to Workgroup" button. The list at the top of the page will be updated to include the added modules.

Removing Modules from a workgroup To remove modules from a workgroup simply check the boxes next to the modules you wish removed from the workgroup and hit the "Remove from Workgroup" button. The page will reload and update the list of modules currently in the workgroup. From the add/remove modules page you can navigate to the edit page of any of the modules in your workgroup. Simply click on the name of the module to be taken to the module editing page for that particular module. You can also navigate to any other point in the module by clicking on the location you wish to visit on the horizontal navigation bar.

Editing and Previewing Modules Once you have added modules to your workgroup you may wish to do something with them! First of all you can immediately preview the module whether or not it is a new module or an old module that you have checked out from the repository.

Previewing/Viewing Modules in the Workgroup To preview/view modules in the workgroup first click on the 'manage modules' link from the workgroup homepage. Next click on the preview icon next to the name of the module you wish to preview. The preview icon looks like a monitor with a magnifying glass hovering over it. This will display the most current version of a module.

Editing Modules If you have just created a new module you can begin editing modules immediately. If you have added a module to the repository you can edit it only after you have 'checked out' the module. For more information on this see the Editing Modules module.

Editing Modules that have just been created From the manage modules page click on the 'edit text' icon next to the name of the module to begin editing the module. This will take you to the main editing page for the module. For more information on actually editing the module take a look at the Editing Modules module.