Versions Compared

Old Version 77

changes.mady.by.user Unknown User (shanxu@mit.edu)

Saved on

compared with

New Version Current

changes.mady.by.user Kristine Nyzio

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Composition Setup
defaultsHome^deck.properties
 
unmigrated-wiki-markup
Panel
borderColorwhite
bgColorwhite
borderWidth12px
h2.

Managing

Class

Content

{

Table of Contents

:

maxLevel

=

3

|

minLevel

=

3

|

style

=list} {bgcolor:E6E6FA} h3. Overview of Compound Documents {bgcolor} You can upload documents that contain more than a single file, such as an HTML page and its embedded web of pages. These files are referred to as compound documents. When adding such a document, first create a ZIP or JAR file that contains all related files in a hierarchy with a single top page, such as INDEX.HTML, in the hierarchy. The compressed file can include subdirectories. \\ \\ Because all pages in the compressed file are referenced relative to the top page, links to other pages should be relative links. That is, they should not have absolute URLs that include domain and web server names, but rather path names that show where they are in the hierarchy of pages under the top page, such as the following URL: contentdir/content_a.htm \\ \\ Any links to files outside the compressed file should be absolute links, as in the following URL: [http://web.mit.edu/]\\ \\ In order to add a compound document, first configure the class website to unpack compound documents. You do this by checking the Enable Unpacking Of ZIP Or JAR Files option on the [Website Settings] page. Your users can then click the title link of the document and see the top page in the browser, and all links work as they should within the document. If you do not configure the class website to handle compound documents, unpacking the file will be left to the browser when a user clicks the title link. Upload a compound document to a topic just as you would a single document. The only difference is that you must also select the option stating that the file is a ZIP or JAR file and enter the relative URL of the index page for a ZIP file. See Details on [Adding Documents] for more information. \\ [Return to Top|#Managing Class Content] {bgcolor:E6E6FA} h3. Adding Topics, Assignments, Documents, Webpages, and Weblinks {bgcolor} Topics are similar to file folders on a desktop, and you use topics to organize class/section materials---by lecture, by week, by subject unit, or by any other scheme appropriate to the class. You can add all class documents to one topic or create topics that represent an outline of the class materials, then add the appropriate materials to each topic. \\ You can create as many topics as needed for the class. Topics appear on the Materials page in the order that you create them, but you can reorder them. Adding Materials to a Stellar site can be a beneficial way to organize and distribute class materials among instructors and to students. * Assignments * Document * Webpages are displayed within the Stellar frame, with the class/section navigation bar to the left of the webpage. * Weblinks are links to resources outside the Stellar class website. The links are listed along with other topic documents, and you can choose to include the link in the navigation bar. h4. Directions to Add Topics to the Class / Section Site: # {toggle-cloak:id=1} Click on Materials in the navigation bar. {cloak:id=1} !materials.png|border=1px! {cloak} # {toggle-cloak:id=2} On the Materials page, click on the 'Add Topic' link. {cloak:id=2} !add_topic.png|border=1px! {cloak} # {toggle-cloak:id=3} On the 'Add Topic' page, enter a name or title that describes the topic. {cloak:id=3} !topic_name.png|border=1px! {cloak} # Click the 'Submit' button. As you create topics, they will appear on the materials page. h4. Directions to Add Materials to the Class / Section Site: # {toggle-cloak:id=4} Click Materials in the navigation bar. {cloak:id=4} !materials.png|border=1px! {cloak} # Scroll to the topic for which you want to add the material. # {toggle-cloak:id=5} Click the 'Add Material' dropdown menu and choose what type of material (Assignment, Document, Webpage, or Weblink) you wish to add. {cloak:id=5} !add_assignment.png|border=1px! {cloak} # Complete the entries on the Add Material page. Each type of material as it's own unique Add Materials page. # Click the 'Submit' button. h4. Directions to Add webpage/weblink to the Class / Section Site: Use this procedure to add your own webpages of class or section content to a topic on the Materials page. The webpage is displayed within a Stellar frame, with the class/section navigation bar to the left of the webpage. Students have access to the webpage by clicking its link under the associated topic on the Materials page. You can also choose to give students access to the webpage from the navigation bar. To add a webpage/weblink to a topic: # Click Materials in the navigation bar. # Scroll to the topic for which you want to add the webpage/weblink. # Click the topic's add webpage/weblink link. # Complete the entries on the Add Webpage/weblink Document page. # Click the Submit button. {info:title=Note:} * When a class website is first set up, it has a single topic, General. You can keep that topic, edit its name, or delete it. * Before preparing and uploading files, see the Recommended Document File Formats below. {info} h4. Using HTML You can enter either plain text or HTML-formatted text in any text box on a class or section website. If you enter plain text, Stellar adds minimal HTML formatting to display it on a class/section website page. For more advanced HTML formatting, either cut and paste code from an HTML editor, or type HTML text in the text box. \\ *Note:* Stellar automatically converts URLs that begin with [http://], [https://], ftp://, or news:// to live links. URLs enclosed in punctuation marks or brackets are not converted. \\ \\ For more information on using HTML see [http://www.w3.org/TR/html401/intro/intro.html]. h4. Recommended Document File Formats You can use any file format on a class website; however, the following file formats are recommended because users can readily access them with minimal compatibility issues: * HTML - You can enter either plain text or HTML-formatted text in any text boz on a class or section website. If you enter plain text, Stelar adds minimal HTML formatting to display it on a class/section website page. For more advanced HTML fomatting, either cut and paste code from an HTML editor, or type HTML text in the text box. (Note: Stellar automatically converts URLs that begin with [http://], [https://], ftp:// or news:// to live links. URLs enclosed in punctuation marks or brackets are not converted. For more information on using HTML see [http://www.w3org/TR/htrml401/intro/intro.html]. * PDF * GIF * JPG * MOV (Quicktime) * RM (Real Media) * DOC (Word)\* * XLS (Excel)\* * PPT (Powerpoint)\* * M (MATLAB)*\* * [Free viewers|http://office.microsoft.com/en-us/assistance/HA010449811033.aspx] are available for download from Microsoft. ** Available on Athena and for download to student-owned computers at no cost. Also can be purchased within the [MIT volume and site license program|http://web.mit.edu/is/products/vsls/]. \\ [Return to Top|#Managing Class Content] {anchor:Editing Materials} {bgcolor:E6E6FA} h3. Editing Topic Names, Assignments, Documents, Webpages, and Weblinks {bgcolor} h5. Directions to Edit Topic Names and Materials: # {toggle-cloak:id=6} Click Materials in the Navigation Bar {cloak:id=6} !materials.png|border=1px! {cloak} # {toggle-cloak:id=7} Click 'Edit' next to the document you want to edit. {cloak:id=7} !edit_material.png|border=1px! {cloak} # Make the changes on your document, webpage, or weblink. # Remember to hit 'Submit' after every edit to save your work\! [Return to Top|#Managing Class Content] {bgcolor:E6E6FA} h3. Deleting Topics, Assignments, Documents, Webpages, and Weblinks {bgcolor} h5. Directions to Delete Topics and Materials: # {toggle-cloak:id=8} Click Materials in the navigation bar. {cloak:id=8} !materials.png|border=1px! {cloak} # Scroll to the topic or material you want to delete. # {toggle-cloak:id=9} Click the (X) next to the desired topic or material. Stellar displays the Delete Topic or Delete Document page. {cloak:id=9} !delete_material.png|border=1px! {cloak} # Confirm that the correct topic or material is listed for deletion. # Click the delete button. {info:title=You cannot delete a topic if it contains course materials. First delete all course materials for the topic and then delete the topic.} [Return to Top|#Managing Class Content] {bgcolor:E6E6FA} h3. Adding and Editing Introductory Text on the Materials Page {bgcolor} h5. Directions to add or edit Introductory Text: Instructors have the option of adding an introduction to the class/section materials or instructions for students regarding topics and documents on the Materials page. The introduction appears near the top of the Materials page, before the topics. To add or edit the introductory text: # Click Materials in the navigation bar. # Click the add intro text or edit intro text link near the top of the Materials page. !Add intro text ss.jpg! Stellar displays the Edit Intro Text page. # Type the introduction using plain text or HTML tags. # Click the Submit button. [Return to Top|#Managing Class Content] {bgcolor:E6E6FA} h3. Importing Class Content from a Previous Stellar Website {bgcolor} Each semester you teach a class, you need a new class website. However, rather than re-creating the class content, you can import it from a prior class's website. You can import topics, documents, and/or assignments from the entire class or just a section. Tip: You can import information from more than one class. For example, first import some topics from class A, then repeat the procedure to import topics from class B. h5. Directions to Import Class Content: # Do one of the following: #* {toggle-cloak:id=10} Click Materials in the navigation bar. Then click the import content from another class website link. {cloak:id=10} !import_content.png|border=1px! {cloak} #* {toggle-cloak:id=11} Click the Website Settings link at the bottom of the navigation bar. Then click the Import Content link. {cloak:id=11} !website_settings.png|border=1px! {cloak} # {toggle-cloak:id=12} Select the class or section from which you want to import content from the dropdown menu. {cloak:id=12} !import.png|border=1px! {cloak} # Click the 'Submit' button. The Import page now lists all the information that you can import from the selected class or section. # (Optional) Click the From link to display the class from which you are importing content in another browser window. # Select a destination for the imported materials. Choose one of the three options below. Choose to: #* Copy the content into corresponding Course Topics where Stellar will create new Topic headings, if required. #* Copy the content into an existing Course Topic that you select from corresponding drop-down list. #* Copy the content into a new Course Topic where you enter the new Topic name into the corresponding text field. # Select the materials to copy. (You can select each item individually or click the 'Select All' and 'Unselect All' buttons to select all or none of the items.) # Click the Import button. {info:title=Imported documents and assignment have the schedule and due dates from the prior class. You need to edit the documents, change the dates, and select whether to post them on the schedule.} [Return to Top|#Managing Class Content] {bgcolor:E6E6FA} h3. Exporting Class or Section Materials {bgcolor} Stellar can download a .zip file of all documents, webpages, and weblinks listed on the Materials page for you to download onto your computer. h5. Directions to Export Class / Section Materials: # {toggle-cloak:id=15} Click Materials on the navigation bar, then click the 'Export Class Materials' link. {cloak:id=15} !export.png|border=1px! {cloak} # Wait while Stellar creates the .zip file. (Depending on the number and size of material documents, creating the .zip file can take up to half an hour.) Stellar displays a message that the .zip file is available. # Click the 'Download Zip' button. # Specify the folder location for the downloaded file. {info:title=The .zip file includes the document paths. When extracting documents you may want to specify a folder/directory on your computer.} When the materials are downloaded onto your computer the folder will organize course materials into two folders: homework and topics. The assignments for your class will be located in the homework folder while other materials will be organized in the topics folder. The topic folders will be labeled Topic 1, Topic 2, etc. according to the order of the topics on your site. Within each topic folder, the materials will be organized by type of material. [Return to Top|#Managing Class Content] {bgcolor:E6E6FA} h3. Troubleshooting Uploading Documents {bgcolor} The following problems are frequently encountered when uploading documents to a class website: h4. When students click the document's title, the content comes up in the browser window in error. Although the error shows up when a user attempts to view or download the file, the cause of problem may be in the upload process.  Make sure the file that was uploaded has been saved with the appropriate file extension (e.g., doc).   Windows-based applications generally name documents properly, but other operating systems (e.g., Mac OS) may not.  Please check the File/Document  type and re-save your document.  Otherwise, start fresh by uploading the original file in a "new" document. h4. The uploaded file is a document that requires a separate application in order to read it (e.g., Microsoft Word). Some students cannot access the document's contents, even though they have that application. Adding documents created in certain applications, such as Word, may introduce platform and version compatibility problems. See Recommended Document File Formats for a list of document types to use to avoid this problem. Also, save documents using commonly available software versions rather than the newest release, which students may not have yet. h4. After editing and uploading a new version of a document, clicking its link still displays the old version of the document. The old document is probably stored in your web browser's cache. Empty the browser's cache (Firefox: Preferences > Privacy > Clear Private Data) (Internet Explorer: Tools > Options > General > Temporary Internet Files > Delete Files) (Safari: Safari > Empty Cache) . The next time you click the link the browser will load the new document. Other visitors to the site will not need to do this, because the older document is probably not in their cache. [Return to Top|#Managing Class Content]

list

Background Color
colorE6E6FA

Topics are similar to file folders on a desktop, and you use topics to organize class/section materials – by lecture, by week, by subject unit, or by any other scheme appropriate to the class. You can add all class documents to one topic or create topics that represent an outline of the class materials, then add the appropriate materials to each topic.
You can create as many topics as needed for the class. Topics appear on the Materials page in the order that you create them, but you can reorder them.

Adding Materials to a Stellar site can be a beneficial way to organize and distribute class materials among instructors and to students.

  • Assignments
  • Documents
  • Webpages are displayed within the Stellar frame, with the class/section navigation bar to the left of the webpage.
  • Weblinks are links to resources outside the Stellar class website. The links are listed along with other topic documents, and you can choose to include the link in the navigation bar.

Directions to Add Topics to the Class / Section Site:

  1. Toggle Cloak
    id1
    Click on "Materials" in the navigation bar.

    Cloak
    id1

  2. Toggle Cloak
    id2
    On the Materials page, click the "Add Topic" link.

    Cloak
    id2

  3. Toggle Cloak
    id3
    On the Add Topic page, enter a name or title that describes the topic.

    Cloak
    id3

  4. Click the "Submit" button.
    As you create topics, they will appear on the materials page.

Directions to Add Materials to the Class / Section Site:

  1. Toggle Cloak
    id4
    Click "Materials" in the navigation bar.

    Cloak
    id4

  2. Scroll to the topic for which you want to add the material.

  3. Toggle Cloak
    id5
    Click the "Add Material" dropdown menu and choose what type of material (Assignment, Document, Webpage, or Weblink) you wish to add.

    Cloak
    id5

  4. Complete the entries on the Add Material page. Each type of material has its own unique Add Materials page.
  5. Click the "Submit" button.

Directions to Add Webpage/Weblink to the Class/Section Site:

Use this procedure to add your own webpages of class or section content to a topic on the Materials page. The webpage is displayed within a Stellar frame, with the class/section navigation bar to the left of the webpage. Students have access to the webpage by clicking its link under the associated topic on the Materials page. You can also choose to give students access to the webpage from the navigation bar.

To add a webpage/weblink to a topic:

  1. Click "Materials" in the navigation bar.
  2. Scroll to the topic for which you want to add the webpage/weblink.
  3. Click the topic's "add webpage/weblink" link.
  4. Complete the entries on the Add Webpage/weblink Document page.
  5. Click the "Submit" button.
Info
titleNote:
  • When a class website is first set up, it has a single topic: General. You can keep that topic, edit its name, or delete it.
  • Before preparing and uploading files, see the Recommended Document File Formats below.
  • There is a size limit of 250 MB for any file uploads.

Using HTML

You can enter either plain text or HTML-formatted text in any text box on a class or section website. If you enter plain text, Stellar adds minimal HTML formatting to display it on a class/section website page. For more advanced HTML formatting, either cut and paste code from an HTML editor or type HTML text in the text box.
Note: Stellar automatically converts URLs that begin with http://, https://, ftp://, or news:// to live links. URLs enclosed in punctuation marks or brackets are not converted.

For more information on using HTML see www.w3.org.

Recommended Document File Formats

You can use any file format on a class website; however, the following file formats are recommended because users can readily access them with minimal compatibility issues:

  • HTML - You can enter either plain text or HTML-formatted text in any text boz on a class or section website. If you enter plain text, Stelar adds minimal HTML formatting to display it on a class/section website page. For more advanced HTML fomatting, either cut and paste code from an HTML editor, or type HTML text in the text box. (Note: Stellar automatically converts URLs that begin with http://, https://, ftp:// or news:// to live links. URLs enclosed in punctuation marks or brackets are not converted.
    For more information on using HTML see www.w3.org.
  • PDF
  • GIF
  • JPG
  • ZIP
  • MOV (Quicktime)
  • RM (Real Media)
  • DOC (Word)*
  • XLS (Excel)*
  • PPT (Powerpoint)*
  • M (MATLAB)**
  • Free viewers are available for download from Microsoft. (Available on Athena and for download to student-owned computers at no cost.)


Return to Top

Anchor
Editing Materials
Editing Materials

Background Color
colorE6E6FA
Directions to Edit Topic Names and Materials:

  1. Toggle Cloak
    id6
    Click "Materials" in the navigation bar.

    Cloak
    id6

  2. Toggle Cloak
    id7
    Click "Edit" next to the document you want to edit.

    Cloak
    id7

  3. Make the changes on your document, webpage, or weblink.
  4. Click the "Submit" button after every edit to save your work!

Return to Top

Background Color
colorE6E6FA
Directions to Delete Topics and Materials:

  1. Toggle Cloak
    id8
    Click "Materials" in the navigation bar.

    Cloak
    id8

  2. Scroll to the topic or material you want to delete.

  3. Toggle Cloak
    id9
    Click the "(X)" next to the desired topic or material. Result: Stellar displays the Delete Topic or Delete Document page.

    Cloak
    id9

  4. Confirm that the correct topic or material is listed for deletion.
  5. Click the "Delete" button.
Info
titleYou cannot delete a topic if it contains course materials. First delete all course materials for the topic and then delete the topic.
 

Return to Top

Background Color
colorE6E6FA

Adding and Editing Introductory Text on the Materials Page

Directions to add or edit Introductory Text:

Instructors have the option of adding an introduction to the class/section materials or instructions for students regarding topics and documents on the Materials page. The introduction appears near the top of the Materials page, before the topics.

To add or edit the introductory text:

  1. Click "Materials" in the navigation bar.
  2. Click the "add intro text" or "edit intro text" link near the top of the Materials page.
    Image Added
    Result: Stellar displays the Edit Intro Text page.
  3. Type the introduction using plain text or HTML tags.
  4. Click the "Submit" button.

Return to Top

Background Color
colorE6E6FA

Importing Class Content from a Previous Stellar Website

Each semester that you teach a class, you need a new class website. However, rather than re-creating the class content, you can import it from a prior class's website. You can import topics, documents, and/or assignments from the entire class or just a section.

Tip: You can import information from more than one class. For example, first import some topics from class A, then repeat the procedure to import topics from class B.

Directions to Import Class Content:
  1. Do one of the following:

    • Toggle Cloak
      id10
      Click "Materials" in the navigation bar. Then click the "Import content from another class website" link.

      Cloak
      id10

    • Toggle Cloak
      id11
      Click the "Website Settings" link at the bottom of the navigation bar. Then click the "Import Content" link.

      Cloak
      id11

  2. Toggle Cloak
    id12
    Select the class or section from which you want to import content from the dropdown menu.

    Cloak
    id12

  3. Click the "Submit" button.
    Result: The Import page now lists all the information that you can import from the selected class or section.
  4. (Optional) Click the "From" link to display the class from which you are importing content in another browser window.
  5. Select a destination for the imported materials.
    Choose one of the three options:
    • Copy the content into corresponding Course Topics where Stellar will create new Topic headings, if required.
    • Copy the content into an existing Course Topic that you select from corresponding drop-down list.
    • Copy the content into a new Course Topic where you enter the new Topic name into the corresponding text field.
  6. Select the materials to copy. (You can select each item individually or click the "Select All" and "Unselect All" buttons to select all or none of the items.)

  7. Click the "Import" button.

    Info
    titleImported documents and assignment have the schedule and due dates from the prior class. You need to edit the documents, change the dates, and select whether to post them on the schedule.
     

Return to Top

Background Color
colorE6E6FA

Exporting Class or Section Materials


Stellar can download a .zip file of all documents, webpages, and weblinks listed on the Materials page for you to download onto your computer.

Note
titleStudents cannot export topics that contain materials marked as "restricted use". Instructors can export all materials.
 
Directions to Export Class / Section Materials:

  1. Toggle Cloak
    id15
    Click "Materials" on the navigation bar, then click the "Export Class Materials" link.

    Cloak
    id15

  2. Wait while Stellar creates the .zip file. (Depending on the number and size of material documents, creating the .zip file can take up to 30 minutes.)
    Result: Stellar displays a message that the .zip file is available.
  3. Click the "Download Zip" button.

  4. Specify the folder location for the downloaded file.

    Info
    titleThe .zip file includes the document paths. When extracting documents you may want to specify a folder/directory on your computer.
     

When the materials are downloaded onto your computer, the folder will organize course materials into two folders: Homework and Topics. The assignments for your class will be located in the Homework folder while other materials will be organized in the Topics folder. The topic folders will be labeled Topic 1, Topic 2, etc. according to the order of the topics on your site. Within each topic folder, the materials will be organized by type of material.

Return to Top

Background Color
colorE6E6FA

Troubleshooting Uploading Documents

The following problems are frequently encountered when uploading documents to a class website:

When students click the document's title, the content comes up in the browser window in error.

Although the error shows up when a user attempts to view or download the file, the cause of problem may be in the upload process.  Make sure the file that was uploaded has been saved with the appropriate file extension (e.g., .doc). Windows-based applications generally name documents properly, but other operating systems (e.g., Mac OS) may not. Check the File/Document  type and re-save your document.  Otherwise, start fresh by uploading the original file in a "new" document.

The uploaded file is a document that requires a separate application in order to read it (e.g., Microsoft Word). Some students cannot access the document's contents, even though they have that application.

Adding documents created in certain applications, such as Word, may introduce platform and version compatibility problems. See Recommended Document File Formats (above) for a list of document types to use to avoid this problem. Also, save documents using commonly available software versions rather than the newest release, which students may not have yet.

After editing and uploading a new version of a document, clicking its link still displays the old version of the document.

The old document is probably stored in your web browser's cache. Empty the browser's cache. The next time you click the link the browser will load the new document. Other visitors to the site will not need to do this, because the older document is probably not in their cache.

Return to Top