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

[lira]

lira		Mon Jul 22 02:57:33 2013 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Docs_Web_Page.tex 
  Log:
  initial commit
  
  

Index: loncom/html/adm/help/tex/Docs_Web_Page.tex
+++ loncom/html/adm/help/tex/Docs_Web_Page.tex
\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
the section \ref{Course_Prefs_Display} for more information.\index{math rendering}. 
	\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
published resources. The link to a resource in your published space
looks like \\
\texttt{/res/\textless domain\textgreater/\textless username\textgreater/\textless path\textgreater/photo.jpg}
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
upload an appropriate file from your computer.
	
Note that an \textbf{Edit} link is also provided when viewing the page in the
course context that is a shortcut to this editor.
\end{itemize}