[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Publishing_A_Resource.tex Publishing_Copyright.tex Publishing_Keywords.tex /publisher lonpublisher.pm doc/help author.manual.texxml

bowersj2 lon-capa-cvs@mail.lon-capa.org
Wed, 17 Jul 2002 18:23:45 -0000


This is a MIME encoded message

--bowersj21026930225
Content-Type: text/plain

bowersj2		Wed Jul 17 14:23:45 2002 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Publishing_Copyright.tex 
                             	Publishing_Keywords.tex 

  Modified files:              
    /doc/help	author.manual.texxml 
    /loncom/html/adm/help/tex	Publishing_A_Resource.tex 
    /loncom/publisher	lonpublisher.pm 
  Log:
  Added help to the Publishing page as a trial run for the help system.
  Required splitting the .tex pages a bit more.
  
  
  
--bowersj21026930225
Content-Type: text/plain
Content-Disposition: attachment; filename="bowersj2-20020717142345.txt"

Index: doc/help/author.manual.texxml
diff -u doc/help/author.manual.texxml:1.1 doc/help/author.manual.texxml:1.2
--- doc/help/author.manual.texxml:1.1	Fri Jul  5 12:12:30 2002
+++ doc/help/author.manual.texxml	Wed Jul 17 14:23:45 2002
@@ -3,203 +3,152 @@
 	<file name="Author_Manual_Title_Page.tex"/>
 	
 	<section name="Introduction to LON-CAPA">
-Author_LON-CAPA_Introduction
 		<file name="Author_LON-CAPA_Introduction.tex"/>
 		<subsection name="About This Manual">
-About_Authors_Manual
 			<file name="About_Authors_Manual.tex"/>
 			</subsection>
 		<subsection name="Login as Course Author">
-Login_To_LON-CAPA
 			<file name="Login_To_LON-CAPA.tex"/>
 			</subsection>
 		<subsection name="Author Remote Control">
-Author_Remote_Control
 			<file name="Author_Remote_Control.tex"/>
 			</subsection>
 		</section>
 
 	<section name="Creating Content Using LON-CAPA">
-Resource_Types
 		 <file name="Resource_Types.tex"/>
 		 <subsection name="Description of the Construction Space">
-Construction_Space_Overview
 			<file name="Construction_Space_Overview.tex"/>
 			</subsection>
 		<subsection name="How to Create New Content Pages">
-Creating_New_Content_Pages
 			<file name="Creating_New_Content_Pages.tex"/>
 			</subsection>
 		<subsection name="How to Edit Existing Content Pages">
-How_To_Edit_Existing_Content_Pages
 		        <file name="How_To_Edit_Existing_Content_Pages.tex"/>
 			</subsection>
 		<subsection name="Creating Online Problems Using LON-CAPA">
-Creating_Online_Problems
 			<file name="Creating_Online_Problems.tex"/>
 			</subsection>
 		<subsection name="Problem Types">
-Problem_Types
 			<file name="Problem_Types.tex"/>
-Problem_Editor_Testing_Area
 			<file name="Problem_Editor_Testing_Area.tex"/>
 			</subsection>
 		<subsection name="Foils">
-Foils
 			<file name="Foils.tex"/>
 			</subsection>
 		<subsubsection name="Radio Response Problems">
-Radio_Response_Problems
 			<file name="Radio_Response_Problems.tex"/>
 			</subsubsection>
 		<subsubsection name="Option Response Problems">
-Option_Response_Problems
 			<file name="Option_Response_Problems.tex"/>
 			</subsubsection>
 		<subsubsection name="String Response Problems">
-String_Response_Problems
 			<file name="String_Response_Problems.tex"/>
 			</subsubsection>
 		<subsubsection name="Numerical Response Problems">
-Numerical_Response_Problems
 			<file name="Numerical_Response_Problems.tex"/>
 			</subsubsection>
 		<subsubsection name="Formula Response Problems">
-Formula_Response_Problems
 			<file name="Formula_Response_Problems.tex"/>
 			</subsubsection>
 		<subsection name="Creating Radio Response Problems">
-Creating_Radio_Response_Problems
 			<file name="Creating_Radio_Response_Problems.tex"/>
 			<subsubsection name="Randomization">
-Radio_Response_Randomization
 				<file name="Radio_Response_Randomization.tex"/>
 				</subsubsection>
 			</subsection>		
 		<subsection name="Option Response Problems">
 			<tex content="\index{Option Response}\label{Create Option Response Problem}"/>
 			<subsubsection name="Option Response Problems with Concept Groups">
-Option_Response_Problem_Figure
 				<file name="Option_Response_Problem_Figure.tex"/>
-Option_Response_Problem_Parts
 				<file name="Option_Response_Problem_Parts.tex"/>
 				</subsubsection>
 			<subsubsection name="Example: Concept Group">
-Option_Response_Concept_Group_Example
 				<file name="Option_Response_Concept_Group_Example.tex"/>
 				</subsubsection>
 			<subsubsection name="Example: Matching Problem">
-Option_Response_Matching_Example
 				<file name="Option_Response_Matching_Example.tex"/>
 				</subsubsection>
 			<subsubsection name="Creating Option Problems">
-Option_Response_Problem_Creation
 				<file name="Option_Response_Problem_Creation.tex"/>
 				</subsubsection>
 			<subsubsection name="Simple Option Response: No Concept Groups">
-Option_Response_Simple
 				<file name="Option_Response_Simple.tex"/>
 				</subsubsection>
 			</subsection>
 		<subsection name="Creating a String Response Problem">
-String_Response_Problem_Creation
 			<file name="String_Response_Problem_Creation.tex"/>
 			</subsection>
 		<subsection name="Creating Numerical Response and Formula Response Problems">
-About_Numerical_and_Formula_Response
 			<file name="About_Numerical_and_Formula_Response.tex"/>
-Author_Numerical_and_Formula
 			<file name="Author_Numerical_and_Formula.tex"/>
 			</subsection>
 		</section>
 
 	<section name="Publishing Your Resources">
-Publishing_Intro
 		<file name="Publishing_Intro.tex"/>
 		<subsection name="What is Metadata?">
-Metadata_Description
 			<file name="Metadata_Description.tex"/>
 			</subsection>
 		<subsection name="Publishing A Resource">
-Publishing_A_Resource
 			<file name="Publishing_A_Resource.tex"/>
-Publishing_Author_Tutorial_Segue
+			<file name="Publishing_Keywords.tex"/>
+			<file name="Publishing_Copyright.tex"/>
+			<tex content="Now when you click \textbf{Finalize Publication}, your resource will be published and usable (unless you set the distribution to {}``private'')." />
 			<file name="Publishing_Author_Tutorial_Segue.tex"/>
 			</subsection>
 		</section>
 
 	<section name="Creating A Course: Maps and Sequences">
-Creating_A_Course_Intro
 		<file name="Creating_A_Course_Intro.tex"/>
 		<subsection name="Creating Sequences">
-Sequence_Definition
 			<file name="Sequence_Definition.tex"/>
-Sequence_Editor_Selection
 			<file name="Sequence_Editor_Selection.tex"/>
 			</subsection>
 		<subsection name="Creating a Simple .sequence With The Simple Editor">
-Sequence_Simple_Editor_Creation
 			<file name="Sequence_Simple_Editor_Creation.tex"/>
 			</subsection>
 		<subsection name="Creating a Simple .sequence With The Advanced Editor">
-Sequence_Advanced_Editor_Creation
 			<file name="Sequence_Advanced_Editor_Creation.tex"/>
 			</subsection>
 		<subsection name="Page Maps">
-Sequence_Page_Maps
 			<file name="Sequence_Page_Maps.tex"/>
 			</subsection>
 		<subsection name="Creating a Course: Top-level Sequence">
-Sequence_Top-Level
 			<file name="Sequence_Top-Level.tex"/>
 			</subsection>
 		</section>
 
 	<section name="Numerical Response And Formula Response Questions">
-Numerical_Response_Introduction
 		<file name="Numerical_Response_Introduction.tex"/>
 		<subsection name="The Parts of a Numerical Response Problem">
-Numerical_Response_Parts_A
 			<file name="Numerical_Response_Parts_A.tex"/>
 			<tex content="\item "/>
-Tolerance
 			<file name="Tolerance.tex"/>
 			<tex content="\item "/>
-Significant_Figures
 			<file name="Significant_Figures.tex"/>
-Numerical_Response_Parts_B
 			<file name="Numerical_Response_Parts_B.tex"/>
 			</subsection>
 		<subsection name="Simple Numerical Response Answer">
-Numerical_Response_Intro
 			<file name="Numerical_Response_Intro.tex"/>
 			</subsection>
 		<subsection name="Simple Script Usage">
-Script_Tutorial_Intro
 			<file name="Script_Tutorial_Intro.tex"/>
-Numerical_Response_Simple_Example
 			<file name="Numerical_Response_Simple_Example.tex"/>
-Variable_Naming_Conventions
 			<file name="Variable_Naming_Conventions.tex"/>
-Numerical_Response_Tutorial_A
 			<file name="Numerical_Response_Tutorial_A.tex"/>
 			<subsubsection name="Variables in Scripts">
-Variables_in_Scripts
 				<file name="Variables_in_Scripts.tex"/>
-Variable_Tutorial_A
 				<file name="Variable_Tutorial_A.tex"/>
 				</subsubsection>
 			<subsubsection name="Variables in the Text Block">
-Variables_in_the_Text_Block
 				<file name="Variables_in_the_Text_Block.tex"/>
 				</subsubsection>
 			<subsubsection name="Variables in the Answer Block">
-Variables_in_the_Answer_Block
 				<file name="Variables_in_the_Answer_Block.tex"/>
 				</subsubsection>
 			</subsection>
 		<subsection name="Calling Functions">
-Calling_Functions
 			<file name="Calling_Functions.tex"/>
 			<subsubsection name="Numerical Response Randomization">
 				<tex content="If you're doing this as a tutorial, try a few random seeds to see what happens."/>
@@ -207,38 +156,29 @@
 			</subsection>
 		<subsection name="Dynamic, Randomized Problems: Putting It All Together">
 			<tex content="Now you have all the tools to create those wonderful dynamic, randomized problems that you've seen in LON-CAPA."/>
-Numerical_Response_Advanced_Example
 			<file name="Numerical_Response_Advanced_Example.tex"/>
 			</subsection>
 		<subsection name="Units, Format">
-Numerical_Response_Units
 			<file name="Numerical_Response_Units.tex"/>
-Numerical_Response_Format
 			<file name="Numerical_Response_Format.tex"/>
 			</subsection>
 		<subsection name="For More Information">
-Scripting_Help
 			<file name="Scripting_Help.tex"/>
 			</subsection>
 		<subsection name="Formula Response">
-Formula_Response_Problems
 			<file name="Formula_Response_Problems.tex"/>
 			<subsubsection name="Sample Specifications">
-Formula_Response_Sampling
 				<file name="Formula_Response_Sampling.tex"/>
 				</subsubsection>
 			<subsubsection name="Formula Notes">
 				<tex content="\begin {itemize}"/>
 				<tex content="\item"/>
-Formula_Response_Limitations
 				<file name="Formula_Response_Limitations.tex"/>
 				<tex content="\item"/>
-Formula_Tolerance
 				<file name="Formula_Tolerance.tex"/>
 				<tex content="\end{itemize}"/>
 				</subsubsection>
 			<subsubsection name="Exaple Formula Response">
-Formula_Response_Example
 				<file name="Formula_Response_Example.tex"/>
 				</subsubsection>
 			</subsection>
Index: loncom/html/adm/help/tex/Publishing_A_Resource.tex
diff -u loncom/html/adm/help/tex/Publishing_A_Resource.tex:1.1 loncom/html/adm/help/tex/Publishing_A_Resource.tex:1.2
--- loncom/html/adm/help/tex/Publishing_A_Resource.tex:1.1	Fri Jul  5 12:12:31 2002
+++ loncom/html/adm/help/tex/Publishing_A_Resource.tex	Wed Jul 17 14:23:45 2002
@@ -30,30 +30,4 @@
 is the LON-CAPA user who owns the problem.
 
 The \textbf{Keywords} and the \textbf{Abstract} are more information about
-the problem. The \textbf{Keywords} are words that are strongly connected
-to your problem; for instance a physics problem about a pulley might include
-{}``pulley'' as a key word. LON-CAPA pulls out words used in the text of
-the resource for you so you can just click on their check boxes to make them
-keywords. \textbf{Additional keywords} allows you to add any keyword to your
-problem that are not actually in the problem. For instance, on that same
-problem a physicist might add the keyword {}``statics'', even though it
-doesn't appear in the original problem, because Physics uses that as a classification
-of problem type. \textbf{Additional Keywords} are also useful when publishing
-graphics.
-
-Finally, you need to set the copyright and distribution permissions in the
-\textbf{COPYRIGHT/DISTRIBUTION} drop-down. This setting controls who is allowed
-to use your resource as follows:
-
-\begin{itemize}
-\item \textbf{Limited to courses in the domain published} means that only courses
-running in the same domain as you can use your content. Talk to your LON-CAPA
-administrator if you want more information about your domain.
-\item \textbf{Free} means that anyone can find and use the resource.
-\item \textbf{Private - visible to author only} means that it can't be used for
-any course.
-\item \textbf{Public - no authentication required} means anyone can find and use
-the resource.
-\end{itemize}
-Now when you click \textbf{Finalize Publication}, your resource will be published
-and usable (unless you set the distribution to {}``private'').
+the problem. 
Index: loncom/publisher/lonpublisher.pm
diff -u loncom/publisher/lonpublisher.pm:1.83 loncom/publisher/lonpublisher.pm:1.84
--- loncom/publisher/lonpublisher.pm:1.83	Mon Jun 24 10:25:38 2002
+++ loncom/publisher/lonpublisher.pm	Wed Jul 17 14:23:45 2002
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # Publication Handler
 #
-# $Id: lonpublisher.pm,v 1.83 2002/06/24 14:25:38 www Exp $
+# $Id: lonpublisher.pm,v 1.84 2002/07/17 18:23:45 bowersj2 Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -478,7 +478,10 @@
      
      my %oldparmstores=();
      
-     $scrout.='<h3>Metadata Information</h3>';
+     
+     $scrout.='<h3>Metadata Information ' .
+       Apache::loncommon::help_open_topic("Metadata_Description")
+       . '</h3>';
 
 # ------------------------------------------------ First, check out environment
      unless (-e $source.'.meta') {
@@ -585,6 +588,7 @@
 
 # --------------------------------------------------- Scan content for keywords
 
+        my $keywords_help = Apache::loncommon::help_open_topic("Publishing_Keywords");
 	my $keywordout=<<"END";
 <script>
 function checkAll(field)
@@ -599,7 +603,7 @@
         field[i].checked = false ;
 }
 </script>
-<p><b>Keywords:</b> 
+<p><b>Keywords: $keywords_help</b> 
 <input type="button" value="check all" onclick="javascript:checkAll(document.pubform.keywords)"> 
 <input type="button" value="uncheck all" onclick="javascript:uncheckAll(document.pubform.keywords)"> 
 <br />
@@ -679,6 +683,7 @@
 	$scrout.=&textfield('Publisher/Owner','owner',
                             $metadatafields{'owner'});
 # --------------------------------------------------- Correct copyright for rat        
+
     if ($style eq 'rat') {
 	if ($metadatafields{'copyright'} eq 'public') { 
 	    delete $metadatafields{'copyright'};
@@ -694,6 +699,9 @@
 			    \&Apache::loncommon::copyrightdescription,
 			     (&Apache::loncommon::copyrightids));
     }
+
+    my $copyright_help = Apache::loncommon::help_open_topic("Publishing_Copyright");
+    $scrout =~ s/DISTRIBUTION:/'DISTRIBUTION: ' . $copyright_help/ge;
     return $scrout.
       '<p><input type="submit" value="Finalize Publication" /></p></form>';
 }

Index: loncom/html/adm/help/tex/Publishing_Copyright.tex
+++ loncom/html/adm/help/tex/Publishing_Copyright.tex
You need to set the copyright and distribution permissions in the
\textbf{COPYRIGHT/DISTRIBUTION} drop-down. This setting controls who is allowed
to use your resource as follows:

\begin{itemize}
\item \textbf{Limited to courses in the domain published} means that only courses
running in the same domain as you can use your content. Talk to your LON-CAPA
administrator if you want more information about your domain.
\item \textbf{Free} means that anyone can find and use the resource.
\item \textbf{Private - visible to author only} means that it can't be used for
any course.
\item \textbf{Public - no authentication required} means anyone can find and use
the resource.
\end{itemize}
Not all of these choices may be visible, depending on the nature of
the resource.
Index: loncom/html/adm/help/tex/Publishing_Keywords.tex
+++ loncom/html/adm/help/tex/Publishing_Keywords.tex
The \textbf{Keywords} are words that are strongly connected
to your problem; for instance a physics problem about a pulley might include
{}``pulley'' as a key word. LON-CAPA pulls out words used in the text of
the resource for you so you can just click on their check boxes to make them
keywords. \textbf{Additional keywords} allows you to add any keyword to your
problem that are not actually in the problem. For instance, on that same
problem a physicist might add the keyword {}``statics'', even though it
doesn't appear in the original problem, because Physics uses that as a classification
of problem type. \textbf{Additional Keywords} are also useful when publishing
graphics.
--bowersj21026930225--