[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Course_Prefs_Display.tex Creating_New_Content_Pages.tex Docs_Creating_From_Template.tex Docs_Importing_LON-CAPA_Resource.tex Docs_Overview.tex Docs_Uploading_From_Harddrive.tex Edit_Syllabus.tex Helper_Course_Initialization.tex
lira
lira at source.lon-capa.org
Sun Jul 21 23:02:46 EDT 2013
lira Mon Jul 22 03:02:46 2013 EDT
Modified files:
/loncom/html/adm/help/tex Course_Prefs_Display.tex
Creating_New_Content_Pages.tex
Docs_Creating_From_Template.tex
Docs_Importing_LON-CAPA_Resource.tex
Docs_Overview.tex
Docs_Uploading_From_Harddrive.tex
Edit_Syllabus.tex
Helper_Course_Initialization.tex
Log:
improving course manual
-------------- next part --------------
Index: loncom/html/adm/help/tex/Course_Prefs_Display.tex
diff -u loncom/html/adm/help/tex/Course_Prefs_Display.tex:1.1 loncom/html/adm/help/tex/Course_Prefs_Display.tex:1.2
--- loncom/html/adm/help/tex/Course_Prefs_Display.tex:1.1 Sat Jan 15 03:10:51 2011
+++ loncom/html/adm/help/tex/Course_Prefs_Display.tex Mon Jul 22 03:02:46 2013
@@ -1,2 +1,15 @@
\label{Course_Prefs_Display}
+
This panel lets you set various display options for content.
+\begin{itemize}
+ \item Default XML style sheet
+ \item Visibly Separate Items on a Page
+ \item Disable Display of Problem Receipts
+ \item Force use of a specific math rendering engine
+ \item Set default options for tth/m when converting text to html
+\end{itemize}
+
+Math rendering defaults to the student's individual setting. If desired to
+force a specific math rendering\index{math rendering} option for the course,
+use this screen.
+
Index: loncom/html/adm/help/tex/Creating_New_Content_Pages.tex
diff -u loncom/html/adm/help/tex/Creating_New_Content_Pages.tex:1.12 loncom/html/adm/help/tex/Creating_New_Content_Pages.tex:1.13
--- loncom/html/adm/help/tex/Creating_New_Content_Pages.tex:1.12 Mon Jul 8 20:41:59 2013
+++ loncom/html/adm/help/tex/Creating_New_Content_Pages.tex Mon Jul 22 03:02:46 2013
@@ -11,7 +11,8 @@
in the lower part of the authoring screen. Then select 'HTML file' from the new content dropdown menu on the
right of the authoring space page as shown in the dropdown menu of the figure \ref{New Content Menu}.
-You will be presented with a plain text editor as shown in the figure \ref{Plain Text HTML Editor}. Clicking
+When you edit a web page, you will be presented with a plain text editor as shown in the
+figure \ref{Plain Text HTML Editor}. Clicking
the link for the Rich Formatting displays the HTML WYSIWYG editor with buttons to help you create html entities
with correct tags as shown in the figure \ref{Rich Text HTML Editor}. If the rich layout is not as you expect, look
for the button to view/edit the source, and then manually make adjustments to the html tags. Note that buttons are
Index: loncom/html/adm/help/tex/Docs_Creating_From_Template.tex
diff -u loncom/html/adm/help/tex/Docs_Creating_From_Template.tex:1.8 loncom/html/adm/help/tex/Docs_Creating_From_Template.tex:1.9
--- loncom/html/adm/help/tex/Docs_Creating_From_Template.tex:1.8 Sun May 23 15:49:50 2010
+++ loncom/html/adm/help/tex/Docs_Creating_From_Template.tex Mon Jul 22 03:02:46 2013
@@ -4,22 +4,17 @@
to fill out and add to your course.
To add a templated document to your course, click on
-\textbf{Special Documents} at the buttom of the \textbf{Course Editor} screen.
-Select the templated
-\includegraphics[width=0.03\paperwidth]{syllabus}
-\textbf{Syllabus},
-\includegraphics[width=0.03\paperwidth]{simple}
-\textbf{Simple Course Page},
-\includegraphics[width=0.03\paperwidth]{bchat}
-\textbf{Discussion Board}, or
-\includegraphics[width=0.03\paperwidth]{aboutme}
-\textbf{My Personal Information Page}.
-Clicking on
-\includegraphics[width=0.03\paperwidth]{simple}
-\textbf{Simple Course Page} and
-\includegraphics[width=0.03\paperwidth]{bchat}
-\textbf{Discussion Board} will pop up a window asking you to give a title (if necessary). Once you've
-titled the page, it will be added to the end of the current folder of the
-\textbf{Course Editor} screen.
+\textbf{Special Documents} Inline Menu of the \textbf{Course Editor} screen.
+Items include
+\begin{itemize}
+\item\includegraphics[width=0.03\paperwidth]{page}
+\textbf{Composite Page}
+\item\includegraphics[width=0.03\paperwidth]{syllabus}
+\textbf{Syllabus}
+\item\includegraphics[width=0.03\paperwidth]{navigation}
+\textbf{Table of Contents}
+\item\includegraphics[width=0.03\paperwidth]{simple}
+\textbf{Simple Course Page}
+\item\textbf{Blank Web Page}
+\end{itemize}
-NOTE: Your new resources will be visible the next time you log in, or by clicking the \fbox{re-intializing course} button on the \textbf{Course Editor} screen.
Index: loncom/html/adm/help/tex/Docs_Importing_LON-CAPA_Resource.tex
diff -u loncom/html/adm/help/tex/Docs_Importing_LON-CAPA_Resource.tex:1.8 loncom/html/adm/help/tex/Docs_Importing_LON-CAPA_Resource.tex:1.9
--- loncom/html/adm/help/tex/Docs_Importing_LON-CAPA_Resource.tex:1.8 Sat May 22 23:28:44 2010
+++ loncom/html/adm/help/tex/Docs_Importing_LON-CAPA_Resource.tex Mon Jul 22 03:02:46 2013
@@ -8,21 +8,21 @@
\begin{enumerate}
\item At the \textbf{User Roles} screen, select the role \textbf{Course Coordinator}.
-\item Select \textbf{Course Editor} on the Inline Menu or
-\includegraphics[width=0.03\paperwidth]{docs}
-\textbf{Edit course contents}
-within Main Menu.
+\item Select \textbf{Course Editor} on the Inline Menu or
+\includegraphics[width=0.03\paperwidth]{docs}
+\textbf{Edit course contents}
+within Main Menu.
\item At the \textbf{Course Editor} screen, click \fbox{Published Resources}
-at the buttom of the screen.
-\item Click on
-\includegraphics[width=0.03\paperwidth]{res}
-\textbf{Import}.
+at the buttom of the screen.
+\item Click on
+\includegraphics[width=0.03\paperwidth]{res}
+\textbf{Import}.
The \textbf{Browse Published Resources} screen will open with a view of the
LON-CAPA network. Navigate to find the desired resource.
NOTE: If you don't know exactly what resource(s) you want, click on
-\includegraphics[width=0.03\paperwidth]{src}
-\textbf{Search}.
+\includegraphics[width=0.03\paperwidth]{src}
+\textbf{Search}.
to pull up the LON-CAPA search interface.
\item Check the boxes next to the resources you wish to import.
@@ -32,5 +32,13 @@
your course documents.
\end{enumerate}
+If you are importing a \textbf{Web Page}\index{web page},
+it is important to understand that image/linked files do not need to be
+specifically imported into a course, if used within a published file
+which is already imported into a course. The metadata for the imported
+web page includes the dependencies, and import of the web page into the
+course automatically allows students enrolled in the course access to
+view the images as well as the web page which contains them.
+
NOTE: Your new resources will be visible the next time you log in, or by
- \fbox{re-initializing course}.
+ \fbox{re-initializing course}.
Index: loncom/html/adm/help/tex/Docs_Overview.tex
diff -u loncom/html/adm/help/tex/Docs_Overview.tex:1.11 loncom/html/adm/help/tex/Docs_Overview.tex:1.12
--- loncom/html/adm/help/tex/Docs_Overview.tex:1.11 Mon Jul 15 12:32:20 2013
+++ loncom/html/adm/help/tex/Docs_Overview.tex Mon Jul 22 03:02:46 2013
@@ -13,7 +13,7 @@
the \textbf{Contents} screen. Main Content was added to
LON-CAPA in 2003, so pre-2003 courses (as well as courses deliberately created in
the old style) will not have Main Content. The Main Content was called
-Main Content\index{Main Content} from then until version 2.11.
+Main Content\index{main content} from then until version 2.11.
\textbf{Supplemental Content} is on another tab on the \textbf{Course Editor} page.
It is attached to the course but does
Index: loncom/html/adm/help/tex/Docs_Uploading_From_Harddrive.tex
diff -u loncom/html/adm/help/tex/Docs_Uploading_From_Harddrive.tex:1.6 loncom/html/adm/help/tex/Docs_Uploading_From_Harddrive.tex:1.7
--- loncom/html/adm/help/tex/Docs_Uploading_From_Harddrive.tex:1.6 Sun May 23 15:49:50 2010
+++ loncom/html/adm/help/tex/Docs_Uploading_From_Harddrive.tex Mon Jul 22 03:02:46 2013
@@ -14,11 +14,40 @@
within Main Menu.
\item Click on \fbox{Import Documents} at the buttom of the \textbf{Course Editor} screen.
\item Type in the path to your document or click the \fbox{Browse...} button to find the document on
-your hard drive.
+your hard drive. Both zip and tar files are acceptable.
\item Type the document title in the Title text box.
\item Click the \fbox{Import Document} button.
\end{enumerate}
+\label{Upload Web Page}Special Notes on importing \textbf{Web Pages}\index{web page}: If you have already created a
+web page outside LON-CAPA you can upload the images when you first
+upload the web page, in one of two ways. Either:
+
+(a) upload the web page via: Course Editor -\textgreater Import Content -\textgreater Upload
+File, and check the \textbf{Upload embedded images/multimedia files if HTML
+file} checkbox. You will them be prompted to upload the image files (as
+dependencies)
+
+or
+
+(b) Create a zip (or tar) file archive containing the web page and the
+images (e.g., in a sub-folder). Use:
+
+Course Editor -\textgreater Import Content -\textgreater Upload File
+
+to upload the zip file. LON-CAPA will prompt you to decide what should
+be done with the content.
+
+In general, there is no need for image/multimedia files to be loaded into the
+course content hierarchy if the images are linked from a Web Page. Instead, upload the
+web page(s) that contain the images, and then upload the images as
+dependencies. One limitation of this method currently, is that if you
+use the same linked content in many places, those file cannot be shared and must
+be duplicated for each page. If you
+upload a Web Page and forget to check to box to include embedded images/multimedia
+files, you can still upload the individually. See the section
+\ref{Docs_Web_Page} for more information about working with Web Page file dependencies.
+
NOTE: Your new file will be visible the next time you log in, or by
- \fbox{re-initializing course} .
+\fbox{re-initializing course}.
Index: loncom/html/adm/help/tex/Edit_Syllabus.tex
diff -u loncom/html/adm/help/tex/Edit_Syllabus.tex:1.6 loncom/html/adm/help/tex/Edit_Syllabus.tex:1.7
--- loncom/html/adm/help/tex/Edit_Syllabus.tex:1.6 Sat May 22 21:51:32 2010
+++ loncom/html/adm/help/tex/Edit_Syllabus.tex Mon Jul 22 03:02:46 2013
@@ -1,10 +1,10 @@
\label{Edit_Syllabus}
By default, the syllabus is placed in your course documents, and you
-can access it from the \textbf{Navigate Course Contents} screen or the \textbf{Course Documents} screen. There is also a link to your syllabus on the \textbf{User Roles} screen.
+can access it from the \textbf{Main Contents} screen. There is also a link to your syllabus for each course on the \textbf{User Roles} screen.
As a Course Coordinator, you see the syllabus in Edit Mode. Fill in one or more
-of the text boxes and click any of the \fbox{Save} buttons to save
-changes to your syllabus. Clicking the \underbar{Show Public View}
+of the text boxes and click any of the \fbox{Save All} buttons to save
+changes to your syllabus. Clicking the \textbf{Show Public View}
link will show you what the syllabus looks like to your class. You
can copy the URL of your syllabus and distribute it to anyone. The
syllabus is publicly viewable and anyone can see it, even without logging into LON-CAPA.
Index: loncom/html/adm/help/tex/Helper_Course_Initialization.tex
diff -u loncom/html/adm/help/tex/Helper_Course_Initialization.tex:1.5 loncom/html/adm/help/tex/Helper_Course_Initialization.tex:1.6
--- loncom/html/adm/help/tex/Helper_Course_Initialization.tex:1.5 Mon Jul 15 12:32:20 2013
+++ loncom/html/adm/help/tex/Helper_Course_Initialization.tex Mon Jul 22 03:02:46 2013
@@ -1,7 +1,20 @@
\label{Helper_Course_Initialization}
+\index{initialization, course}
+\index{helper, course initialization}
The first time you enter your course, you will see the
Course Initialization Helper. Click the \fbox{Next} button on each
-screen to keep the LON-CAPA default settings. When you are done going
+screen to keep the LON-CAPA default settings. The helper will step you
+through the major settings:
+\begin{itemize}
+ \item Course Title
+ \item Disable Chat Room Participation
+ \item Disable Discussion Participation
+ \item HTML preferences for posts
+ \item Course Feedback recipient settings (not clear if course coordinator is set).
+ \item Course Cloning Permissions
+\end{itemize}
+
+When you are done going
through the Helper, click the \fbox{Finish} button, which takes you to the Main Menu screen.
By default, the first resource in the course will open when the students log in.
More information about the LON-CAPA-cvs
mailing list