--- doc/help/author.manual.texxml 2012/01/14 16:24:19 1.17 +++ doc/help/author.manual.texxml 2013/11/24 07:42:20 1.32 @@ -2,67 +2,66 @@ <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> - <subsection name="Creating Online Problems Using LON-CAPA"> - <file name="Creating_Online_Problems.tex"/> + + <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="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"> - <file name="Option_Response_Problems.tex"/> - </subsection> - <subsection name="String Response Problems"> - <file name="String_Response_Problems.tex"/> - </subsection> - <subsection name="Numerical Response Problems"> - <file name="Numerical_Response_Problems.tex"/> - </subsection> - <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> - <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"/> @@ -73,157 +72,84 @@ <subsubsection name="Example: Matching Problem"> <file name="Option_Response_Matching_Example.tex"/> </subsubsection> - <subsubsection name="Creating Option Problems"> - <file name="Option_Response_Problem_Creation.tex"/> - </subsubsection> - <subsubsection name="Simple Option Response: No Concept Groups"> - <file name="Option_Response_Simple.tex"/> - </subsubsection> </subsection> - <subsection name="Custom Response Problems"> - <file name="Custom_Response_Problems.tex"/> - </subsection> - <subsection name="Function Plot Response Problems"> - <subsubsection 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> - <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="String Response Problems"> + <file name="String_Response_Problems.tex"/> </subsection> - <subsection name="Dynamically Generated Plots"> -<!-- <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" /> - <subsubsection 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> - <subsubsection name="Color Selection" > - <file name="Authoring_Dynamic_Plot_Color_Selection.tex" /> - </subsubsection> - </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> - <subsubsection name="Importing Testbanks"> - <file name="Testbank_Formatting.tex" /> - </subsubsection> + <subsection name="Numerical Response Problems"> + <file name="Numerical_Response_Problems.tex"/> </subsection> - </section> - - <section name="Printing Your Resources"> - <subsection name="Printing from Construction Space"> - <file name="Print_Resource.tex" /> - </subsection> - <subsection name="Printing a Subdirectory of Problems"> - <file name="Print_Library.tex" /> - - - </subsection> - <subsection name="Tips for Improving Print Output"> - <file name="Print_Options.tex" /> - - <subsubsection name="TeXsize attribute"> - <file name="TEXsize_attribute.tex" /> - </subsubsection> - <subsubsection name="TeXwidth attribute"> - <file name="TEXwidth_attribute.tex" /> - </subsubsection> - <subsubsection name="TeXDropEmptyColumns attribute"> - <file name="TEXDropEmptyColumns_attribute.tex"/> - </subsubsection> - <subsubsection name="Image TeX attributes"> - <file name="Problem_LON-CAPA_Image_Options.tex"/> - </subsubsection> - <subsubsection name="TeX Type attribute"> - <file name="TEXtype_attribute.tex" /> - </subsubsection> - <subsubsection name="TeX Itemgroup attribute"> - <file name="TEXitemgroup_attribute.tex" /> - </subsubsection> - <subsubsection name="TeX Item Group Width attribute"> - <file name="TEXitemgroupwidth_attribute.tex" /> - </subsubsection> - <subsubsection name="TeX Layout attribute"> - <file name="TEXlayout_attribute.tex" /> - </subsubsection> + <subsection name="Formula Response Problems"> + <file name="Formula_Response_Problems.tex"/> </subsection> - <subsection name="Troubleshooting PDF Errors"> - <file name="Print_Tricks.tex" /> - </subsection> - </section> + <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="Publishing Your Resources"> - <file name="Publishing_Intro.tex"/> - <subsection name="What is Metadata?"> - <file name="Metadata_Description.tex"/> + <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> - <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"/> + <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="Creating A Course: Maps and Sequences"> - <file name="Creating_A_Course_Intro.tex"/> - <subsection name="Creating Sequences"> - <file name="Sequence_Definition.tex"/> - <file name="Sequence_Editor_Selection.tex"/> - </subsection> - <subsection name="Creating 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"> - <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"> - <file name="Sequence_Top-Level.tex"/> + <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="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="Numerical Response And Formula Response Questions"> + </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"/> @@ -251,15 +177,17 @@ <subsubsection name="Variables in the Answer Block"> <file name="Variables_in_the_Answer_Block.tex"/> </subsubsection> - </subsection> + </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."/> + <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="Authoring Formula Response Problems"> + <file name="Creating_Formula_Response.tex"/> + </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"> @@ -286,6 +214,155 @@ <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" /> + <subsection name="Specifying Curves to Plot" > + <file name="Authoring_Dynamic_Plot_Curve.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="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 Authoring Space"> + <file name="Print_Resource.tex" /> + </subsection> + <subsection name="Printing a Subdirectory of Problems"> + <file name="Print_Library.tex" /> + + + </subsection> + <subsection name="Tips for Improving Print Output"> + <file name="Print_Options.tex" /> + + <subsubsection name="TeXsize Attribute"> + <file name="TEXsize_attribute.tex" /> + </subsubsection> + <subsubsection name="TeXwidth Attribute"> + <file name="TEXwidth_attribute.tex" /> + </subsubsection> + <subsubsection name="TeXDropEmptyColumns Attribute"> + <file name="TEXDropEmptyColumns_attribute.tex"/> + </subsubsection> + <subsubsection name="Image TeX Attributes"> + <file name="Problem_LON-CAPA_Image_Options.tex"/> + </subsubsection> + <subsubsection name="TeX Type Attribute"> + <file name="TEXtype_attribute.tex" /> + </subsubsection> + <subsubsection name="TeX Itemgroup Width Attribute"> + <file name="TEXitemgroupwidth_attribute.tex" /> + </subsubsection> + <subsubsection name="TeX Layout Attribute"> + <file name="TEXlayout_attribute.tex" /> + </subsubsection> + </subsection> + <subsection name="Troubleshooting PDF Errors"> + <file name="Print_Tricks.tex" /> + </subsection> + </section> + + <section name="Authoring Maps: Sequences and Pages"> + <file name="Creating_A_Course_Intro.tex"/> + <subsection name="Authoring Sequences"> + <file name="Sequence_Definition.tex"/> + <file name="Sequence_Editor_Selection.tex"/> + </subsection> + <subsection name="Authoring a Simple .sequence With The Simple Editor"> + <file name="Sequence_Simple_Editor_Creation.tex"/> + </subsection> + <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="Courses: Top-level Sequence"> + <file name="Sequence_Top-Level.tex"/> + </subsection> </section> <section name="Tags Used in XML Authoring"> @@ -341,16 +418,17 @@ </section> <section name="<script> Tag"> - <subsection name="Supported script functions"> +<!-- 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> <subsection name="Script Variables"> <file name="Script_Variables.tex" /> </subsection> - <subsection name="Table: LON-CAPA functions"> + <subsection name="Table: LON-CAPA Functions"> <file name="Problem_LON-CAPA_Functions.tex" /> </subsection> - <subsection name="Table: CAPA vs. LON-CAPA function differences"> + <subsection name="Table: CAPA vs. LON-CAPA Function Differences"> <file name="CAPA_LON-CAPA_function_diffs.tex" /> </subsection> </section> @@ -363,7 +441,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">