--- doc/help/author.manual.texxml 2011/12/02 16:20:09 1.15 +++ doc/help/author.manual.texxml 2013/09/22 15:54:43 1.31 @@ -2,46 +2,77 @@ <file name="Author_Manual_Title_Page.tex"/> - <section name="Introduction to LON-CAPA"> + <section name="Introduction to Authoring in LON-CAPA"> <file name="Author_LON-CAPA_Introduction.tex"/> <subsection name="About This Manual"> <file name="About_Authors_Manual.tex"/> </subsection> - <subsection name="Login as Course Author"> + <subsection name="Login as Content Author"> <file name="Login_To_LON-CAPA.tex"/> </subsection> - <subsection name="Author Remote Control"> - <file name="Author_Remote_Control.tex"/> + <subsection name="Roles Screen"> + <file name="Roles_Screen.tex" /> </subsection> - </section> - - - <section name="Creating Content Using LON-CAPA"> - <file name="Resource_Types.tex"/> - <subsection name="Description of the Construction Space"> + <subsection name="Menu Options"> + <subsubsection name="Inline Menu"> + <file name="Author_Menu.tex"/> + </subsubsection> + <subsubsection name="Remote Control"> + <file name="Author_Remote_Control.tex"/> + </subsubsection> + </subsection> + <subsection name="Resource Types"> + <file name="Resource_Types.tex"/> + </subsection> + <subsection name="Description of Authoring Space"> <file name="Construction_Space_Overview.tex"/> </subsection> - <subsection name="How to Create New Content Pages"> - <file name="Creating_New_Content_Pages.tex"/> + <subsection name="Searching Existing Resources" > + <file name="Search_Basic.tex" /> + <file name="Search_Advanced.tex" /> </subsection> - <subsection name="How to Edit Existing Content Pages"> - <file name="How_To_Edit_Existing_Content_Pages.tex"/> + <subsection name="Browsing Existing Resources" > + <file name="Browsing_Resources.tex" /> + </subsection> + + <section name="Help"> + <subsection name="Online Help"> + <file name="Help.tex" /> + </subsection> + <subsection name="Where to find additional help"> + <file name="Additional_Help.tex" /> </subsection> - <subsection name="Creating Online Problems Using LON-CAPA"> - <file name="Creating_Online_Problems.tex"/> + <subsection name="Requesting New Features and Submitting Suggestions"> + <file name="Bugzilla.tex" /> </subsection> + </section> + <section name="HTML Page Overview"> + <file name="Content_Page_Overview.tex"/> + </section> + <section name="Problem Types in LON-CAPA"> <subsection name="Problem Types"> <file name="Problem_Types.tex"/> - <file name="Problem_Editor_Testing_Area.tex"/> - </subsection> - <subsection name="Foils"> - <file name="Foils.tex"/> </subsection> + <subsubsection name="Foils"> + <file name="Foils.tex"/> + </subsubsection> <subsection name="Radio Response Problems"> <file name="Radio_Response_Problems.tex"/> </subsection> <subsection name="Option Response Problems"> + <tex content="\index{Option Response}\label{Create Option Response Problem}"/> <file name="Option_Response_Problems.tex"/> + <subsubsection name="Option Response Problems with Concept Groups"> + <file name="Option_Response_Problem_Figure.tex"/> + <file name="Option_Response_Problem_Parts.tex"/> + </subsubsection> + <subsubsection name="Example: Concept Group"> + <file name="Option_Response_Concept_Group_Example.tex"/> + </subsubsection> + <subsubsection name="Example: Matching Problem"> + <file name="Option_Response_Matching_Example.tex"/> + </subsubsection> + </subsection> </subsection> <subsection name="String Response Problems"> <file name="String_Response_Problems.tex"/> @@ -52,100 +83,231 @@ <subsection name="Formula Response Problems"> <file name="Formula_Response_Problems.tex"/> </subsection> - <subsection name="Math Response Problems"> - <file name="Math_Response_Problems.tex"/> - </subsection> - <subsection name="Creating Radio Response Problems"> - <file name="Creating_Radio_Response_Problems.tex"/> - <subsubsection name="Randomization"> - <file name="Radio_Response_Randomization.tex"/> - </subsubsection> + <subsection name="Math Response Problems"> + <file name="Math_Response_Problems.tex"/> + </subsection> + <subsection name="Custom Response Problems"> + <file name="Custom_Response_Problems.tex"/> + </subsection> + <subsection name="Function Plot Response Problems"> + <file name="Function_Plot_Response_Overview.tex" /> + </subsection> + </section> + + <section name="Authoring Content in LON-CAPA"> + <file name="Creating_Content_Overview.tex"/> + <subsection name="Authoring and Editing Content Pages"> + <file name="Creating_New_Content_Pages.tex"/> + </subsection> + <subsubsection name="How to Edit Existing Content Pages"> + <file name="How_To_Edit_Existing_Content_Pages.tex"/> + </subsubsection> + <subsection name="Authoring Problems Using LON-CAPA"> + <file name="Creating_Online_Problems.tex"/> + <file name="Problem_Editor_Testing_Area.tex"/> + </subsection> + <subsection name="General Problem Editing"> + <tex content="The following capabilities are available in all problem types:" /> + <subsubsection name="Authoring Surveys"> + <file name="Authoring_Surveys.tex" /> + </subsubsection> + <subsubsection name="Adding Picture"> + <file name="Authoring_Adding_Pictures.tex" /> + <file name="Authoring_Pictures_EPS.tex" /> + </subsubsection> + <subsubsection name="Dynamic Plots"> + <file name="Dynamic_Plot_Overview.tex"/> + </subsubsection> + <subsubsection name="Importing Testbanks"> + <file name="Testbank_Formatting.tex" /> + </subsubsection> + <subsubsection name="Answer Display Overview"> + <file name="Answer_Display_Overview.tex"/> + </subsubsection> + </subsection> + </section> + <section name="Authoring Radio, Option, String Response Problems"/> + <subsection name="Authoring Radio Response Problems"> + <file name="Creating_Radio_Response_Problems.tex"/> + <subsubsection name="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"> - <file name="Option_Response_Problem_Figure.tex"/> - <file name="Option_Response_Problem_Parts.tex"/> - </subsubsection> - <subsubsection name="Example: Concept Group"> - <file name="Option_Response_Concept_Group_Example.tex"/> + <subsection name="Authoring Option Problems"> + <file name="Option_Response_Problem_Creation.tex"/> + </subsection> + <subsection name="Simple Option Response: No Concept Groups"> + <file name="Option_Response_Simple.tex"/> + </subsection> + <subsection name="Authoring a String Response Problem"> + <file name="String_Response_Problem_Creation.tex"/> + </subsection> + + </section> + + <section name="Authoring Numerical, Formula, Custom Response Questions"> + <subsection name="Authoring Numerical Response and Formula Response Problems"> + <file name="About_Numerical_and_Formula_Response.tex"/> +<!-- <file name="Author_Numerical_and_Formula.tex"/> --> + </subsection> + <file name="Numerical_Response_Introduction.tex"/> + <subsection name="The Parts of a Numerical Response Problem"> + <file name="Numerical_Response_Parts_A.tex"/> + <tex content="\item "/> + <file name="Tolerance.tex"/> + <tex content="\item "/> + <file name="Significant_Figures.tex"/> + <file name="Numerical_Response_Parts_B.tex"/> + </subsection> + <subsection name="Simple Numerical Response Answer"> + <file name="Numerical_Response_Intro.tex"/> + </subsection> + <subsection name="Simple Script Usage"> + <file name="Script_Tutorial_Intro.tex"/> + <file name="Numerical_Response_Simple_Example.tex"/> + <file name="Variable_Naming_Conventions.tex"/> + <file name="Numerical_Response_Tutorial_A.tex"/> + <subsubsection name="Variables in Scripts"> + <file name="Variables_in_Scripts.tex"/> + <file name="Variable_Tutorial_A.tex"/> </subsubsection> - <subsubsection name="Example: Matching Problem"> - <file name="Option_Response_Matching_Example.tex"/> + <subsubsection name="Variables in the Text Block"> + <file name="Variables_in_the_Text_Block.tex"/> </subsubsection> - <subsubsection name="Creating Option Problems"> - <file name="Option_Response_Problem_Creation.tex"/> + <subsubsection name="Variables in the Answer Block"> + <file name="Variables_in_the_Answer_Block.tex"/> </subsubsection> - <subsubsection name="Simple Option Response: No Concept Groups"> - <file name="Option_Response_Simple.tex"/> + </subsection> + <subsection name="Calling Functions"> + <file name="Calling_Functions.tex"/> + <subsubsection name="Numerical Response Randomization"> + <tex content="If you're following this material and creating an example, click the button for a new random seed to generate other problem presentations."/> </subsubsection> </subsection> - <subsection name="Custom Response Problems"> - <file name="Custom_Response_Problems.tex"/> - </subsection> - <subsection name="Function Plot Response Problems"> - <subssubsection name="Introduction"> - <file name="Function_Plot_Response_Question.tex" /> - </subsubsection> - <subsubsection name="Elements"> - <file name="Function_Plot_Response_Elements.tex" /> - <tex content="\subsubsection*{Splines}"> - <file name="Function_Plot_Response_Spline.tex" /> - <tex content="\subsubsection*{Vectors}"> - <file name="Function_Plot_Response_Vector.tex" /> - <tex content="\subsubsection*{Objects}"> - <file name="Function_Plot_Response_Object.tex" /> - <tex content="\subsubsection*{Background Plots}"> - <file name="Function_Plot_Response_Background_Plot.tex" /> - </subsubsection> - <subsubsection name="Rules"> - <file name="Function_Plot_Response_Rule_Set.tex" /> - <tex content="\subsubsection*{Graph Rule}"> - <file name="Function_Plot_Response_Evaluation_Rule.tex" /> - <tex content="\subsubsection*{Vector Rule}"> - <file name="Function_Plot_Response_Vector_Rule.tex" /> - <tex content="\subsubsection*{Vector Sum Rule}"> - <file name="Function_Plot_Response_Vector_Sum_Rule.tex" /> - <tex content="\subsubsection*{Custom Rule}"> - <file name="Function_Plot_Response_Custom_Rule.tex" /> - </subsubsection> - </subsection> - <subsection name="Creating a String Response Problem"> - <file name="String_Response_Problem_Creation.tex"/> + <subsection name="Authoring Formula Response Problems"> + <file name="Creating_Formula_Response.tex"/> </subsection> - <subsection name="Creating Numerical Response and Formula Response Problems"> - <file name="About_Numerical_and_Formula_Response.tex"/> - <file name="Author_Numerical_and_Formula.tex"/> + <subsection name="Dynamic, Randomized Problems: Putting It All Together"> + <file name="Numerical_Response_Advanced_Example.tex"/> + </subsection> + <subsection name="Units, Format"> + <file name="Numerical_Response_Units.tex"/> + <file name="Numerical_Response_Format.tex"/> + </subsection> + <subsection name="For More Information"> + <file name="Scripting_Help.tex"/> </subsection> - <subsection name="Dynamically Generated Plots"> + <subsection name="Formula Response"> + <file name="Formula_Response_Adv_Intro.tex"/> + <subsubsection name="Sample Specifications"> + <file name="Formula_Response_Sampling.tex"/> + </subsubsection> + <subsubsection name="Formula Notes"> + <tex content="\begin {itemize}"/> + <tex content="\item"/> + <file name="Formula_Response_Limitations.tex"/> + <tex content="\item"/> + <file name="Formula_Tolerance.tex"/> + <tex content="\end{itemize}"/> + </subsubsection> + <subsubsection name="Example Formula Response"> + <file name="Formula_Response_Example.tex"/> + </subsubsection> + </subsection> + <subsection name="Authoring Math Response Problems"> + <file name="Creating_Math_Response_Problems.tex"/> + </subsection> + <subsection name="Custom Response Problems"> + <file name="Custom_Response_Problem_Creation.tex"/> + </subsection> + </section> + + <section name="Authoring Dynamically Generated Plots"> +<!-- Most of this following file has been subdivided and expanded in the other files --> <!-- <file name="Authoring_Dynamic_Plot.tex" /> --> - <file name="Authoring_Dynamic_Plot_Gnuplot.tex" /> - <file name="Authoring_Dynamic_Plot_Title_X_Y_Label.tex" /> - <file name="Authoring_Dynamic_Plot_Axes.tex" /> - <file name="Authoring_Dynamic_Plot_Tics.tex" /> - <file name="Authoring_Dynamic_Plot_Key.tex" /> - <file name="Authoring_Dynamic_Plot_Label.tex" /> + <file name="Authoring_Dynamic_Plot_Gnuplot.tex" /> <subsection name="Specifying Curves to Plot" > <file name="Authoring_Dynamic_Plot_Curve.tex" /> - <file name="Authoring_Dynamic_Plot_Curve_Data.tex" /> - <file name="Authoring_Dynamic_Plot_Curve_Function.tex" /> - <file name="Authoring_Dynamic_Plot_Linestyle.tex" /> + <subsubsection name="Plotting Data Points"> + <file name="Authoring_Dynamic_Plot_Curve_Data.tex" /> + </subsubsection> + <subsubsection name="Plotting Functions"> + <file name="Authoring_Dynamic_Plot_Curve_Function.tex" /> + </subsubsection> + <subsubsection name="Data and Line Styles"> + <file name="Authoring_Dynamic_Plot_Linestyle.tex" /> + </subsubsection> </subsection> + <subsection name="Plot Labels and Key"> + <file name="Authoring_Dynamic_Plot_Title_X_Y_Label.tex" /> + <file name="Authoring_Dynamic_Plot_Key.tex" /> + <file name="Authoring_Dynamic_Plot_Label.tex" /> + </subsection> + <subsection name="Plot Axes Details"> + <file name="Authoring_Dynamic_Plot_Axes.tex" /> + <file name="Authoring_Dynamic_Plot_Tics.tex" /> + </subsection> <subsection name="Color Selection" > <file name="Authoring_Dynamic_Plot_Color_Selection.tex" /> </subsection> + </section> + + + <section name="Authoring Function Plot Response Problems"> + <subsection name="Introduction"> + <file name="Function_Plot_Response_Question.tex" /> + </subsection> + <subsection name="Elements"> + <file name="Function_Plot_Response_Elements.tex" /> + <tex content="\subsubsection*{Splines}" /> + <file name="Function_Plot_Response_Spline.tex" /> + <tex content="\subsubsection*{Vectors}" /> + <file name="Function_Plot_Response_Vector.tex" /> + <tex content="\subsubsection*{Objects}" /> + <file name="Function_Plot_Response_Object.tex" /> + <tex content="\subsubsection*{Background Plots}" /> + <file name="Function_Plot_Response_Background_Plot.tex" /> </subsection> - <subsection name="General Problem Editing"> - <tex content="The following capabilities are available in all problem types:" /> - <subsubsection name="Adding Picture"> - <file name="Authoring_Adding_Pictures.tex" /> - <file name="Authoring_Pictures_EPS.tex" /> - </subsubsection> + <subsection name="Rules"> + <file name="Function_Plot_Response_Rule_Set.tex" /> + <tex content="\subsubsection*{Graph Rule}" /> + <file name="Function_Plot_Response_Evaluation_Rule.tex" /> + <tex content="\subsubsection*{Vector Rule}" /> + <file name="Function_Plot_Response_Vector_Rule.tex" /> + <tex content="\subsubsection*{Vector Sum Rule}" /> + <file name="Function_Plot_Response_Vector_Sum_Rule.tex" /> + <tex content="\subsubsection*{Custom Rule}" /> + <file name="Function_Plot_Response_Custom_Rule.tex" /> + </subsection> + + </section> + <section name="Using Libraries"> + <tex content="Library (.library) files can hold an assortment of content. Library content is loaded into a problem statement by using an $<$import$>$ tag.\index{import} For more information about the import tag, see section \ref{Authoring_Scripting_Tags}."/> + <subsection name="Authoring Library Files"> + <file name="Authoring_Library_Scripts.tex"/> + </subsection> + </section> + + <section name="Authoring Adaptive/Conditional Hints"> + <file name="adaptive_hints.tex"/> + </section> + + <section name="Publishing Your Resources"> + <file name="Publishing_Intro.tex"/> + <subsection name="What is Metadata?"> + <file name="Metadata_Description.tex"/> + </subsection> + <subsection name="Publishing A Resource"> + <file name="Publishing_A_Resource.tex"/> + <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="Printing Your Resources"> - <subsection name="Printing from Construction Space"> + <subsection name="Printing from Authoring Space"> <file name="Print_Resource.tex" /> </subsection> <subsection name="Printing a Subdirectory of Problems"> @@ -186,105 +348,26 @@ </subsection> </section> - <section name="Publishing Your Resources"> - <file name="Publishing_Intro.tex"/> - <subsection name="What is Metadata?"> - <file name="Metadata_Description.tex"/> - </subsection> - <subsection name="Publishing A Resource"> - <file name="Publishing_A_Resource.tex"/> - <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"> + <section name="Authoring Maps: Sequences and Pages"> <file name="Creating_A_Course_Intro.tex"/> - <subsection name="Creating Sequences"> + <subsection name="Authoring Sequences"> <file name="Sequence_Definition.tex"/> <file name="Sequence_Editor_Selection.tex"/> </subsection> - <subsection name="Creating a Simple .sequence With The Simple Editor"> + <subsection name="Authoring a Simple .sequence With The Simple Editor"> <file name="Sequence_Simple_Editor_Creation.tex"/> </subsection> - <subsection name="Creating a Simple .sequence With The Advanced Editor"> + <subsection name="Authoring a Simple .sequence With The Advanced Editor"> <file name="Sequence_Advanced_Editor_Creation.tex"/> </subsection> <subsection name="Page Maps"> <file name="Sequence_Page_Maps.tex"/> </subsection> - <subsection name="Creating a Course: Top-level Sequence"> + <subsection name="Courses: Top-level Sequence"> <file name="Sequence_Top-Level.tex"/> </subsection> </section> - <section name="Numerical Response And Formula Response Questions"> - <file name="Numerical_Response_Introduction.tex"/> - <subsection name="The Parts of a Numerical Response Problem"> - <file name="Numerical_Response_Parts_A.tex"/> - <tex content="\item "/> - <file name="Tolerance.tex"/> - <tex content="\item "/> - <file name="Significant_Figures.tex"/> - <file name="Numerical_Response_Parts_B.tex"/> - </subsection> - <subsection name="Simple Numerical Response Answer"> - <file name="Numerical_Response_Intro.tex"/> - </subsection> - <subsection name="Simple Script Usage"> - <file name="Script_Tutorial_Intro.tex"/> - <file name="Numerical_Response_Simple_Example.tex"/> - <file name="Variable_Naming_Conventions.tex"/> - <file name="Numerical_Response_Tutorial_A.tex"/> - <subsubsection name="Variables in Scripts"> - <file name="Variables_in_Scripts.tex"/> - <file name="Variable_Tutorial_A.tex"/> - </subsubsection> - <subsubsection name="Variables in the Text Block"> - <file name="Variables_in_the_Text_Block.tex"/> - </subsubsection> - <subsubsection name="Variables in the Answer Block"> - <file name="Variables_in_the_Answer_Block.tex"/> - </subsubsection> - </subsection> - <subsection name="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."/> - </subsubsection> - </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."/> - <file name="Numerical_Response_Advanced_Example.tex"/> - </subsection> - <subsection name="Units, Format"> - <file name="Numerical_Response_Units.tex"/> - <file name="Numerical_Response_Format.tex"/> - </subsection> - <subsection name="For More Information"> - <file name="Scripting_Help.tex"/> - </subsection> - <subsection name="Formula Response"> - <file name="Formula_Response_Adv_Intro.tex"/> - <subsubsection name="Sample Specifications"> - <file name="Formula_Response_Sampling.tex"/> - </subsubsection> - <subsubsection name="Formula Notes"> - <tex content="\begin {itemize}"/> - <tex content="\item"/> - <file name="Formula_Response_Limitations.tex"/> - <tex content="\item"/> - <file name="Formula_Tolerance.tex"/> - <tex content="\end{itemize}"/> - </subsubsection> - <subsubsection name="Example Formula Response"> - <file name="Formula_Response_Example.tex"/> - </subsubsection> - </subsection> - </section> - <section name="Tags Used in XML Authoring"> <file name="Authoring_XML_Intro.tex" /> <subsection name="Response Tags"> @@ -338,6 +421,7 @@ </section> <section name="<script> Tag"> +<!-- labels are not captured from this file. <tex content="\label{Script Tag}\index{script commands}"/> --> <subsection name="Supported script functions"> <file name="Script_Functions.tex" /> </subsection> @@ -351,7 +435,7 @@ <file name="CAPA_LON-CAPA_function_diffs.tex" /> </subsection> </section> - + <section name="Bridge Task"> <file name="BridgeTask_About.tex" /> <subsection name="Introduction to Bridge Task"> @@ -360,7 +444,7 @@ <subsection name="Bridge Task Features"> <file name="BridgeTask_Features.tex" /> </subsection> - <subsection name="Creating Bridge Task"> + <subsection name="Authoring Bridge Task"> <file name="BridgeTask_Create.tex" /> </subsection> <subsection name="Bridge Task XML Editing"> @@ -412,7 +496,7 @@ </section> - <section name="Appendix: Symbols in Tex"> + <section name="Appendix: Symbols in TeX"> <subsection name="Greek Symbols"> <file name="Greek_Symbols.tex" /> </subsection> @@ -420,5 +504,8 @@ <file name="Other_Symbols.tex" /> </subsection> </section> + <section name="Appendix: Physical Units"> + <file name="Physical_Units.tex" /> + </section> </texxml>