[svn r14752] Improved documentation about enabling LaTeX

Made XHTML and CSS 2 compliant
Added CSS and XHTML compliant logos
skala
Yannick Warnier 18 years ago
parent 8331330a0c
commit 41912d4513
  1. 2
      documentation/default.css
  2. 164
      documentation/installation_guide.html

@ -617,7 +617,7 @@ div.admin_section h4 {
.announcements_datum
{
font-size: 12px;
font-weight: italic;
font-style: italic;
color: #666666;
}
/* System announcements on homepage */

@ -1,13 +1,16 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
<title>Dokeos 1.8.4 installation guide</title><link rel="stylesheet" href="default.css" type="text/css" media="screen,projection">
<link rel="shortcut icon" href="./favicon.ico" type="image/x-icon">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>Dokeos 1.8.4 installation guide</title>
<link rel="stylesheet" href="default.css" type="text/css" media="screen,projection" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="shortcut icon" href="./favicon.ico" type="image/x-icon" />
<style type="text/css">
<!--
@page { size: 21cm 29.7cm; margin: 2cm }
pre { font-family: "Courier New", monospace }
p { margin-bottom: 0.21cm }
.code {margin: 1em 1em 1em 2em; padding: 0.5em; background-color: rgb(229, 229, 229); vertical-align: top; border: 1px solid #999999;}
--></style>
</head>
<body>
@ -31,7 +34,7 @@ Management System (LMS). It explains how to install Dokeos Oogie
PowerPoint conversion and Dokeos Videoconferencing although these
packages are not required to use Dokeos LMS. &nbsp;Please read this fully before proceeding with the installation. </p>
If you want to save time, trouble and money, you can alternatively have your Dokeos portal <a href="http://www.dokeos.com/get.php">hosted</a> by Dokeos or one of its partners.<a href="http://www.dokeos.com/get.php"></a><br>
If you want to save time, trouble and money, you can alternatively have your Dokeos portal <a href="http://www.dokeos.com/get.php">hosted</a> by Dokeos or one of its partners.<a href="http://www.dokeos.com/get.php"></a><br />
<h2><b>Contents</b></h2>
<ol>
@ -47,7 +50,7 @@ If you want to save time, trouble and money, you can alternatively have your Dok
</ol>
<br />
<hr style="width: 100%; height: 2px;">
<hr style="width: 100%; height: 2px;" />
<h2><a name="1._Pre-requisites"></a>1. Pre-requisites</h2>
Dokeos
@ -87,7 +90,7 @@ the installation.
<br />
<br />
To take advantage of <span style="font-weight: bold;">Oogie</span> PowerPoint / Impress conversion, you need&nbsp; : <br>
To take advantage of <span style="font-weight: bold;">Oogie</span> PowerPoint / Impress conversion, you need&nbsp; : <br />
<ul>
<li><a href="http://www.openoffice.org/">OpenOffice</a><a href="http://www.openoffice.org/"></a></li>
@ -103,7 +106,7 @@ To take advantage of Dokeos <span style="font-weight: bold;">Videoconferencing</
<span style="font-weight: bold;"><br />
</span>
<hr style="width: 100%; height: 2px;">
<hr style="width: 100%; height: 2px;" />
<h2><a name="2._Installation_of_Dokeos_LMS"></a><span style="font-weight: bold;">2. Installation of Dokeos LMS</span></h2>
<a href="http://www.dokeos.com/download.php"></a>
<ul>
@ -148,7 +151,7 @@ In Windows, you may need to check the properties of the files and folders (by ri
<p>
<b>NOTES:</b><br>
<b>NOTES:</b><br />
Do not modify the home_*.html files directly. Instead,
choose "Configure the homepage" in the Dokeos administration section.</p>
<p><span style="font-weight: bold;">Windows</span> : with combination packages like XAMPP, out of the box, login and password
@ -195,21 +198,13 @@ To get the best of Dokeos, you need to finetune PHP settings. Consider : <br />
<li>you may want to end up&nbsp;with the following values : </li>
</ul>
<br />
<table style="text-align: left; width: 100%;" border="1" cellpadding="10" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(229, 229, 229);">
<small>
<div class="code">
max_execution_time = 300&nbsp;&nbsp;&nbsp; ; Maximum execution time of each script, in seconds<br />
max_input_time = 600 ; Maximum amount of time each script may spend parsing request data<br />
memory_limit = 256M&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ; Maximum amount of memory a script may consume (128MB)<br />
post_max_size = 64M<br />
upload_max_filesize = 100M
</small>
</td>
</tr>
</tbody>
</table>
</div>
<br />
<p>
Some users could meet problems if their PHP settings don't fit
@ -265,7 +260,7 @@ directories. You can still recover them from your backup if you have made it.
<em>If you upgrade from a lower version of Dokeos (1.6.x)</em>, the first
and most important thing to do is to *move* your current directory to another
place.<br> An easy way to do that is to create a subdirectory called
place.<br /> An easy way to do that is to create a subdirectory called
"old_version" in your current Dokeos directory and move everything in
there using a simple "move" command (i.e. under Linux: mkdir old_version;
mv * old_verion/), then make the old_version/ directory writeable by the web server so that courses/ and upload/ directories can be moved from the old to the new installation.<br /><br />The complete process is as follow:
@ -338,12 +333,11 @@ go to your Dokeos adress and log in with the admin user.
Then you will see a "Platform admin section" link in the header of the
web page. There you can manage users, courses, sessions, portal look
and feel, homepage content, course categories etc.&nbsp;</p>
<p></p>
<hr style="width: 100%; height: 2px;">
<p />
<hr style="width: 100%; height: 2px;" />
<h2><a name="6._LDAP"></a>6. LDAP</h2>
<p>
<i>This part is optional, only organisations with an LDAP server will need to read this.</i><br>
<i>This part is optional, only organisations with an LDAP server will need to read this.</i><br />
An LDAP module is already provided in Dokeos, but it has to be configured to make it work.
</p>
@ -445,60 +439,36 @@ audio-recorder.<br />
<li>Edit the OpenOffice Setup.xcu file </li>
</ul>
<table style="text-align: left; width: 100%;" border="1" cellpadding="10" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(229, 229, 229);"><small>On some Windows computers, located : <span style="font-weight: bold;">C:\Program Files\OpenOffice.org 2.2\share\registry\data\org\openoffice\Setup.xcu</span><br>
On some Linux computers, located : <span style="font-weight: bold;">/usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu</span></small></td>
</tr>
</tbody>
</table>
<div class="code">On some Windows computers, located : <span style="font-weight: bold;">C:\Program Files\OpenOffice.org 2.2\share\registry\data\org\openoffice\Setup.xcu</span><br />
On some Linux computers, located : <span style="font-weight: bold;">/usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu</span>
</div>
<br />
And add the following code <br />
<table style="text-align: left; width: 100%;" border="1" cellpadding="10" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(229, 229, 229);">
<small>&lt;prop oor:name="ooSetupConnectionURL"&gt;<br />
<div class="code">&lt;prop oor:name="ooSetupConnectionURL"&gt;<br />
&lt;value&gt;<br />
socket,host=localhost,port=2002;urp;StarOffice.ServiceManager<br />
&lt;/value&gt;<br />
&lt;/prop&gt;</small></td>
</tr>
</tbody>
</table>
&lt;/prop&gt;
</div>
<br />
... just below these lines<br />
&nbsp;<br />
<table style="text-align: left; width: 100%;" border="1" cellpadding="10" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(229, 229, 229);">
<small>&lt;prop oor:name="ooSetupInstCompleted"&gt;<br />
<div class="code">&lt;prop oor:name="ooSetupInstCompleted"&gt;<br />
&lt;value&gt;false&lt;/value&gt;<br />
&lt;/prop&gt;</small></td>
</tr>
</tbody>
</table>
&lt;/prop&gt;</div>
Enter your Dokeos portal on the web &gt; <span style="font-style: italic;">Admin section &gt;&nbsp; Configure the Services &gt; Oogie </span>and type :<br />
<br />
<table style="text-align: left; width: 100%;" border="1" cellpadding="10" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(229, 229, 229);"><small><span style="font-weight: bold;">Host : </span>localhost<br />
<span style="font-weight: bold;">Path to LZX Files</span>: /main/webrooms/recorder.swf<br>
<div class="code"><span style="font-weight: bold;">Host : </span>localhost<br />
<span style="font-weight: bold;">Path to LZX Files</span>: /main/webrooms/recorder.swf<br />
<br />
Leave the other fields empty<br />
Leave the default width and height of the converted slides unchanged
(as long as your clients use most often a 1024x768 standard definition
screen)</small></td>
</tr>
</tbody>
</table>
screen)</div>
<ul>
<li>Start OpenOffice. Conversion will work only if this software is up and running. Check the&nbsp;<a href="http://www.dokeos.com/wiki/index.php/MakeOOOListening">MakeOOOListening</a> wiki page to start OpenOffice as a service.</li>
@ -538,48 +508,82 @@ on the same topic.
to untar. Target directory can be C:/Program Files/Red5/webapps/ .
Linux with Nautilus or through a shell : cp dokeos-red5APP-1.8/*
/usr/lib/red5/webapps</li>
<li>Edit the RED5 settings to fit with your firewall requirements in terms of open ports if there is a limitation.&nbsp;</li><li>Configure Red5.</li><ul><li>Edit /usr/lib/red5/conf/red5.properties</li><li>Edit /usr/lib/red5/conf/realm.properties and change the default administrator password.</li></ul></ul><h4>More informations on RED5</h4>Please take a look on this page : <a href="http://www.dokeos.com/wiki/index.php/Installing_videoconference">http://www.dokeos.com/wiki/index.php/Installing_videoconference</a><br><br><h4>Configuration of your dokeos Videoconference plugin</h4>The
configuration of the VideoServing is done via the admin pages of Dokeos
<li>Edit the RED5 settings to fit with your firewall requirements in terms of open ports if there is a limitation.&nbsp;</li>
<li>Configure Red5.
<ul>
<li>Edit /usr/lib/red5/conf/red5.properties</li>
<li>Edit /usr/lib/red5/conf/realm.properties and change the default administrator password.</li>
</ul>
</li>
</ul>
<h4>More informations on RED5</h4>
Please take a look on this page : <a href="http://www.dokeos.com/wiki/index.php/Installing_videoconference">http://www.dokeos.com/wiki/index.php/Installing_videoconference</a><br /><br />
<h4>Configuration of your dokeos Videoconference plugin</h4>
The configuration of the VideoServing is done via the admin pages of Dokeos
configuration in Dokeos platform admin, Configure the services,
Configure Visio-conference<br />This contains the URL to the video
conferencing application. You probably need to add something before
these paths if Dokeos is not installed into the root of your webserver.<br>url:/main/webrooms/videoconference.html and <br>&nbsp;&nbsp;&nbsp;&nbsp; /main/webrooms/videoconference2.html<br><br><h4>Connect your Dokeos installation to RED5</h4>You
should tell Dokeos the configuration of you red5 server. This is done
Configure Visio-conference<br />
This contains the URL to the video conferencing application.
You probably need to add something before these paths if Dokeos is not
installed into the root of your webserver.<br />
url:/main/webrooms/videoconference.html and <br />
&nbsp;&nbsp;&nbsp;&nbsp; /main/webrooms/videoconference2.html<br /><br />
<h4>Connect your Dokeos installation to RED5</h4>
You should tell Dokeos the configuration of you red5 server. This is done
using the administration page of Dokeos. In the first field below the
two url, set the public ip of your red5 server. The second field <br />will
contain the value of <i>&nbsp;rtmp.port&nbsp;</i> from you red5
two url, set the public ip of your red5 server. The second field <br />
will contain the value of <i>&nbsp;rtmp.port&nbsp;</i> from you red5
configuration and the last field will contains <i>&nbsp;rtmpt.port&nbsp;</i>
value.<span style="font-style: italic;"><br /><br /></span>
value.<br /><br />
<hr style="width: 100%; height: 2px;" />
<h2><a name="9._Mathematical_formulas"></a>9. Mathematical formulas with LaTeX</h2>
You can enable mathematical equations writing inside the Dokeos online editor (FCKEditor) by applying the following steps:
<ul>
<li>1. Configure your Apache installation to make the <i>dokeos/main/inc/lib/mimetex/</i> directory an authorized cgi-bin directory*</li>
<li>1. Configure your Apache installation to add a cgi-bin directory that contains a symbolic link to the mimetex.cgi in <i>dokeos/main/inc/lib/mimetex/</i>(*see below)</li>
<li>2. Reload your Apache configuration</li>
<li>3. Edit the <i>dokeos/main/inc/lib/fckeditor/myconfig.js</i> and
<ul>
<li>3.1. Add <b>FCKConfig.Plugins.Add("mimetex", "en", sOtherPluginPath ) ;</b> at the end of the file</li>
<li>3.2. Add <b>'mimetex'</b> at the end of the FCKConfig.ToolbarSets lines where you want the LaTeX icon to appear (there is one FCKConfig.ToolbarSets by tool). For example:
<table style="text-align: left; width: 100%;" border="1" cellpadding="10" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; background-color: rgb(229, 229, 229);">
<small>FCKConfig.ToolbarSets["Test"] = [<br />
<div class="code">FCKConfig.ToolbarSets["Test"] = [<br />
&nbsp;&nbsp;['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link','ImageManager','MP3','OrderedList','UnorderedList','Table','mimetex']<br />
] ;</small></td></tr></tbody></table>
] ;</div>
You can add it to all the tools, or only to the document and tests tools, for example<br /><br />
</li>
</ul>
</li>
<li>4. For Windows servers only, update <i>dokeos/main/inc/lib/fckeditor/editor/plugins/mimetex/mimetex.html</i> to replace <b>mimetex.cgi</b> by <b>mimetex.exe</b></li>
<li>5. Clear your browser's cache to test it (very important). This can be done using your browser's settings page</li>
</ul>
This procedure should make a new icon available in your Dokeos online editor, which will make it possible to insert mathematical formulas into your documents.
<br><br></span><hr>
<i>Adding the corresponding cgi-bin directory to your Apache configuration could be done, in Apache 2, like this:</i>
<div class="code">
ScriptAlias /cgi-bin/ /var/www/cgi-bin/<br />
&lt;Directory "/var/www/cgi-bin"&gt;<br />
&nbsp;&nbsp;AllowOverride None<br />
&nbsp;&nbsp;Options ExecCGI -MultiViews +SymLinksIfOwnerMatch<br />
&nbsp;&nbsp;Order allow,deny<br />
&nbsp;&nbsp;Allow from all<br />
&lt;/Directory&gt;<br />
</div>
<i>Adding a symbolic link can be done, under Windows, by creating a shortcut to the mimetex.exe file from the cgi-bin directory, or under Linux by issuing the following command:</i>
<div class="code">ln -s /var/www/dokeos/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi</div>
This procedure should make a new icon available in your Dokeos online editor, which will make it possible to insert mathematical formulas into your documents.<br /><br />
<br /><br /><hr/>
<a href="http://validator.w3.org/check?uri=referer"><img
src="http://www.w3.org/Icons/valid-xhtml10-blue"
alt="Valid XHTML 1.0 Transitional" height="31" width="88" style="float: right; margin: 1em;" /></a>
<a href="http://jigsaw.w3.org/css-validator/">
<img src="http://jigsaw.w3.org/css-validator/images/vcss-blue" style="float: right; margin: 1em;"
alt="Valid CSS" />
</a>
Contact address: Dokeos, Rue du Corbeau, 108, B-1030 Brussels, Belgium<br />
Mail: info@dokeos.com<br />
Tel. +32 (0)2 669 69 55
Tel. +32 (0)2 669 69 55<br /><br />
<hr />
</div>
</div>

Loading…
Cancel
Save