Adding mimetex documentation see BT#2980

documentation/installation_guide.html

@@ -616,6 +616,7 @@ You can enable mathematical equations writing inside the Chamilo online editor (
     <li>1. Configure your Apache installation to add a cgi-bin directory that contains a symbolic link to the mimetex.cgi in <i>chamilo/main/inc/lib/mimetex/</i> (*see below, step 4)</li>
     <li>2. Reload your Apache configuration</li>
     <li>3. Edit the online editor's configuration file <i>chamilo/main/inc/lib/fckeditor/myconfig.php</i> and</li>
+    <ul>
     <li>3.1. Enable the mimetex plugin, find the line //$config['LoadPlugin'][] = 'mimetex'; and modify it to be: <b>$config['LoadPlugin'][] = 'mimetex';</b> (remove the double slash)</li>
     <li>3.2. The additional settings <b>$config['MimetexExecutableInstalled']</b> , <b>$config['MimetexExecutableDetectionMethod']</b>
 and <b>$config['MimetexExecutableDetectionTimeout']</b> are configured for best probability of automatic detection of the installed on the server file <i>mimetex.cgi</i> or <i>mimetex.exe</i>.
@@ -627,13 +628,9 @@ Here is an example:
     <div class="code">$config['ToolbarSets']['Normal'] = array(<br /> &nbsp;&nbsp;array('FitWindow','Bold','Image','Link','PasteWord','MP3',<b>'mimetex'</b>,'Table','Subscript','Superscript','ShowBlocks')<br />);</div>
     The item <b>'mimetex'</b> represents the button, you may add it to or remove it from any toolbar.<br /><br />
     </li>
-    <li>4. To install mimetex executable file, make these changes:</li>
     </ul>
-
+    <li>4. To install mimetex executable file, make these changes:
-
+		<p>Add the corresponding cgi-bin directory to your Apache configuration could be done, in Apache 2, like this:</p>
-<p>Add the corresponding cgi-bin directory to your Apache configuration could be done, in Apache 2, like this:
-
-    </p>
 		<div class="code">
 		      ScriptAlias /cgi-bin/ /var/www/cgi-bin/<br />
 		&lt;Directory "/var/www/cgi-bin"&gt;<br />
@@ -647,20 +644,31 @@ Here is an example:
 		
 		<p>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:
+		  Linux by issuing the following command:</p>
-
-</p>
 		<div class="code">
 		  <p>ln -s /var/www/chamilo/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi</p>
 		</div>
 		<p>If you are reluctant to modify your Apache configuration, alternately you may do at step 4 the following:
 		copy mimetex.exe (for windows) or mimetex.cgi (for linux) from <i>chamilo/main/inc/lib/mimetex/</i> directory to your <i>cgi-bin/</i></p>
-<ul>
+
+    </li>
+
+	
 	<li>5. Make sure that the file mimetex.cgi (or mimetex.exe) has right to be executed by the web-server process. For example, on a Ubuntu Linux system you may write a command like the following:
 	    <div class="code">
 	        sudo chmod a+x mimetex.cgi
 	    </div>
 	</li>
+	<li>6. Make sure that the file mimetex.cgi (or mimetex.exe) has been uploaded in <b>BINARY</b> format.
+	
+	       This is another common problem; the fix is just to re-upload the file in ASCII format. 
+	       You'll need to consult your FTP program's documentation to figure out how to switch modes.
+           BINARY mode is used for non-text items, such as executables (*.exe), zip files (*.zip), image files (*.jpg, *.gif) and the like. 
+           ASCII mode needs to be used for text only documents, which includes *.txt, *.cgi, *.pl *.css, *.html, etc.
+           <br />
+           You can also try to re upload the mimetex file using the "Upload file" in the "Filemanager" tool in CPanel/Plesk 
+    </li>
+    
 </ul>
 
 <p>As a result of this procedure, a new button becomes available in your Chamilo online editor, that gives you possibility

documentation/installation_guide_es_ES.html

@@ -685,9 +685,7 @@ Usted puede habilitar la escritura de ecuaciones matemáticas dentro del editor
 	<li>3. Editar <i>chamilo/main/inc/lib/fckeditor/myconfig.js</i> y
 
 	    <ul>
-
 	        <li>3.1. Agregar <b>FCKConfig.Plugins.Add("mimetex", "en", sOtherPluginPath ) ;</b> al final del archivo</li>
-
 			<li>3.2. Agregar <b>'mimetex'</b> al final de las lineas
 	FCKConfig.ToolbarSets donde usted desee que el icono de LaTeX aparezca
 	(existe un FCKConfig.ToolbarSets por herramienta). Por ejemplo:
@@ -703,11 +701,8 @@ FCKConfig.ToolbarSets donde usted desee que el icono de LaTeX aparezca
     </li>
 
 	<li>4. En raras ocasiones puede ser necesario realizar ajustes manuales editando el fichero /chamilo/main/inc/lib/fckeditor/fckeditor.php</li>
-
 	<li>5. Limpiar la cache de su navegador para probarlo (muy importante). Esto se puede hacer mediante el uso de la página de configuraciones de su navegador</li>
-
+    <li>6. Realice estos cambios:
-    <li>6. Realice estos cambios:</li>
-</ul>
 
 	<i>Agregar el directorio cgi-bin correspondiente a su configuración de Apache puede ser realizada de esta manera, en Apache 2:</i>
 	
@@ -736,6 +731,12 @@ Linux usando el siguiente comando:</i>
 	<div class="code">ln -s /var/www/chamilo/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi</div>
 	<p>Si no quiere modificar su Apache, alternativamente a  este punto 6: copie mimetex.exe (para Windows) o mimetex.cgi (para Linux) en su cgi-bin/ </p>
 	<p>&nbsp;</p>
+	</li>
+	
+	<li>7. Asegurarse que el archivo mimetex.cgi (o mimetex.exe) ha sido subido al servidor usando el formato BINARY. Es posible que el servidor de un error 500 cuando se intenta entrar a cgi-bin/mimetex.cgi a pesar de que los permisos están correctos.
+	   Probar volviendo a subir el archivo usando FTP (ASCII format) o si no usando el "administrador de archivos" o CPanel. Si el error persiste contactar con el administrador del servidor para habilitar el acceso público del archivo cgi-bin/mimetex.cgi.
+	</li>
+</ul>
 <p>Este procedimiento creará un nuevo icono en su editor en línea de Chamilo, el cual hará posible la inserción de fórmulas matemáticas en sus documentos.</p>
 <hr style="width: 100%; height: 2px;" />
 <h2><a name="8._ASCIIMathML_mathematical_formulas"></a>8. Fórmulas matemáticas con ASCIIMathML</h2>