File:  [LON-CAPA] / loncom / html / adm / help / tex / Authoring_Daxe_Toolbar.tex
Revision 1.1: download - view: text, annotated - select for diffs
Wed Mar 27 16:39:44 2024 UTC (3 months, 1 week ago) by raeburn
Branches: MAIN
CVS tags: version_2_12_X, version_2_11_4_msu, HEAD
- Contents of tutorial/getting_started.xhtml divided into 11 .tex files
- Two links added to "Help" dropdown in Daxe Editor:
   one to Daxe FAQ,
   one to LON-CAPA Math Syntax (describes lm tag).
- Existing "Getting Started" link points to composite of 9 .hlp files
  to facilitate multilingual support.

\label{Authoring_Daxe_Toolbar}

\textbf{Daxe Toolbar}

\includegraphics[width=0.03\paperwidth]{daxetoolbar}

The toolbar provides the following buttons:
\begin{itemize}
  \item \textbf{Save}: saves the document and updates the preview. A shortcut for this action is 
        \texttt{ctrl-S}. The ``Save and Edit'' button in the last LON-CAPA menu row above the Daxe menus performs the same action.
  \item \textbf{Undo/Redo}: Daxe supports multiple undo/redo, which can also be called with 
       \texttt{ctrl-Z} and \texttt{ctrl-Y} or \texttt{ctrl-shift-Z}.
  \item \textbf{Cut/Copy}: These buttons can be used to copy text, elements, or even the 
        whole document into the clipboard. The paste button is not available because of 
        browser security constraints, but the paste action can be done easily with 
        \texttt{ctrl-V} (web browsers want to make sure that a web site cannot read a user's clipboard 
        without an explicit user action such as \texttt{ctrl-V}).
  \item \textbf{Search}: displays a dialog to search and possibly replace text in the document.
  \item \textbf{Insert image}: displays a dialog to choose an already uploaded image. 
        If an image needs to be uploaded first, users currently have to switch to another tab 
        to do that outside of Daxe. Daxe will automatically measure an image's dimensions 
        and insert the width and height in the attributes. An \textit{alt} attribute should also be provided 
        as a text alternative. The image will display directly in the document. Attributes can be modified by clicking on it.
  \item \textbf{Insert symbol}: provides a list of symbols that can be inserted as Unicode characters.  
        Note that, although this is less and less likely to happen, some Unicode characters might not be visible to 
        students who do not have the right fonts.
  \item \textbf{Insert LaTeX math}: displays a dialog to type LaTeX math, with a real-time preview. 
        Note that the \$ signs are necessary for math to be correctly displayed in LON-CAPA.
        \texttt{\$\$...\$\$} can be used instead of \texttt{\$...\$} to display the math as a block, centered.  
        Alternatively, the other LaTeX math delimiters can be used: 
        \texttt{$\backslash$(...$\backslash$)} for inline math and \texttt{$\backslash$[...$\backslash$]} for display math.  
        LaTeX math should always be inside an \texttt{m} element, which is created automatically when the \$ button is used.
  \item \textbf{Insert LON-CAPA math}: use this button to directly type math with the LON-CAPA math syntax in the document.  
        A real-time preview is displayed underneath, and a click outside the text field replaces the text by the preview.  
        There are two options for interpreting the math: \textit{symbols} and \textit{units}.  
        With \textit{symbols}, all letters are interpreted as variables and displayed with an italic font.   
        With \textit{units}, units such as ``m'' are recognized and displayed normally.  
        Internally with an LON-CAPA document, the math expression you type is wrapped within \texttt{$<$lm$>$ $<$/lm$>$} tags.  
        If a resource containing these tags is rendered on a LON-CAPA server running an older (pre-2.12) version of LON-CAPA, 
        the tags will be ignored and the text will be displayed without any special formatting.
  \item \textbf{Insert table}: asks for the table attributes and inserts it with 2 rows and columns.  
        Rows and columns can be changed with the table toolbar.
  \item \textbf{Bulleted list}: turns the current paragraph into a bulleted list, or removes the list.
  \item \textbf{Ordered list}: turns the current paragraph into an ordered list, or removes the list.
  \item \textbf{Rise list level}: turns a first-level list item into a simple paragraph, or moves the list indent left.
  \item \textbf{Lower list level}: moves the list indent right.
  \item \textbf{Add hyperlink}: adds a hyperlink over the selected text. Make sure to fill in the \textit{href} attribute 
         with the link address, which can be relative or absolute.
  \item \textbf{Insert anchor}: inserts an HTML anchor at the cursor position. Make sure to fill the \textit{name} attribute.
  \item \textbf{Styles}: turns selected text into one of these styles: bold, italic, superscript, subscript.
        A CSS stylesheet should be used for more style control. When the style is chosen before typing (with no selection), 
        the style element's tags are visible, which makes it possible to remove empty style elements.
  \item \textbf{Remove styles}: removes all styles from the current selection.
  \item \textbf{Paragraph alignment}: changes the current paragraph alignment.  
        This is only possible if the cursor is within a paragraph.
  \item \textbf{Font type}: changes the font family for the selected text.  
        A CSS stylesheet should be used for more style control.
  \item \textbf{Insert section}: inserts a section with the chosen class at the cursor location.  
        Sections are useful to structure the text with explicit roles for each block, and the icons can be useful 
        for students to recognize each role. Once several sections of a given class are defined, 
        it is easy to change the display for all of them at the same time using CSS.
\end{itemize}

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>