[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Author_LON-CAPA_Introduction.tex

[raeburn]

raeburn		Sat Dec 23 23:25:05 2023 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Author_LON-CAPA_Introduction.tex 
  Log:
  - Opera is a supported web browser
  - Add information about workflow
  - Update information about available editors
  
  
-------------- next part --------------
Index: loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex
diff -u loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex:1.15 loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex:1.16
--- loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex:1.15	Mon Jan 23 20:29:42 2017
+++ loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex	Sat Dec 23 23:25:05 2023
@@ -2,12 +2,22 @@
 
 LON-CAPA is a web-based content management system that helps to organize and present your
 course website, deliver and manage assignments, and manage student enrollment, assessment, and grading.
-Typically all author functions will be completed using a web browser (Firefox, Chrome, Safari, IE or similar).
+Typically all author functions will be completed using a web browser (Firefox, Chrome, Safari, Opera, IE, Edge or similar).
 The one exception to this is where your LON-CAPA domain has been configured to support webDAV access, in which
 case you may be able to carry out standard file operations (copy, move, add file etc.) using your computer's 
 standard filesystem interface, after you have established access to your authoring space volume.
 
-LON-CAPA has three work spaces: the ROLES menu, the course/community space where courses are developed from resources, and the authoring space where resources are composed and published. There are two user manuals for LON-CAPA, a course coordinator manual and author manual. Also, there are quick reference guides to building a course and building an exam,  available at \texttt{http://help.loncapa.org} . This is the author manual used to create resources such as problems that can later be added to your course.
+\subsubsection*{Work spaces and workflow}
+
+LON-CAPA has three work spaces: the ROLES menu, the course/community space where courses are developed from resources, and the authoring space where resources are composed and published. There are two user manuals for LON-CAPA, a course coordinator manual and author manual. Also, there are quick reference guides to building a course and building an exam, available at \texttt{http://help.loncapa.org} . This is the author manual used when creating resources such as problems that can later be added to your course.
+
+LON-CAPA facilitates workflow by providing a couple of mechanisms to switch easily between course container context and authoring context without the need to visit the Roles menu to change roles:
+\begin{itemize}
+\item For resources already included in a course and which originate from an authoring space for which you have access (i.e., you are author or co-author), then an Edit link will be present in the Functions menu directly above the resource when displaying it as a Course Coordinator, and the link will take you directly to the authoring environment for that resource.
+\item If you want to create a new LON-CAPA assessment item in a course, you can do so via the Course Editor, by following the ``Standard Problem'' link in the Assessment ``mini'' tab (with the ``Main Content'' tab active).
+\end{itemize}
+
+\subsubsection*{Before you start}
 
 Before creating problems, you should have:
 
@@ -52,19 +62,18 @@
 \texttt{https://developer.mozilla.org/en-US/docs/Web/HTML/Reference}
 \end{itemize}
 
-\subsubsection*{Five editors}
+\subsubsection*{Available editors}
 
-\bigbreak
-The authoring environment currently includes 5 different editors:
+By default, the authoring environment includes five different editors, although your domain administrator may have chosen to make fewer than five available.
 \begin{itemize}
-\item The \emph{plain text editor} is simply a text area that lets you edit the source code directly. It lacks any special feature, but can be useful for people with disabilities because it is supported by screen readers. To use it, CodeMirror must be disabled in the preferences, in the \emph{Authoring Space Configuration} section.
+\item The \emph{plain text editor} is simply a text area that lets you edit the source code directly. It lacks any special feature, but can be useful for people with disabilities because it is supported by screen readers. To use it, CodeMirror must be disabled either via the \emph{Authoring Space Configuration} link/icon in Preferences, or via Settings $>$ Editing Options in the inline menu (in Authoring Context).
 \item \emph{CodeMirror} is a text editor, and it is launched when you click on the ``EditXML'' button. It lets you edit the source code directly, but adds syntax highlighting and templates to help with editing the code.
-\item \emph{CKEditor} is a simple WYSIWYG HTML editor used in LON-CAPA to edit blocks of plain text or HTML. It is used when you click on the ``Edit'' button for a \texttt{.html} file and click on ``Rich formatting''. It can also be used within the colorful editor to edit blocks of text, also by clicking on the ``Rich formatting'' link. CKEditor is just an HTML editor, and it does not support LON-CAPA elements well, with the exception of \texttt{<m>} and \texttt{<chem>}, for which plugins have been added.
+\item \emph{CKEditor} is a simple WYSIWYG HTML editor used in LON-CAPA to edit blocks of plain text or HTML. It is used when you click on the ``Edit'' button for a \texttt{.html} file and click on ``Rich formatting''. It can also be used within the colorful editor to edit blocks of text, also by clicking on the ``Rich formatting'' link. CKEditor is an HTML editor, with some support for LON-CAPA-specific elements such as \texttt{<m>} and \texttt{<chem>}, for which plugins have been added.
 \item The \emph{colorful editor} is LON-CAPA's default editor, launched when you click on the ``Edit'' button for a \texttt{.problem} file. It hides the source code and displays the document with colored boxes representing the elements. It provides a list of elements that can be inserted at a particular place in the document, helps to choose correct values when several values are possible for an attribute, and generally makes sure the syntax is correct.
-\item \emph{Daxe} is a new editor, meant to replace the colorful editor in the future. It is started with the ``Daxe'' button. Like the colorful editor, it hides the source code and provides a graphical interface which makes it easier to create documents without knowing the language. It displays elements in a better way, and makes it easier to edit documents with cut/copy/paste and drag \& drop features. HTML elements are often displayed exactly the way they look like in the end. Many response elements have both a ``simple'' and an ``advanced'' view, making it easy to create simple problems. A preview is available to the right, making it easy to see what the entire document will look like.
+\item \emph{Daxe} is based on the Daxe XML editor for the web. It adds an XML schema, Daxe configuration and user interface code for the markup language used by LON-CAPA documents. It is started with the ``Daxe'' button. Like the colorful editor, it hides the source code and provides a graphical interface which makes it easier to create documents without knowing the language. It displays elements in a way that makes it easier to edit documents with cut/copy/paste and drag \& drop features. HTML elements are often displayed exactly the way they will look outside the editor environment. Many response elements have both a ``simple'' and an ``advanced'' view, making it easy to create simple problems. A preview is available to the right, making it easy to see what the entire document will look like.
 \end{itemize}
 
-It is possible to edit a problem in one editor, save it, and switch to another editor to continue. Authors are encouraged to try all editors to find their favorite, but it is also possible to use an editor for certain operations and another one for other operations. Simple syntax errors can for instance be fixed easily with CodeMirror, but editing is in general easier with Daxe.
+It is possible to edit a problem in one editor, save it, and switch to another editor to continue. Authors are encouraged to try all editors to find their favorite, but it is also possible to use an editor for certain operations and another one for other operations. Simple syntax errors can for instance be fixed easily with CodeMirror, but editing in general may be easier with one of the other editors.
 
 \subsubsection*{Scripts}