# [LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Docs_Web_Page.tex

lira lira at source.lon-capa.org
Sun Jul 21 22:57:33 EDT 2013

lira		Mon Jul 22 02:57:33 2013 EDT

Log:
initial commit

\label{Docs_Web_Page}
\index{web page}
Web Page documents are stored differently than they might appear on a typical
server. Within LON-CAPA the Web Page and supporting image/multimedia are composed/uploaded
via a single link on the course contents instead of creating folders for the
dependencies. Within LON-CAPA, and subfolders are virtual'.

There are two ways to create a web page in the Course Editor. One method is
to upload the file as explained in the section \ref{Upload Web Page}. The other
method described here is to compose the page online using:

\begin{itemize}
\item\textbf{Course Editor -\textgreater
Special Pages -\textgreater Blank Web Page}
\item\fbox{Re-initialize} the course.
\item Click the \textbf{Edit} link on the line for the new page.
\item The main editor window will have a subsidiary menu containing:
\textbf{Math Rendering/Change View, Edit,} and \textbf{Manage Dependencies}.
\item The \textbf{Math Rendering/Change View} \index{math rendering}
selector changes the rendering
engine used to display mathematics. This tool permits you to view the web page
using various settings. Unless you have configured a setting for the
course, each student's settings are used when they view the page. See
\item Clicking \textbf{Manage Dependencies} launches a pop-up window which will check
the web page for links and embedded objects (e.g., images) and prompt for upload,
if missing, or possible replacement, if found. This is helpful for changing dependent
files for an existing page.
\item Clicking the \textbf{Edit} button will display a textarea which can be used to
edit the source HTML, or the Rich Format'' link can be clicked to switch to
the WYSIWYG editor\index{WYSIWYG editor}. The WYSIWYG editor includes an image button which
creates an \textless img\textgreater and pops up a modal window in which you can
specify a path for the image. You can use a link to external resources, or to
looks like \\
where \\
\texttt{\textless domain\textgreater/\textless username\textgreater/\textless path\textgreater/photo.jpg} are replaced with the actual names.

If you create an image link for a file used only for this web page, the path is
virtual in the sense that you create a virtual folder structure and
it will not be a folder structure that students browse. You should
use a relative path, e.g.
\textless img alt=my photo'' src=images/photo.jpg'' \textgreater
as if photo.jpg'' is in a subfolder images''. For this type
of image, you create the path in the \textless img\textgreater  tag before uploading
the image using the \textbf{Manage Dependencies} button described next.

The editing window also includes a \textbf{Manage Dependencies}\index{manage dependencies}
\index{dependencies, manage}\index{image} button.  After
adding an \textless img\textgreater tag with the src attribute pointing to a relative URL,
click \textbf{Save and Edit}.  In WYSIWYG mode a broken image icon will be
displyed.  Click "Manage dependencies" and you will be prompted to
`