--- doc/help/build_course_guide.tex 2005/09/01 20:35:03 1.7 +++ doc/help/build_course_guide.tex 2007/07/20 19:37:35 1.8 @@ -1,89 +1,94 @@ %% LyX 1.3 created this file. For more info, see http://www.lyx.org/. %% Do not edit unless you really know what you are doing. \documentclass[twocolumn,english]{article} +\usepackage{mathptmx} %\usepackage[T1]{fontenc} \usepackage[latin1]{inputenc} \usepackage{epsf} -\usepackage[verbose,letterpaper,tmargin=1.0in,bmargin=-0.125in,lmargin=.25in,rmargin=.25in]{geometry} +\usepackage[verbose,letterpaper,tmargin=1.0in,bmargin=-0.125in,lmargin=.5in,rmargin=.5in, columnsep=.3in]{geometry} \usepackage[tiny]{titlesec} -\makeatletter +% \makeatletter \usepackage{babel} \makeatother +\hyphenpenalty=5000 +\tolerance=1000 + \begin{document} \pagestyle{empty} \begin{flushleft} -\textbf{\LARGE{A Guide to Building Your Course}} -%\vspace{-.125in} -\textbf{http://www.lon-capa.org} +\textbf{\LARGE{\textsf{A Guide to Building Your Course}}} +\textbf{\textsf{http://www.lon-capa.org}} \end{flushleft} \vspace{.05in} \hrule height0.6pt \hfill \vspace{ .02in} \\ \vspace{-.25in} -\section*{Log In} +\section*{\large{\textsf{Log In}}} \begin{itemize} \item Log in with your username and password. \item Your browser must allow JavaScript and cookies. -\item If your browser allows pop-ups, the Remote Control (Fig. 1) will appear -for navigation. If not, you can use the Inline Menu (Fig. 2) or Main -Menu (Fig. 3) to navigate. -\item Your roles should appear. You can always go back to this screen through -{[}ROLES{]} on the Remote Control or the Main Menu. +\item Your roles screen should appear after logging in. \end{itemize} NOTE: If you only have one role, you will bypass this screen. - \begin{itemize} +\item You can always go back to this screen by clicking the +\underline{Roles} link on the Inline Menu which appears at the top of every page or by going to the Main Menu. \item Click the {[}Select{]} button next to the Course Coordinator role for the course you wish to work in. \item This course will now be displayed. \end{itemize} -\subsection*{Course Initialization Helper} +\subsection*{\textsf{\textsl{Course Initialization Helper}}} \begin{itemize} \item When entering your course for the first time, the Course Initialization Helper will appear. To keep the default LON-CAPA settings, click the {[}Next{]} button on each screen. To exit the Helper when done, click -the {[}Finish Course Initialization{]} button. You will then be directed to the Course Documents Screen. +the {[}Finish{]} button. You will then be directed to the Course Documents Screen. \end{itemize} -\section*{Course Documents {[}DOC{]}} +\section*{\large{\textsf{Course Documents}}} \begin{itemize} -\item Select {[}DOCS{]} from the Remote Control or Main Menu. This will -take you to the Course Documents screen, where you can import or upload -new documents to use in your course. +\item The Course Documents screen is where you can upload, import, and create documents for your course. +\item If you are not already at the Course Documents screen, click the \underline{Course Documents} link from the Inline Menu or Main Menu. \item You can use folders to organize your course in terms of Homework Sets, Chapters, and Units. After creating a folder (Ex: Unit 1), click on the folder icon to enter the folder and create a sub-folder (Ex: Chapter 1). -\item You can add material to your course by importing, uploading, or creating -new resources. \end{itemize} -NOTE: You cannot drag and drop resources. If you add a resource to -the wrong folder, delete it and add it to the correct folder. +NOTE: You cannot drag and drop resources. +If you add a resource to the wrong folder, use the \underline{Cut} link before the resource name. Navigate to the folder you wish to paste the resource and click the {[}Paste{]} button. +\subsection*{\textsf{Special Documents}} +\begin{itemize} +\item By clicking on the corresponding button, you can add a new folder, + syllabus, simple page, navigate contents page, simple problem, document drop-box, and more. +\item Click the {[}New Folder{]} button to add folders in your course. For example, you can create a folder called ``Homework Set 1'' and import homework problems to that folder. +\item Clicking the {[}Navigate Contents{]} button will add a Navigate Course +Contents resource page to your course. This is a good first resource for your course because it displays all of your course contents, such as your syllabus and problems sets. +\end{itemize} -\subsection*{Importing Published Documents} +\subsection*{\textsf{Importing Published Documents}} \begin{itemize} \item Go to the folder you want to add material to. -\item Click the {[}Import{]} button on the DOCS screen. +\item Click the {[}Import{]} button on the Course Documents screen. \item Browse published documents from the LON-CAPA resource pool. \item Select the documents you wish to use. \item Click the {[}Import{]} button to add documents to your course folder. -\item Finalize the order if more than one document was selected. -\item Click the {[}re-initializing course{]} button to make changes appear. +\item Finalize the order if more than one document was selected and then click the {[}Finish Import{]} button. +\item Click the {[}re-initializing Course{]} button to make changes appear. \end{itemize} -\subsection*{Search for Published Documents} +\subsection*{\textsf{Search for Published Documents}} \begin{itemize} -\item Click the {[}Search{]} button to search the LON-CAPA resource pool of published documents. +\item Click the {[}Search{]} button to search the LON-CAPA resource pool and upload documents. \end{itemize} -\subsection*{Uploading Documents from Your Computer} +\subsection*{\textsf{Uploading Documents from Your Computer}} \begin{itemize} \item Go to the folder you want to add material to. Click the {[}Browse{]} button to search for documents saved to your @@ -92,26 +97,44 @@ computer. button to import to your course. \end{itemize} -\subsection*{Special Documents} +\section*{\large{\textsf{Course Enrollment}}} +\begin{itemize} +\item Click the icon for managing student enrollment on the Main Menu. +\item This will bring you to the enrollment manager screen. +\item Click the link \underline{Automated Enrollment Manager} to modify your automated enrollment if your institution uses this feature. +\end{itemize} +Skip ahead to the Parameter Settings section if your institution uses automated enrollment. +\subsection*{\textsf{Uploading a Classlist}} \begin{itemize} -\item By clicking on the corresponding button, you can add a new folder, a -composite page, an external resource, a syllabus, a simple page, a navigate -contents page, a simple problem, a score upload form, a bulletin board, your -personal info, and info about another user, such as an instructor or TA. -\item Clicking the {[}Navigate Contents{]} button will add a Navigate Course -Contents resource page to your course. This is a good first resource for your course because it displays all of your course contents, such as your syllabus and problems sets. +\item Click the \underline{Upload a class list} link on the Enrollment Manager screen. +\item Your classlist can be in any of the following formats: CSV (comma separated values), semicolon separated values, space separated values, or tabular separated values. +\item You can save an Excel spreadsheet in a CSV format if you are creating your own classlist. +\item Classlist files must have values for student usernames at the minimum. +\item Browse and upload your classlist. +\item Match column samples to the appropriate enrollment fields. +\item If you are using student usernames shared by other systems with a common password, ask your domain coordinator which password authentication to choose. +\item Usernames used only for LON-CAPA can have intial passwords specified in the classlist or you can set an internally authenticated global password for all students. Only new accounts will be assigned a new password. \end{itemize} +HINT: Use the Reverse Association option to assign the same values to two different fields. For example, it is common to associate the student ID/number values for both the student ID field and the initial password. +\subsection*{\textsf{Resetting Student Passwords}} +\begin{itemize} +\item Only the student or the domain coordinator can change the student's password. +\item If LON-CAPA handles password authentication and an email address is specified in the student's preferences, a forgotten password can be recovered from the log-in screen. +\item Initial email addresses can be set during enrollment using either an uploaded classlist or automated course enrollment. +\item Students can set/change email addresses in their preferences. +\end{itemize} -\section*{Set/Modify Course Parameters {[}PARM{]}} +\section*{\large{\textsf{Set/Modify Course Parameter Settings}}} \begin{itemize} -\item Select {[}PARM{]} from the Remote Control or Main Menu. This will +\item Use the Course Parameter Settings to set parameters such as open date, due date, and number of tries. +\item Select the Clock Icon to \underline{Modify parameter settings} from the Main Menu. This will take you to the Set/Modify Course Parameters screen. \end{itemize} -\subsection*{Parameter Helper} +\subsection*{\textsf{Parameter Helper}} \begin{itemize} \item The Course Assessment Parameter Helper Mode is the easiest way to @@ -126,67 +149,53 @@ NOTE: Changes may take up to 10 minutes in your course. -\section*{Chart Student Progress {[}CHRT{]}} +\section*{\large{\textsf{Chart Student Progress}}} \begin{itemize} -\item Select {[}CHRT{]} from the Remote Control or Main Menu. This will -take you to the Course Statistics and Chart screen, where you can -generate a chart. +\item Select the plain spreadsheet icon on the Main Menu to to view the course assessment progress chart. \item Click the {[}Generate Chart{]} button to view the default chart for your class. \item You can modify this chart in terms of sections, student data, enrollment status, sequences and folders, output format, and output data. \end{itemize} -\subsection*{Output format} +\subsection*{\textsf{Output format}} \begin{itemize} -\item One of the options for your output is the Excel format. This will -generate an Excel 95 file: an older format that is often more compatible across various operating systems than newer formats. +\item The options for chart output include Excel and CSV formats. Both formats can be opened by Excel. \end{itemize} -\section*{Change Preferences {[}PREF{]}} +\section*{\large{\textsf{Change Preferences}}} \begin{itemize} -\item Select {[}PREF{]} on the Remote Control or Main Menu. This will take -you to the Change Preferences screen, where you can change your password -(if LON-CAPA takes care of checking it), your nickname or anonymous -discussion screen name, your message forward and notification addresses, -the language preferences, and various display and editor preferences. -You will also be able to edit the personal information on the About Me screen. +\item The Change Preferences screen allows you to set preferences such as password (if LON-CAPA takes care of checking it), nickname, anonymous discussion screen name, message forwarding and notification email addresses, language preferences, and various other display and editor preferences. +\item Under the My Space heading on the Main Menu, click the appropriate icon to set user preferences. \item Click on the link corresponding to what you'd like to change, ex: -Change Screen Name -\item Make your changes and submit. +\underline{Change Screen Name} +\item Make changes and save. +\item The \underline{Change Roles Page Preferences} allows you to configure a hotlist for your roles page. This is especially helpful if you manage many roles in LON-CAPA. \end{itemize} -{\epsfxsize=8in {\epsffile{graphics/build_course_guide_fig1.eps}} - -\newpage - -\section*{Print {[}PRT{]}} +\section*{\large{\textsf{Print}}} \begin{itemize} -\item The {[}PRT{]} button will only be accessible when you are looking -at one of your resources for your course. -\item Click the {[}PRT{]} button to open the print helper, which will help -you create a PDF document. +\item The option to generate a PDF printout will only be accessible when you are +viewing a resource in your course. +\item When viewing a resource, click the print icon to prepare a printable document. This will take you to the print helper. \end{itemize} -\section*{Getting Help} +\section*{\large{\textsf{Getting Help}}} \begin{itemize} \item Click on the small blue boxes with white question marks {[}?{]} for general topic help. -\item Click on the small orange boxes with white question marks for an overview -on the help and support available. -\item Submit enhancement requests using Bugzilla at http://bugs.lon-capa.org, -or by clicking on the bug icon. -\item Additional help at http://help.loncapa.org +\item Click on the \underline{Help} link in the upper-right-hand corner to access the LON-CAPA help/support screen. You can view and search the entire LON-CAPA manual from this screen. +\item Submit enhancement requests from the LON-CAPA help/support screen by clicking on the bug icon. +\item Click on the \underline{Return to last location link} to exit the help/support screen and return to your course. +\item Additional help at http://help.lon-capa.org \end{itemize} -\vspace{2.5in} -{\epsfxsize=3.75in \epsffile{graphics/build_course_guide_fig3.eps}} \\ Figure 3: Main Menu \end{document}