Annotation of loncom/html/adm/help/tex/Authoring_Daxe_FAQ.tex, revision 1.1
1.1 ! raeburn 1: \label{Authoring_Daxe_FAQ}
! 2:
! 3: \textbf{Daxe Editor -- Frequently Asked Questions}
! 4:
! 5: \begin{description}
! 6:
! 7: \item[\textmd{\normalsize\textit{Is Daxe compatible with the other LON-CAPA editors?}}]
! 8:
! 9: It should be. But a conversion is needed before a document can be loaded into Daxe,
! 10: and a conversion is done afterwards to match the syntax of the other editors.
! 11: So it is possible that the initial conversion fails, and it is possible that the syntax
! 12: or spacing is altered in some ways. Still, this should not change the output.
! 13:
! 14: \item[\textmd{\normalsize\textit{Which browsers are supported?}}]
! 15:
! 16: Recent versions of all browsers, on all platforms.
! 17: This constraint is related to the technology used to create Daxe, which is Dart. No plugin is needed.
! 18:
! 19: \item[\textmd{\normalsize\textit{What is an element?}}]
! 20:
! 21: ``element'' is a technical term related to the XML syntax used by Daxe.
! 22: It refers to a part of the document, starting with a start tag and ending with an end tag.
! 23: A hierarchical structure can be created by putting elements inside other elements.
! 24: The tags are usually hidden in LON-CAPA Daxe (a whole element being often represented as a box),
! 25: but you will see them if you look at the XML source with the File menu.
! 26:
! 27: \item[\textmd{\normalsize\textit{What is an attribute?}}]
! 28:
! 29: An attribute is a property of an element. It has a name and a value.
! 30: For instance, the \texttt{img} element (which represents an image) has a
! 31: \texttt{src} attribute which gives the path to the image file.
! 32:
! 33: \item[\textmd{\normalsize\textit{How do I select an element?}}]
! 34:
! 35: The easiest way is to double-click on the title when there is one,
! 36: but you can also click before the element, hold and drag until after its end.
! 37:
! 38: \item[\textmd{\normalsize\textit{How do I move an element?}}]
! 39:
! 40: Select it, cut it with \texttt{ctrl-X}, and paste it where you want with
! 41: \texttt{ctrl-V}.
! 42:
! 43: \item[\textmd{\normalsize\textit{How do I remove an element?}}]
! 44:
! 45: The easiest way is to do a right-click on the title and choose ``Remove''.
! 46: But the \texttt{backspace} or \texttt{del} keys can be used too.
! 47:
! 48: \item[\textmd{\normalsize\textit{Why is Daxe sometimes not selecting parts of elements?}}]
! 49:
! 50: Daxe is only doing operations that keep the document syntax correct.
! 51: So, it will not for instance select a start tag without the end tag,
! 52: because doing operations on a single tag could break the whole document.
! 53: But if you start a selection before a start tag, and continue
! 54: until after the end tag, the whole element will be selected.
! 55:
! 56: \item[\textmd{\normalsize\textit{How can I insert a movie or sound?}}]
! 57:
! 58: Use the HTML5's \texttt{video} or \texttt{audio} element (in the HTML-Media menu),
! 59: with the path to your previously uploaded video/audio file in the \texttt{src} attribute,
! 60: and for a video the dimensions in pixels in the \texttt{width} and \texttt{height} attributes.
! 61:
! 62: Remember that not all browsers support all formats, so it is actually better to provide
! 63: several files with the \texttt{source} element instead of using the \texttt{src} attribute.
! 64:
! 65: \item[\textmd{\normalsize\textit{My Perl script does not seem to be running ...}}]
! 66:
! 67: Make sure you are using the right \texttt{type} attribute.
! 68: If a script has no \texttt{type} attribute, it is assumed to be Javascript.
! 69:
! 70: \item[\textmd{\normalsize\textit{My math is not looking great in the preview ...}}]
! 71:
! 72: The preview uses the default math display engine for your domain (which may not be MathJax),
! 73: unless you have set your own user preference which overrides the default.
! 74:
! 75: \item[\textmd{\normalsize\textit{What is the validation (in the File menu) checking?}}]
! 76:
! 77: It checks that the elements used in the document really exist in the language,
! 78: and that each element inside a parent is allowed under. It also checks for the
! 79: order of the elements when there is a constraint about that,
! 80: but it is rare with LON-CAPA. It also checks for the syntax of each attribute.
! 81:
! 82: The fact that a document validates does not mean that it will run well in LON-CAPA.
! 83: For instance, there might be an error in a Perl script which will only be caught
! 84: when it is executed. But it helps to create documents that will run well everywhere.
! 85:
! 86: \item[\textmd{\normalsize\textit{How do I change options for the preview?}}]
! 87:
! 88: It is not possible within the Daxe page, but you can use the ``Problem Testing'' display
! 89: of the problem (e.g., by expanding the LON-CAPA menu block (if collapsed) and then
! 90: pushing the ``Save and View'' button to try different preview options.
! 91:
! 92: \item[\textmd{\normalsize\textit{Can I copy/paste source code between Daxe and the LON-CAPA text editor?}}]
! 93:
! 94: No ! The two editors are using a different syntax.
! 95: Daxe is using the XML syntax, while the text editor is using a LON-CAPA-specific syntax.
! 96: For instance, XML special characters are encoded inside m elements and attribute values with Daxe,
! 97: but that syntax would not work in LON-CAPA without a conversion.
! 98:
! 99: So if you need to reuse source code from Daxe with the text editor, save the document, exit Daxe,
! 100: and open the problem with the text editor before copying code.
! 101:
! 102: \item[\textmd{\normalsize\textit{How can I get the response field on the same line as the question?}}]
! 103:
! 104: Paragraph tags are hidden in the editor, and a paragraph is just indicated with a gray
! 105: \P mark on the lower right. If a response appears on a different line in the preview,
! 106: it might be because it is in a different paragraph, or outside of a paragraph.
! 107: To move the response in the paragraph with the question, one can select it, cut it,
! 108: and paste it after the text in the previous paragraph. The \P mark will appear on the
! 109: lower right of the response. Note that this is only possible with some responses,
! 110: since other responses display as blocks and cannot be put inside a paragraph.
! 111:
! 112: \end{description}
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>