Adding mimetex documentation see BT#2980

skala
Julio Montoya 14 years ago
parent e8060a685a
commit 14287eaf46
  1. 70
      documentation/installation_guide.html
  2. 93
      documentation/installation_guide_es_ES.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>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>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> <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.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> <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>. 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,40 +628,47 @@ 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> <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 /> The item <b>'mimetex'</b> represents the button, you may add it to or remove it from any toolbar.<br /><br />
</li> </li>
<li>4. To install mimetex executable file, make these changes:</li> </ul>
</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>
<div class="code">
<p>Add the corresponding cgi-bin directory to your Apache configuration could be done, in Apache 2, like this: ScriptAlias /cgi-bin/ /var/www/cgi-bin/<br />
&lt;Directory "/var/www/cgi-bin"&gt;<br />
</p> &nbsp;&nbsp;AllowOverride None<br />
<div class="code"> &nbsp;&nbsp;Options ExecCGI -MultiViews +SymLinksIfOwnerMatch<br />
ScriptAlias /cgi-bin/ /var/www/cgi-bin/<br /> &nbsp;&nbsp;Order allow,deny<br />
&lt;Directory "/var/www/cgi-bin"&gt;<br /> &nbsp;&nbsp;Allow from all<br />
&nbsp;&nbsp;AllowOverride None<br /> &lt;/Directory&gt;<br />
&nbsp;&nbsp;Options ExecCGI -MultiViews +SymLinksIfOwnerMatch<br /> </div>
&nbsp;&nbsp;Order allow,deny<br />
&nbsp;&nbsp;Allow from all<br />
&lt;/Directory&gt;<br /> <p>Adding a symbolic link can be done, under Windows, by creating a
</div> shortcut to the mimetex.exe file from the cgi-bin directory, or under
Linux by issuing the following command:</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>
<p>Adding a symbolic link can be done, under Windows, by creating a </li>
shortcut to the mimetex.exe file from the cgi-bin directory, or under
Linux by issuing the following command:
</p>
<div class="code"> <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:
<p>ln -s /var/www/chamilo/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi</p> <div class="code">
</div> sudo chmod a+x mimetex.cgi
<p>If you are reluctant to modify your Apache configuration, alternately you may do at step 4 the following: </div>
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> </li>
<ul> <li>6. Make sure that the file mimetex.cgi (or mimetex.exe) has been uploaded in <b>BINARY</b> format.
<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"> This is another common problem; the fix is just to re-upload the file in ASCII format.
sudo chmod a+x mimetex.cgi You'll need to consult your FTP program's documentation to figure out how to switch modes.
</div> 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> </li>
</ul> </ul>
<p>As a result of this procedure, a new button becomes available in your Chamilo online editor, that gives you possibility <p>As a result of this procedure, a new button becomes available in your Chamilo online editor, that gives you possibility

@ -684,58 +684,59 @@ 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 <li>3. Editar <i>chamilo/main/inc/lib/fckeditor/myconfig.js</i> y
<ul> <ul>
<li>3.1. Agregar <b>FCKConfig.Plugins.Add("mimetex", "en", sOtherPluginPath ) ;</b> al final del archivo</li>
<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 <li>3.2. Agregar <b>'mimetex'</b> al final de las lineas
FCKConfig.ToolbarSets donde usted desee que el icono de LaTeX aparezca FCKConfig.ToolbarSets donde usted desee que el icono de LaTeX aparezca
(existe un FCKConfig.ToolbarSets por herramienta). Por ejemplo: (existe un FCKConfig.ToolbarSets por herramienta). Por ejemplo:
<div class="code">FCKConfig.ToolbarSets["Test"] = [<br /> <div class="code">FCKConfig.ToolbarSets["Test"] = [<br />
['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link','Unlink','ImageManager','MP3','OrderedList','UnorderedList','Table','mimetex']<br /> ['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link','Unlink','ImageManager','MP3','OrderedList','UnorderedList','Table','mimetex']<br />
] ;</div> ] ;</div>
Usted puede agregarlo a todas las herramientas, o sólo a alguna de ellas (por ej., documentos y ejercicios)<br /> Usted puede agregarlo a todas las herramientas, o sólo a alguna de ellas (por ej., documentos y ejercicios)<br />
<br /> <br />
</li> </li>
</ul> </ul>
</li> </li>
<li>4. En raras ocasiones puede ser necesario realizar ajustes manuales editando el fichero /chamilo/main/inc/lib/fckeditor/fckeditor.php</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>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>
<i>Agregar el directorio cgi-bin correspondiente a su configuración de Apache puede ser realizada de esta manera, en Apache 2:</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>Agregar un enlace simbólico bajo Windows, puede ser realizado mediante la creación de un
acceso directo al archivo mimetex.exe desde el directorio cgi-bin, o bajo
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> </ul>
<i>Agregar el directorio cgi-bin correspondiente a su configuración de Apache puede ser realizada de esta manera, en Apache 2:</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>Agregar un enlace simbólico bajo Windows, puede ser realizado mediante la creación de un
acceso directo al archivo mimetex.exe desde el directorio cgi-bin, o bajo
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>
<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> <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;" /> <hr style="width: 100%; height: 2px;" />
<h2><a name="8._ASCIIMathML_mathematical_formulas"></a>8. Fórmulas matemáticas con ASCIIMathML</h2> <h2><a name="8._ASCIIMathML_mathematical_formulas"></a>8. Fórmulas matemáticas con ASCIIMathML</h2>

Loading…
Cancel
Save