123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777 |
- <!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>
-
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Dokeos 1.8.6 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" />
-
- <style type="text/css">
- <!--
- page { width: 21cm; height: 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>
- <div id="header1">
- <h1>Dokeos 1.8.6 Installation Guide</h1>
- </div>
- <a href="index.html">Documentation</a> > Installation Guide
- <div id="outerframe">
- <div id="main">
- <p></p>
- <p>Thank you for downloading Dokeos, the open source learning suite.</p>
- <ul>
- <li>Quick preview of <a href="http://www.dokeos.com/en/node/58">Dokeos features </a></li>
- <li>Test Dokeos on <a href="http://campus.dokeos.com">Free Campus</a></li>
- </ul>
- <p>This guide explains how to install Dokeos Learning
- Management. It explains how to install Dokeos Oogie
- PowerPoint conversion and Dokeos Videoconferencing although these
- packages are not required to use Dokeos LMS. Please read this fully before proceeding with the installation. You can also find a Spanish translation of this guide <a href="./installation_guide_es_ES.html">here</a>.</p>
- If you want to save time, trouble and money, you can alternatively have your Dokeos portal <a href="http://www.dokeos.com/en/node/6">deployed</a> or <a href="http://www.dokeos.com/en/node/32">installed</a> by the Dokeos compant or one of its partners.<br />
- <h2><b>Contents</b></h2>
- <ol>
- <li><a href="#1._Pre-requisites">Pre-requisites</a></li>
- <li><a href="#2._Installation_of_Dokeos_LMS">Installation of Dokeos LMS</a></li>
- <li><a href="#3._Upgrade_from_a_previous_version_of">Upgrade from a previous version of Dokeos</a></li>
- <li><a href="#4._Troubleshooting">Troubleshooting</a></li>
- <li><a href="#5._Administration_section">Administration section</a></li>
- <li><a href="#6._LDAP">LDAP </a></li>
-
- <li><a href="#7._Mathematical_formulas">Mathematical formulas with LaTeX</a></li>
- </ol>
- <br />
- <hr style="width: 100%; height: 2px;" />
- <h2><a name="1._Pre-requisites"></a>1. Pre-requisites</h2>
- Dokeos
- can be installed on Windows, Linux, Mac OS X and UNIX servers
- indifferently. However, we recommend the use of Linux server for
- optimal flexibility, remote control and scalability. <br />
- <br />
- Dokeos is mainly a LMS running <span style="font-weight: bold;">Apache</span>, <span style="font-weight: bold;">MySQL</span> and <span style="font-weight: bold;">PHP5</span> (the so called <span style="font-weight: bold;">AMP</span> trilogy). <br />
- <br />
- It can be enriched with PowerPoint conversion (feature called Dokeos
- Oogie) using <span style="font-weight: bold;">OpenOffice</span> + Java. You may also want to add the Dokeos Videoconferencing plugin using the <span style="font-weight: bold;">RED5</span> Open
- Source Flash server. <br />
- <br />
- All these software are open source and freely available. <br />
- <br />
- To run Dokeos <span style="font-weight: bold;">LMS</span> on your server, you need to install WAMP, LAMP or MAMP:
- <ul>
- <li>To install <span style="font-weight: bold;">WAMP</span> (AMP on Windows), we recommend the <a href="http://www.apachefriends.org/en/xampp.html">XAMPP</a> .exe installer<a href="http://www.apachefriends.org/en/xampp.html"></a></li>
- <li>To install <span style="font-weight: bold;">LAMP</span>
- (AMP on Linux), use the Package manager of your favourite distribution (Synaptic, RPMFinder etc.).
- For instance, on a Ubuntu server, use Shell or Synaptic following the
- <a href="http://ubuntuguide.org/wiki/Ubuntu:Feisty#Apache_HTTP_Server">Ubuntuguide on Apache</a> and the following sections</li>
- <li>To install <span style="font-weight: bold;">MAMP</span> (AMP on Mac OS X), refer to the <a href="http://www.mamp.info/en/index.php">MAMP</a> dedicated website<a href="http://www.mamp.info/en/index.php"></a></li>
- </ul>
- <br />
- <h3><span style="font-weight: bold;">MySQL database server</span></h3>
- You will need a login and password allowing to administrate and create
- at least one database. By default, Dokeos will create a new database
- for each course created. It means your host should allow you to create
- and administrate several databases. You can also install Dokeos using
- only one database, in that case you have to select this option during
- the installation.
- <br />
- <br />
- To take advantage of <span style="font-weight: bold;">Oogie</span> PowerPoint / Impress conversion, you need : <br />
- <ul>
- <li><a href="http://www.openoffice.org/">OpenOffice</a><a href="http://www.openoffice.org/"></a></li>
- <li><a href="http://www.java.com/en/download/manual.jsp">Java Runtime Environment</a><a href="../*%20http://www.java.com/en/download/manual.jsp"></a></li>
- </ul>
- <br />
- To take advantage of Dokeos <span style="font-weight: bold;">Videoconferencing</span>, you need :<br />
- <ul>
- <li><a href="http://osflash.org/red5">RED5 Open Source Flash Server</a><a href="http://osflash.org/red5"></a></li>
- </ul>
- <span style="font-weight: bold;"><br />
- </span>
- <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>
- <li><a href="http://www.dokeos.com/node/33">Download Dokeos LMS</a></li>
- <li>Unzip it</li>
- <li>Copy the dokeos directory in your Apache web directory. This can be
- <span style="font-weight: bold;">C:\xampp\htdocs\</span> on a Windows server or <span style="font-weight: bold;">/var/www/html/</span> on a Linux server</li>
- <li>Open your web browser (Internet Explorer, Firefox...) and type
- <span style="font-weight: bold;">http://localhost/dokeos/</span> if you install locally or
- <span style="font-weight: bold;">http://www.domain.com/dokeos/</span> if you install remotely</li>
- <li>Follow the web installation process. You can accept all default
- values. Consider changing the admin password to remember it. </li>
- </ul>
- <br />
- The following directories need to be readable, writeable and executable for everyone:
- <ul>
- <li>dokeos/main/inc/conf/</li>
- <li>dokeos/main/garbage/</li>
- <li>dokeos/main/upload/users/</li>
- <li>dokeos/main/default_course_document/</li>
- <li>dokeos/archive/</li>
- <li>dokeos/courses/</li>
- <li>dokeos/home/</li>
- </ul>
- (where 'dokeos' is the directory in which you installed Dokeos)
- <p>On Linux, Mac OS X and BSD operating systems you can use the CHMOD
- 777 command for this (although we recommend you seek advice from an
- experienced system administrator).
- In Windows, you may need to check the properties of the folders (by
- right-clicking on them).
- </p>
- <p>
- 2.5. The following files need to be readable and writeable for the web browser,
- only during the installation process:
- </p>
- <ul>
- <li>dokeos/main/inc/conf/configuration.php (if present)</li>
- </ul>
- <p>On Linux, Mac OS X and BSD operating systems you can use the CHMOD
- 666 command for this (although we recommend you seek advice from an
- experienced system administrator).
- In Windows, you may need to check the properties of the files and
- folders (by right-clicking on them).
- </p>
- <p>
- <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
- for MySQL should probably remain empty.</p>
- <p></p>
- <h3><strong> Configuration and security after installation</strong></h3>
- <ul>
- <li><strong>Protect your configuration file: </strong>
- make sure no one can overwrite it. You can find the config file in <em>(dokeos folder)</em>/main/inc/conf/configuration.php.
- Make it read-only (windows/xwindows: right-click the file to edit the
- properties. linux/bsd/macosx: use the chmod 444 command). The config
- file is created by Apache so you may need to be root user to change its
- permissions.</li>
- <li><strong>Protect your installation folder: </strong>
- if the <em>(dokeos folder)</em>/main/install
- folder is still accessible, someone could install over your existing
- version (you could lose your data that way). Move the folder somewhere
- out of the web directories so it is not accessible, change its name, or
- edit its properties so no one can read or execute it.</li>
- <li><strong>For better security: </strong>
- making the files world-writable will help you install, and solves many
- issues for people without much admin experience. However, it's better
- security to make the owner of the apache process (often called apache
- or www-data) also owner of all the dokeos files and folders. Ths way,
- these files need only be readable and writable by the Apache process
- owner, not by the entire world.</li>
- <li><strong>Configure your Dokeos installation: </strong>
- in the administration section of Dokeos, you can use the Dokeos Config Settings to adjust the behavior of your installation.</li>
- <li><strong>Configure Dokeos mail: </strong>
- most of Dokeos uses the mail settings from the php.ini file. However,
- the announcements tool uses phpMailer (another free software project)
- and the settings for this tool can be adjusted in <em>(dokeos folder)</em>/main/inc/conf/mail.conf.php.</li>
- </ul>
- <br />
- <h3>PHP configuration</h3>
- To get the best of Dokeos, you need to finetune PHP settings. Consider : <br />
- <ul>
- <li>Editing php.ini file (on windows can be located at <span style="font-weight: bold;">C:\xampp\php\php.ini</span>, on Ubuntu Linux : <span style="font-weight: bold;">/etc/php5/apache2/php.ini</span></li>
- <li>search the word "max" and increase values to optimise the server</li>
- <li>you may want to end up with the following values : </li>
- </ul>
- <br />
- <div class="code">
- max_execution_time = 300 ; 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 ; Maximum amount of memory a script may consume (128MB)<br />
- post_max_size = 64M<br />
- upload_max_filesize = 100M
- </div>
- <br />
- <p>
- Some users could meet problems if their PHP settings don't fit
- these ones:</p>
- <ul>
- <li>short_open_tag = On</li>
- <li>safe_mode = Off</li>
- <li>magic_quotes_gpc = On</li>
- <li>magic_quotes_runtime = Off</li>
- </ul>
- <p>
- Past Dokeos versions required register_globals to be set to On. This is
- no longer necessary, this can be set to Off and Dokeos will work fine.
- </p>
- <p><strong>BSD users:</strong> these php libraries have to be included during php installation:</p>
- <ul>
- <li>php-mysql The mysql shared extension for php</li>
- <li>php-pcre The pcre shared extension for php</li>
- <li>php-session The session shared extension for php</li>
- <li>php-zlib The zlib shared extension for php</li>
- <li>(optional) php-ldap if you want to be able to use LDAP authentication</li>
- </ul>
- <p><a href="http://dev.mysql.com/doc/mysql/en/index.html"></a><br />
- </p>
- <hr />
- <h2><a name="3._Upgrade_from_a_previous_version_of"></a>3. Upgrade from a previous version of Dokeos</h2>
- Before upgrading we <b>heavily</b> recommend you do a full backup of the previous
- Dokeos directories and databases. If you are unsure how to achieve this
- please ask your hosting provider for advice.<br />
- <p></p>
- <h3>3.1 Upgrading from Dokeos 1.8.x</h3>
- <em>If you upgrade from Dokeos 1.8.x</em> :
- <ul>
- <li> check that you haven't left any customised stylesheet or image*</li>
- <li> download the Dokeos 1.8.6 install package from the <a href="http://www.dokeos.com/en/node/33">Dokeos download page</a></li>
- <li> unzip the new files of Dokeos 1.8.6 over the files of the older version</li>
- <li> point your browser on your portal URL + main/install/</li>
- <li> choose your language and click <span style="font-style: italic;">Upgrade from 1.8.x</span></li>
- </ul>
- <br />
- <font size="-1">* Styles and images are located in the main/css or main/img
- directories. You can still recover them from your backup if you have made it.
- Any modified style or image that uses the default style/image name will be
- overwritten by the next step. To avoid loosing your customisations, always
- ensure you copy the styles/images under a new name and use and modify the
- copy, not the original. The original will always be overwritten by newer
- versions. In Dokeos 1.8.5, we have changed the name of several CSS themes.
- Backwards compatibility is ensured by the fact that an upgrade only adds the
- new themes, but you should try and use these new themes rather than sticking
- to the old ones which will be deprecated shortly (not maintained).</font>
- <br />
- <p></p>
- <h3>3.2 Upgrading from Dokeos 1.6.x</h3>
- <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 "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:
- <ul>
- <li> move the current Dokeos directory contents to a subdirectory called
- <em>old_version</em> and make it writeable by the web server. This
- is important to allow the move of the courses/ and upload/ directories
- to the new install</li>
- <li> download the Dokeos 1.8.6 install package from the
- <a href="http://www.dokeos.com/en/node/33">Dokeos download page</a></li>
- <li> unzip the new files of Dokeos 1.8.6 in the main Dokeos directory. The
- new directory <em>main</em> should be located directly inside your
- Dokeos root folder</li>
- <li> point your browser on your portal URL</li>
- <li> choose your language and click <span style="font-style: italic;">Upgrade from 1.6.x</span> and confirm the
- current directory of the old version</li>
- </ul>
- <br />
- <em> NOTE: </em> The upgrade from 1.6.x to 1.8.x implies a revision of
- the customised graphics and styles. The new version uses a complete new
- set of icons and styles, which means the ones from version 1.6 cannot be
- simply reused. The good news is the version 1.8.x allows you to create
- your own style in a separate css folder, that you can then reuse through
- all the 1.8.x versions
- <br />
- <p></p>
- <p>
- <b>WARNING:</b><br />
- Do not delete the previous Dokeos installation directory before installing
- the new one. When the update is successfully finished, you can remove
- the old path.
- </p>
- <p>
- <b>NOTE:</b><br />
- Do not modify the home_*.html files directly. Instead,
- choose "Configure the homepage" in the Dokeos administration section.
- </p>
- <p>
- </p>
- <h3>3.3 In both cases</h3>
- The following directories need to be readable, writeable and executable for the web server:
- <ul>
- <li>dokeos/main/inc/conf/</li>
- <li>dokeos/main/garbage/</li>
- <li>dokeos/main/upload/users/</li>
- <li>dokeos/main/default_course_document/</li>
- <li>dokeos/archive/</li>
- <li>dokeos/courses/</li>
- <li>dokeos/home/</li>
- </ul>
- On Linux, Mac OS X and BSD operating systems you can quick-fix this using the
- CHMOD 777 command, but if you are unsure, we recommend you seek advice for
- your own OS on <a href="http://www.dokeos.com/en/node/66">our forum</a>.
- In Windows, you may need to check the properties of the folders.
- <p>
- </p>
- <h3>3.4 Quick-upgrade from 1.6.x guide for Linux</h3>
- The following quick-upgrade guide assumes that:
- <ul>
- <li>the Dokeos database username (for MySQL) is "dokeos_db_user" and your login is "dokeos_user"</li>
- <li>the Dokeos installation is currently in /var/www/dokeos/ and it has 777 permissions</li>
- <li>your portal's URL is http://www.portalurl.com/</li>
- </ul>
- <br />
- On the command-line, type:
- <ul>
- <li>cd /tmp</li>
- <li>mysqldump -u dokeos_db_user -p --all-databases --result-file=/home/dokeos_user/dokeos_old.sql</li>
- <li>cp -ra /var/www/dokeos /home/dokeos_user/backup_dokeos</li>
- <li>mkdir /var/www/dokeos/old_version</li>
- <li>mv /var/www/dokeos/* /var/www/dokeos/old_version/</li>
- <li>chmod -R 0777 /var/www/dokeos/old_version/</li>
- <li>wget http://www.dokeos.com/download/dokeos-1.8.6.tar.gz</li>
- <li>tar zxvf dokeos-1.8.6.tar.gz</li>
- <li>sudo cp -ra dokeos-1.8.6/* /var/www/dokeos/</li>
- <li>rm dokeos-1.8.6.tar.gz</li>
- <li>sudo rm -r dokeos-1.8.6/</li>
- </ul>
- <br />
- Then:
- <ul>
- <li>Direct your browser to http://www.portalurl.com/main/install/</li>
- <li>Proceed with the installation</li>
- <li>Review the directories permissions</li>
- </ul>
- <p></p>
- <p></p>
- <hr style="width: 100%; height: 2px;" />
- <h2><a name="4._Troubleshooting"></a>4. Troubleshooting</h2>
- <p>If you have problems, go to the <a href="http://www.dokeos.com">Dokeos website</a> and ask a question on the
- <a href="http://www.dokeos.com/en/node/66">support forum</a>. Please read the previous messages first to see if there is
- already an answer to your question. We also maintain a list of
- <a href="http://www.dokeos.com/wiki/index.php/FAQ">Frequently Asked Questions</a>.
- </p>
- <h2></h2>
- <hr style="width: 100%; height: 2px;" />
- <h2><a name="5._Administration_section"></a>5. Administration section</h2>
- <p>To access the Dokeos administration section, open browser,
- 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. </p>
- <p>
- </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 />
- An LDAP module is already provided in Dokeos, but it has to be configured to make it work.
- </p>
- <h3><b>Compiling</b></h3>
- <p>
- Linux servers: It's possible that you have to recompile php with ldap support.
- Newer distributions also allow downloading rpms for additional packages.
- </p>
- <h3><b>Activating LDAP in Dokeos</b></h3>
- <p>
- In (dokeos folder)/main/inc/conf/configuration.php, around line 90, you see<br />
- //for new login module<br />
- //uncomment these to activate ldap<br />
- //$extAuthSource['ldap']['login'] = "./main/auth/ldap/login.php";<br />
- //$extAuthSource['ldap']['newUser'] = "./main/auth/ldap/newUser.php";<br />
- <br />
- remove the // from the last two lines to activate LDAP.<br />
- </p>
- <h3><b>Settings</b></h3>
- <p>
- Ask the LDAP server admin for the settings:
- </p>
- <ul>
- <li>ldap server name</li>
- <li>ldap server port (usually 389)</li>
- <li>ldap dc</li>
- </ul>
- Since 1.8.5, you have to change the LDAP settings inside the "Portal
- administration" panel, under "Dokeos configuration settings", section
- "LDAP".
- <br />
- As an example, you should find the following kind of values:<br />
- LDAP main server's address: "myldapserver.com"; // your ldap server<br />
- LDAP main server's port: 389; // your ldap server's port number<br />
- LDAP domain: "dc=xx, dc=yy, dc=zz"; //domain<br />
- <br />
- <h3><b>Teacher/student status</b></h3>
- <p>
- By default, Dokeos will check if the "employeenumber" field has a value. If it has, then Dokeos will
- consider this user as being a teacher.<br />
- If you want to change this behaviour, you can edit main/auth/ldap/authldap.php, function ldap_put_user_info_locally(),
- and change the <em>if (empty($info_array[$tutor_field]))</em> condition to whatever suits you.<br />
- You can also remove this check by removing the condition and leaving only the <em>$status = STUDENT;</em> line.
- </p>
- <h3><b>Protected LDAP servers</b></h3>
- <p>
- Some LDAP servers do not support anonymous use of the directory services.<br />
- In this case, you should fill in the appropriate fields in the
- administration panel (e.g. "manager" and "mypassword") and Dokeos will
- try to authenticate using these, or fall back to anonymous mode before
- giving up.</p>
- <h3>LDAP import into sessions</h3>
- <p>There is a new set of scripts now that allow you to insert users
- from LDAP directly into a Dokeos session. This, however, relies on a
- set of static choices in the LDAP contact attributes.<br />
- The fields used intensively by the Dokeos module are:<br />
- </p>
- <ul>
- <li>uid, which is matched to the username in Dokeos</li>
- <li>userPassword, which is matched to the user password, although
- this part will only work for non-encrypted passwords for now, but it
- shouldn't be necessary if using the LDAP server as authentication</li>
- <li>ou should end with the year of the person registration or any
- criteria you will use to filter users, so that they can be retrieved on
- that criteria</li>
- <li>sn is used as the lastname field in Dokeos</li>
- <li>givenName is used as the firstname field in Dokeos</li>
- <li>mail is used as the email field in Dokeos</li>
- </ul>
- <hr style="width: 100%; height: 2px;" />
- <h2><a name="7._Mathematical_formulas"></a>7. Mathematical formulas with LaTeX</h2>
-
- <i>This part is optional, only organisations wanting to use mathematical formulas inside the online editor might want to read this.</i><br />
- 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 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:
- <div class="code">FCKConfig.ToolbarSets["Test"] = [<br />
- ['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link','Unlink','ImageManager','MP3','OrderedList','UnorderedList','Table','mimetex']<br />
- ] ;</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>
- <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 />
- <Directory "/var/www/cgi-bin"><br />
- AllowOverride None<br />
- Options ExecCGI -MultiViews +SymLinksIfOwnerMatch<br />
- Order allow,deny<br />
- Allow from all<br />
- </Directory><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 />
- Contact address: Dokeos, Rue du Corbeau, 108, B-1030 Brussels, Belgium<br />
- Mail: info@dokeos.com<br />
- Tel. +32 (0)2 669 69 55<br />
- <br />
- <hr />
- </div>
- </div>
- <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" style="margin: 1em; float: right;" height="31" width="88" /></a>
- <a href="http://jigsaw.w3.org/css-validator/">
- <img src="http://jigsaw.w3.org/css-validator/images/vcss-blue" style="margin: 1em; float: right;" alt="Valid CSS" />
- </a>
- </body>
- </html>
|