[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Calendar_Add_Announcement.tex Calendar_Remove_Announcement.tex Course_Add_Other.tex Course_Editing_Custom_Roles.tex Course_Manually_Grade_Problem.tex Developer_Tutorial.tex Docs_Adding_External_Resource.tex Docs_Adding_Syllabux.tex Docs_Score_Upload_Form.tex

bowersj2 lon-capa-cvs@mail.lon-capa.org
Mon, 25 Aug 2003 19:22:03 -0000


This is a MIME encoded message

--bowersj21061839323
Content-Type: text/plain

bowersj2		Mon Aug 25 15:22:03 2003 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Course_Add_Other.tex 
                             	Course_Editing_Custom_Roles.tex 
                             	Course_Manually_Grade_Problem.tex 
                             	Docs_Adding_Syllabux.tex 

  Modified files:              
    /loncom/html/adm/help/tex	Calendar_Add_Announcement.tex 
                             	Calendar_Remove_Announcement.tex 
                             	Developer_Tutorial.tex 
                             	Docs_Adding_External_Resource.tex 
                             	Docs_Score_Upload_Form.tex 
  Log:
  Evidence that I'm working. ;-)
  
  
--bowersj21061839323
Content-Type: text/plain
Content-Disposition: attachment; filename="bowersj2-20030825152203.txt"

Index: loncom/html/adm/help/tex/Calendar_Add_Announcement.tex
diff -u loncom/html/adm/help/tex/Calendar_Add_Announcement.tex:1.2 loncom/html/adm/help/tex/Calendar_Add_Announcement.tex:1.3
--- loncom/html/adm/help/tex/Calendar_Add_Announcement.tex:1.2	Mon Jun  2 15:54:21 2003
+++ loncom/html/adm/help/tex/Calendar_Add_Announcement.tex	Mon Aug 25 15:22:03 2003
@@ -1,7 +1,7 @@
 \label{Calendar_Add_Announcement}
 
 A user can add an announcement to the calendar by clicking \textbf{CLDR} on the
-remote control. The Announcements and Calendar screen will open. Using
+remote control. The \textbf{Announcements and Calendar} screen will open. Using
 the pull down menus click on the Starting time and the Ending
 time. Type the announcement in text box and click Post
 Announcement. The announcement will now appear on the specific date(s)
Index: loncom/html/adm/help/tex/Calendar_Remove_Announcement.tex
diff -u loncom/html/adm/help/tex/Calendar_Remove_Announcement.tex:1.2 loncom/html/adm/help/tex/Calendar_Remove_Announcement.tex:1.3
--- loncom/html/adm/help/tex/Calendar_Remove_Announcement.tex:1.2	Mon Jun  2 15:54:21 2003
+++ loncom/html/adm/help/tex/Calendar_Remove_Announcement.tex	Mon Aug 25 15:22:03 2003
@@ -7,4 +7,4 @@
 next to the announcement. If the announcement is not in the current
 month then use the \textbf{Previous Month} and \textbf{Next Month} links to move to the
 correct month. After the user has selected the announcement click
-Remove Checked Entries.  
+\textbf{Remove Checked Entries}.  
Index: loncom/html/adm/help/tex/Developer_Tutorial.tex
diff -u loncom/html/adm/help/tex/Developer_Tutorial.tex:1.1 loncom/html/adm/help/tex/Developer_Tutorial.tex:1.2
--- loncom/html/adm/help/tex/Developer_Tutorial.tex:1.1	Wed Aug 20 12:17:40 2003
+++ loncom/html/adm/help/tex/Developer_Tutorial.tex	Mon Aug 25 15:22:03 2003
@@ -252,7 +252,7 @@
 something is wrong with your \texttt{loncapa\_apache.conf} file. Please
 double check the entry to make sure it is in the right place, that
 it is typed correctly, and that all the lines are present. If it is
-still incorrect, please ask for help on the \texttt{lon-capa-dev@mail.msu.edu}
+still incorrect, please ask for help on the \texttt{lon-capa-dev@mail.lon-capa.org}
 list, including a copy of your \texttt{loncapa\_apache.conf} file
 in the email; either something is wrong that is beyond the scope of
 this document(other system configuration issues) or you really can't
@@ -277,7 +277,7 @@
 Since I can't guess what error you encountered, I'm afraid I can't
 help you out here. But I do know the code I wrote above worked, so
 as a last resort try to figure out what is different. If you are absolutely
-stumped, please ask for help on the \texttt{lon-capa-dev@mail.msu.edu}
+stumped, please ask for help on the \texttt{lon-capa-dev@mail.lon-capa.org}
 list, including a copy of your \texttt{lontutorial.pm} file in the
 email; either something is wrong that is beyond the scope of this
 document (other system configuration issues) or you really can't find
@@ -479,8 +479,10 @@
 takes in a hash reference instead of a traditional list of arguments.
 For full information about what that function takes, consult the documentation.
 \texttt{'cols'} will tell the render function what to render in the
-navmap; {}``0'' is the standard listing of the resource with a link
-to the resource. \texttt{'showParts' => 0} tells the render function
+navmap; {}``Apache::lonnavmaps::resource'' is a constant that
+indicates the standard listing of the resource with a link 
+to the resource, which is the first column of the \textbf{NAV} display
+you are used to. \texttt{'showParts' => 0} tells the render function
 not to show individual parts, which will not be useful to us. \texttt{'r'
 => \$r} passes the Apache response object to the \texttt{render} function,
 which it uses to provide periodic output to the user by using the
@@ -570,7 +572,10 @@
 Note this only applies to POST'ed data. If you use GET, the data will
 appear on the query string. For your code, this will show up in \texttt{\$ENV\{QUERY\_STRING\}}.
 If you want to invoke LON-CAPA's processing on that string, so you
-see the variables in \texttt{\%ENV}, use \texttt{Apache::loncommon::get\_unprocessed\_cgi(\$ENV\{QUERY\_STRING\});}.
+see the variables in \texttt{\%ENV}, use
+\texttt{Apache::loncommon::get\_unprocessed\_cgi(\$ENV\{QUERY\_STRING\});}.
+This is particularly useful for cases where input may be coming in via
+either POST or GET.
 
 
 \subsubsection{Adding Checkboxes for Input}
@@ -579,7 +584,8 @@
 we have a place to input our selections. In order to do that, we need
 to provide the rendering code with a subroutine that will take an
 \texttt{Apache::lonnavmaps::resource} object and return the string
-we want to print, including the <td> and </td> tags. (For more information,
+we want to print, including the \texttt{td} and 
+\texttt{/td} tags. (For more information,
 consult the \texttt{Apache::lonnavmaps::render} documentation.) Add
 the following after the second and last \texttt{send\_http\_header}
 line:
Index: loncom/html/adm/help/tex/Docs_Adding_External_Resource.tex
diff -u loncom/html/adm/help/tex/Docs_Adding_External_Resource.tex:1.1 loncom/html/adm/help/tex/Docs_Adding_External_Resource.tex:1.2
--- loncom/html/adm/help/tex/Docs_Adding_External_Resource.tex:1.1	Fri Dec 13 13:33:23 2002
+++ loncom/html/adm/help/tex/Docs_Adding_External_Resource.tex	Mon Aug 25 15:22:03 2003
@@ -1,14 +1,19 @@
-\label{Docs_Adding_External_Resource}Resources not included in the LON-CAPA
+\label{Docs_Adding_External_Resource}
+
+Resources not included in the LON-CAPA
 content network can be added to the course by clicking the \textbf{External
-Resource} button on the Course Documents screen. A window will come up which
-will allow you to type the URL of the web resource you wish to add.
+Resource} button on the Course Documents screen.
+
+\begin{enumerate}
 
-When you've typed a URL, click the \textbf{View} button to see it in the
-frame below the entry fields. Click the \textbf{Choose} button to choose
-this resource to add to your course, if it is the correct resource. If not,
-either correct the URL and try \textbf{View}ing it again, or click \textbf{Cancel}
-to not add any resource to the course at all.
+\item Type in the title of the web resource you wish to add in the \textbf{Title} text box.
+\item Type in the URL of the web resource in the \textbf{URL} text box.
+\item Click \textbf{View} to see if the web resource is in the frame below the entry fields.
+\item Click \textbf{Choose} to add the web resource to the course.
+
+\end{enumerate}
 
 The new resource will appear in the course next time you \textbf{Re-Initialize}
 the course on your \textbf{ROLES} screen, or login, whichever comes first.
+
 
Index: loncom/html/adm/help/tex/Docs_Score_Upload_Form.tex
diff -u loncom/html/adm/help/tex/Docs_Score_Upload_Form.tex:1.1 loncom/html/adm/help/tex/Docs_Score_Upload_Form.tex:1.2
--- loncom/html/adm/help/tex/Docs_Score_Upload_Form.tex:1.1	Tue Jul 15 16:01:34 2003
+++ loncom/html/adm/help/tex/Docs_Score_Upload_Form.tex	Mon Aug 25 15:22:03 2003
@@ -6,3 +6,17 @@
 any other assignment. The easiest way to do this is via the \textbf{PGRD} score
 upload screen, which allows you to upload a CSV file containing student's
 scores.
+
+To create a Score Upload Form, do the following:
+
+\begin{enumerate}
+
+\item Log in to the course you wish to add a score upload form to.
+\item Click \textbf{DOCS} on the remote control.
+\item At the \textbf{Course Document} screen, click the \textbf{Score
+Upload Form} button in the Special Document Column. 
+\item At the window pop up type the name of the Score Upload Form and click OK
+
+\end{enumerate}
+
+The page will be added to the end of the current course document folder.

Index: loncom/html/adm/help/tex/Course_Add_Other.tex
+++ loncom/html/adm/help/tex/Course_Add_Other.tex
\label{Course_Add_Other}

To enroll TAs, instructors, guest, ect, to the course the user would first follow 
the same process as enrolling a student, as in \ref{Course_Add_Student}.
You may also need to create the role you wish to assign the user; see
how to create a custom role in \ref{Course_Editing_Custom_Roles}.

After you have enrolled the person and created the new role if nessecary, do the
following:

\begin{enumerate}

\item Click \textbf{CUSR} on the remote control.
\item At the \textbf{Create User, Change User Privileges} sreen, type the username 
in the username text box or click the \textbf{Select User} link. The screen will then 
display the current class list. Select a username to modify the user privileges.
\item Click \textbf{User Roles}.
\item At the \textbf{Change User Privileges} screen for the selected user, scroll down to \textbf{Add Roles}.
\item Click the box next to the roles you wish to activate for the selected user.
\item Set the starting dates and ending dates for each role you selected.
\item Click \textbf{Modify User}.

\end{enumerate}

Index: loncom/html/adm/help/tex/Course_Editing_Custom_Roles.tex
+++ loncom/html/adm/help/tex/Course_Editing_Custom_Roles.tex
\label{Course_Editing_Custom_Roles}

To edit a custom role privileges, do the following:

\begin{enumerate}

\item Click \textbf{CUSR} on the remote control, or if you are using the
text menu, select \textbf{Main Menu}, then \textbf{user roles}.

\item At the \textbf{Create Users, Change User Privileges} screen
  under the heading \textbf{Edit Custom Role Privileges}, select the
  role you wish to edit from the drop down menu.

  To create a new role, select \textbf{Generate new role ...} from the
  drop-down menu, and give the new role a name.

\item Click \textbf{Custom Role Editor}.
The screen will display the privileges set and available to select for this role.

\item Update the privileges you wish this custom role to have.

\item Click \textbf{Define Role}.

\end{enumerate}

Index: loncom/html/adm/help/tex/Course_Manually_Grade_Problem.tex
+++ loncom/html/adm/help/tex/Course_Manually_Grade_Problem.tex
\label{Course_Manually_Grade_Problem}

To manually grade a problem, do the following:

\begin{enumerate}

\item Log in to the course.
\item Navigate to the problem you want to grade.
\item Click \textbf{PGRD} on the remote control, or select the \textbf{problem
  grades} option from the textual menu.
\item At the grading menu, select the desired section and student
  status from the drop down menus.
\item Select one of the following: 

\begin{itemize}

\item \textbf{Current Resource: For one or more students}: Grades the
  current resource for as many students at once as you'd like
\item \textbf{Current Resource: For all students in selected section
  or course}: A shortcut for grading an entire section at a time, or 
\item \textbf{The complete Set/Page/Sequence: For one student}

\end{itemize}

\textbf{Note}: If you choose \textbf{Current Resource: For one or more
  students}  you will also need to select if you want to view only
  students with submission or all students.

\item Click \textbf{Next->}.


  \textbf{For Current Resource: For one or more student Continue here}:

\item At the \textbf{View/Grade/Regrade Submission for a Student or a
  Group of Students} screen, select whether you wish to see the
  problem text along with the answers. \textbf{no} will show no
  problem texts, and \textbf{one student} will show only the first
  student's problem text; this is useful for non-randomized
  questions. \textbf{all students} will show the problem text for all
  students.

\item Select the level of submission detail you want to view.
\item Select the student(s) to View/Grade/Regrade.
\item Click \textbf{Next->}.
\item At the submission record screen, review the answers and select the points you 
wish to assign the student(s). You also have the option to excuse the student(s) 
from the problem by using the problem weight pull down menu.

\textbf{Note}: The computer has automatically graded all the Problems
with a red check mark. You can of course change the scoring for these
problems, but there are few faster ways to alienate your students then
marking things as incorrect the computer said were correct.

\item After you have finished viewing or manually grading the problem answers, using 
the pull down menu select the number of new students answers you want to view.
\item Click Save & Next.

\textbf{Note}: Clicking Next or Previous will not save any changes
you've made, but will display the next or previous students answer.

  \textbf{For Current Resource: For all Students in selected section or course continue here}.

\item At the manual Grading screen, choose to assign a common grade to the class or 
Assign grade to specific students in the class. 
\item If your assigning a common grade to the class, select the point value you wish 
to assign in the box under the Assign Common Grade to Class heading or If assigning to 
each student input the point value you want to assign to each student.
\item Click \textbf{Submit Changes}.
The Current Grade Status Screen will display.

  \textbf{For The Complete Set/Page/Sequence: For one student continue here}.

\item At the Manual grading by page or sequence screen, using the pull down menu select 
the folder with problems you wish to grade. (By default the folder listed is the 
folder the current problem resides in.)
\item Select \textbf{Yes} or \textbf{No} to view problem text. 
\item Select Submission detail level you wish to view.
\item Select the student.
\item Click \textbf{Submit}.
The screen will display the problems and answers.
\item Scroll down and View/grade/regrade the problems.
\item Click \textbf{Save}.

The screen will display the scores for the problems in the folder.

\end{emumerate}


Index: loncom/html/adm/help/tex/Docs_Adding_Syllabux.tex
+++ loncom/html/adm/help/tex/Docs_Adding_Syllabux.tex
\label{Docs_Adding_Syllabus}

The Syllabus template adds a traditional syllabus page, which can be filled out
with various standard information. To create a syllabus using the syllabus 
template do the following:

\begin{enumerate}

\item Click \textbf{DOCS} on the remote control.
\item At the \textbf{Course Document} screen, click \textbf{Syllabus} listed in the \textbf{Special documents}
column.
3. Click \textbf{re-initialize course} to make changes active for the current session. 

Note: The file will appear in the main course document list, where the user
can move, rename, or remove it. If the user does not click re-initialize
course the changes will become active the next time the user logs in.

4. Click \textbf{Syllabus} link listed in main course documents.
5. At the syllabus screen fill out the various syllabus
information. For more information about using LON-CAPA's templated
text entry system, please see \ref{Docs_Editing_Templated_Pages}.
6. Click \textbf{Store}.

\end{enumerate}

Note: To see the student view, click show student view link.

If your syllabus is already anywhere on the web (in or outside of
LON-CAPA), you can specify the URL for inclusion in the bottom field
of the syllabus template.

--bowersj21061839323--