Annotation of loncom/html/adm/help/tex/Docs_Web_Page.tex, revision 1.1

1.1     ! lira        1: \label{Docs_Web_Page}
        !             2: \index{web page}
        !             3: Web Page documents are stored differently than they might appear on a typical
        !             4: server. Within LON-CAPA the Web Page and supporting image/multimedia are composed/uploaded
        !             5: via a single link on the course contents instead of creating folders for the 
        !             6: dependencies. Within LON-CAPA, and subfolders are `virtual'.
        !             7: 
        !             8: There are two ways to create a web page in the Course Editor. One method is
        !             9: to upload the file as explained in the section \ref{Upload Web Page}. The other 
        !            10: method described here is to compose the page online using: 
        !            11: 
        !            12: \begin{itemize}
        !            13: 	\item\textbf{Course Editor -\textgreater
        !            14: Special Pages -\textgreater Blank Web Page}
        !            15: 	\item\fbox{Re-initialize} the course.
        !            16: 	\item Click the \textbf{Edit} link on the line for the new page.
        !            17: 	\item The main editor window will have a subsidiary menu containing:
        !            18: \textbf{Math Rendering/Change View, Edit,} and \textbf{Manage Dependencies}.
        !            19: 	\item The \textbf{Math Rendering/Change View} \index{math rendering}
        !            20: selector changes the rendering
        !            21: engine used to display mathematics. This tool permits you to view the web page 
        !            22: using various settings. Unless you have configured a setting for the
        !            23: course, each student's settings are used when they view the page. See
        !            24: the section \ref{Course_Prefs_Display} for more information.\index{math rendering}. 
        !            25: 	\item Clicking \textbf{Manage Dependencies} launches a pop-up window which will check
        !            26: the web page for links and embedded objects (e.g., images) and prompt for upload,
        !            27: if missing, or possible replacement, if found. This is helpful for changing dependent
        !            28: files for an existing page.
        !            29: 	\item Clicking the \textbf{Edit} button will display a textarea which can be used to
        !            30: edit the source HTML, or the ``Rich Format'' link can be clicked to switch to
        !            31: the WYSIWYG editor\index{WYSIWYG editor}. The WYSIWYG editor includes an image button which
        !            32: creates an \textless img\textgreater and pops up a modal window in which you can 
        !            33: specify a path for the image. You can use a link to external resources, or to
        !            34: published resources. The link to a resource in your published space
        !            35: looks like \\
        !            36: \texttt{/res/\textless domain\textgreater/\textless username\textgreater/\textless path\textgreater/photo.jpg}
        !            37: where \\
        !            38: \texttt{\textless domain\textgreater/\textless username\textgreater/\textless path\textgreater/photo.jpg} are replaced with the actual names.
        !            39:  
        !            40: If you create an image link for a file used only for this web page, the path is
        !            41: virtual in the sense that you create a virtual folder structure and 
        !            42: it will not be a folder structure that students browse. You should
        !            43: use a relative path, e.g. 
        !            44: \textless img alt=``my photo'' src=``images/photo.jpg'' \textgreater 
        !            45:  as if ``photo.jpg'' is in a subfolder ``images''. For this type
        !            46: of image, you create the path in the \textless img\textgreater  tag before uploading 
        !            47: the image using the \textbf{Manage Dependencies} button described next.
        !            48: 
        !            49: The editing window also includes a \textbf{Manage Dependencies}\index{manage dependencies}
        !            50: \index{dependencies, manage}\index{image} button.  After
        !            51: adding an \textless img\textgreater tag with the src attribute pointing to a relative URL,
        !            52: click \textbf{Save and Edit}.  In WYSIWYG mode a broken image icon will be
        !            53: displyed.  Click "Manage dependencies" and you will be prompted to
        !            54: upload an appropriate file from your computer.
        !            55: 	
        !            56: Note that an \textbf{Edit} link is also provided when viewing the page in the
        !            57: course context that is a shortcut to this editor.
        !            58: \end{itemize}
        !            59: 

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