[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Authoring_Intro.tex Contextual_Help.tex Course_Coordination_Intro.tex Student_Intro.tex /interface lonhelp.pm lonmenu.pm doc/loncapafiles loncapafiles.lpml

www lon-capa-cvs@mail.lon-capa.org
Fri, 14 Jul 2006 16:46:38 -0000


www		Fri Jul 14 12:46:38 2006 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Authoring_Intro.tex Contextual_Help.tex 
                             	Course_Coordination_Intro.tex 
                             	Student_Intro.tex 

  Modified files:              
    /doc/loncapafiles	loncapafiles.lpml 
    /loncom/interface	lonhelp.pm lonmenu.pm 
  Log:
  Different access to help system per usability discussion
  
  
Index: doc/loncapafiles/loncapafiles.lpml
diff -u doc/loncapafiles/loncapafiles.lpml:1.492 doc/loncapafiles/loncapafiles.lpml:1.493
--- doc/loncapafiles/loncapafiles.lpml:1.492	Sun Jul  9 23:58:38 2006
+++ doc/loncapafiles/loncapafiles.lpml	Fri Jul 14 12:46:29 2006
@@ -2,7 +2,7 @@
  "http://lpml.sourceforge.net/DTD/lpml.dtd">
 <!-- loncapafiles.lpml -->
 
-<!-- $Id: loncapafiles.lpml,v 1.492 2006/07/10 03:58:38 raeburn Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.493 2006/07/14 16:46:29 www Exp $ -->
 
 <!--
 
@@ -2605,6 +2605,7 @@
 Authoring_ImageResponse.tex;
 Authoring_Input_Tags.tex;
 Authoring_Internal_Tags.tex;
+Authoring_Intro.tex;
 Authoring_M_Tag.tex;
 Authoring_NumericalResponse.tex;
 Authoring_OptionResponse.tex;
@@ -2646,6 +2647,7 @@
 Chatting.tex;
 Coauthor.tex;
 Construction_Space_Overview.tex;
+Contextual_Help.tex;
 Course_Add_Other.tex;
 Course_Add_Student.tex;
 Course_Automated_Enrollment.tex;
@@ -2654,6 +2656,7 @@
 Course_Chart_To_Excel.tex;
 Course_Chat.tex;
 Course_Convert_To_CSV.tex;
+Course_Coordination_Intro.tex;
 Course_Create_Class_List.tex;
 Course_Critical_Message.tex;
 Course_Deleting.tex;
@@ -2723,6 +2726,7 @@
 Docs_Verify_Content.tex;
 Due_Date.tex;
 Edit_Syllabus.tex;
+Error.tex;
 exam_basics.tex;
 Exploring_Your_Course.tex;
 Feedback_Author.tex;
@@ -2868,6 +2872,7 @@
 Statistics_Cache.tex;
 String_Response_Problem_Creation.tex;
 String_Response_Problems.tex;
+Student_Intro.tex;
 Submission_Time_Analysis.tex;
 Syllabus_ExtLink.tex;
 Syllabus_URLs.tex;
Index: loncom/interface/lonhelp.pm
diff -u loncom/interface/lonhelp.pm:1.29 loncom/interface/lonhelp.pm:1.30
--- loncom/interface/lonhelp.pm:1.29	Thu Jun 29 23:50:02 2006
+++ loncom/interface/lonhelp.pm	Fri Jul 14 12:46:36 2006
@@ -1,6 +1,6 @@
 # The LearningOnline Network with CAPA
 #
-# $Id: lonhelp.pm,v 1.29 2006/06/30 03:50:02 albertel Exp $
+# $Id: lonhelp.pm,v 1.30 2006/07/14 16:46:36 www Exp $
 #
 # .tex help system web server handler
 #
@@ -58,7 +58,7 @@
 # Serve out the text
 sub servetext {
     my ($r,$text) = @_;
-    my $bugs=&Apache::loncommon::help_open_bug('Documentation');
+    my $bugs=&Apache::loncommon::help_open_bug('Documentation','Report a documentation bug');
     my $start_page=
 	&Apache::loncommon::start_page('LON-CAPA Help',undef,
 				       {'only_body' => 1,});
@@ -68,7 +68,7 @@
     $r->print(<<HEADER);
     $start_page
     <h3 style="font: sans-serif"><img align="right" alt="help logo"
-    src="/adm/help/gif/lonhelpheader.gif"/>$header</h3><hr />$bugs
+    src="/adm/help/gif/lonhelpheader.gif"/>$header</h3><hr />
     <!-- BEGIN -->
 HEADER
 
@@ -85,6 +85,7 @@
 </form>
 <br />
 <a href="/adm/help/abouthelp.html">$about</a>
+$bugs
 FOOTER
  
     }
@@ -111,11 +112,19 @@
     # absolute paths for use with help.loncapa.org
     $tex =~ s|  \\ref\{([^}]*)\}
              |
-              if (not(exists($fragmentLabels{$1}))) {
-	          &Apache::lonnet::logthis("ERROR: $1 not a valid help label");
-              };
+              my $label=$1;
+              if ($1!~/\.hlp$/) {
+                  if ((!exists($fragmentLabels{$1})) && ($1!~/\.hlp$/)) {
+	             &Apache::lonnet::logthis("ERROR: $1 not a valid help label");
+                     $label='Error';
+                  } else {
+                     $label=substr($fragmentLabels{$1}, 0, -4);
+		  }
+	      } else {
+		  $label=~s/\.hlp$//;
+	      }
              '\\begin{html}<a href="http://' . $serverroot ."/adm/help/".
-              substr($fragmentLabels{$1}, 0, -4) .
+              $label .
               '.hlp#' . &processLabelName($1) . 
              '"><img src="http://' . $serverroot . '/adm/help/gif/smallHelp.gif" border="0" /></a>' .
              '\\end{html}'
Index: loncom/interface/lonmenu.pm
diff -u loncom/interface/lonmenu.pm:1.194 loncom/interface/lonmenu.pm:1.195
--- loncom/interface/lonmenu.pm:1.194	Mon Jul 10 18:34:36 2006
+++ loncom/interface/lonmenu.pm	Fri Jul 14 12:46:36 2006
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # Routines to control the menu
 #
-# $Id: lonmenu.pm,v 1.194 2006/07/10 22:34:36 banghart Exp $
+# $Id: lonmenu.pm,v 1.195 2006/07/14 16:46:36 www Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -237,6 +237,13 @@
 	if ($env{'user.adv'}) {
 	    $remote = '<td><a href="/adm/remote?action=launch&amp;url='.$escurl.'" target="_top">'.$lt{'launch'}.'</a></td>'
 	}
+        my $helptopic='Student_Intro';
+        if ($env{'request.role'}=~/^(ca|au)/) {
+	    $helptopic='Authoring_Intro';
+	} elsif ($env{'request.role'}=~/^cc/) {
+	    $helptopic='Course_Coordination_Intro';
+	}
+        my $helplink=&Apache::loncommon::help_open_topic($helptopic,'Help');
 	return (<<ENDINLINEMENU);
 <script type="text/javascript">
 // BEGIN LON-CAPA Internal
@@ -246,6 +253,8 @@
 </script>
 <table id="LC_top_nav">
 <tr>
+<td class="LC_top_nav_logo">
+<a href="/adm/about.html"><img src="$logo" alt="LON-CAPA Logo" align="left" border="0" /></a></td>
 <td><a href="/adm/menu" target="_top">$lt{'main'}</a></td>
 $reloadlink
 $navmaps
@@ -253,8 +262,8 @@
 $groups
 $remote
 <td><a href="/adm/roles" target="_top">$lt{'roles'}</a></td>
-<td><a href="/adm/logout" target="_top">$lt{'exit'}</a></td>
-<td class="LC_top_nav_logo">LON-CAPA<img src="$logo" alt="Logo" /></td>
+<td>$helplink</td>
+<td class="LC_top_logout"><a href="/adm/logout" target="_top">$lt{'exit'}</a></td>
 </tr>
 </table>
 $form

Index: loncom/html/adm/help/tex/Authoring_Intro.tex
+++ loncom/html/adm/help/tex/Authoring_Intro.tex
\label{Authoring_Intro}
\textbf{Welcome to the LON-CAPA Help System}

NOTE: 
throughout the application, blue question marks (\ref{Contextual_Help}) are available to provide contextual help about particular components.

\begin{itemize}
\item \ref{What_Is_LON-CAPA} What is LON-CAPA?
\item \ref{General_Intro} General Introduction
\item \ref{Garbage} Garbage
\item \ref{author.manual.access.hlp} Authoring Manual Online
\end{itemize}

Index: loncom/html/adm/help/tex/Contextual_Help.tex
+++ loncom/html/adm/help/tex/Contextual_Help.tex
\label{Contextual_Help}
LON-CAPA provides contextual help on several areas of its functionality. Simply click on the blue question mark items that appear next to buttons, menu items, or at the top of the screen to get help on what the screens or functional elements are about.

Click on the orange question marks to get additional help from the online ``Frequently Asked Questions'' or the help desk, or to report a software defect or enhancement suggestion in the Bugzilla Bug Tracking System.

Index: loncom/html/adm/help/tex/Course_Coordination_Intro.tex
+++ loncom/html/adm/help/tex/Course_Coordination_Intro.tex
\label{Course_Coordination_Intro}
\textbf{Welcome to the LON-CAPA Help System}

NOTE: 
throughout the application, blue question marks (\ref{Contextual_Help}) are available to provide contextual help about particular components.

\begin{itemize}
\item \ref{What_Is_LON-CAPA} What is LON-CAPA?
\item \ref{General_Intro} General Introduction
\item \ref{course.manual.access.hlp} Course Coordination Manual Online
\end{itemize}

Index: loncom/html/adm/help/tex/Student_Intro.tex
+++ loncom/html/adm/help/tex/Student_Intro.tex
\label{Student_Intro}
\textbf{Welcome to the LON-CAPA Help System}

NOTE: 
throughout the application, blue question marks (\ref{Contextual_Help}) are available to provide contextual help about particular components.

\begin{itemize}
\ref{General_Intro} General Introduction
\end{itemize}