Dotclear

Changeset 1711


Ignore:
Timestamp:
10/25/09 10:54:24 (13 years ago)
Author:
kozlika
Message:

latexrender: typo.

Location:
plugins/latexrender/doc
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • plugins/latexrender/doc/LISEZMOI.html

    r1545 r1711  
    88</head> 
    99<body> 
    10 <p>Le plugin LaTeXrender est une extension destinée à permettre à un serveur web hébergeant une installation de Dotclear 2 et une installation de [tex]\LaTeX[/tex] (un traitement de texte dont un des points forts est la représentation des mathématiques et très utilisé pour publier dans le domaine de la recherche scientifique) d'afficher (sous forme d'image) des morceaux de texte composés en [tex]\LaTeX[/tex]. Il est livré avec une zone de réglages pour choisir les chemins ses programmes auxiliaires.</p> 
    11 <p>Ce plugin est d'une part une conversion d'une classe déjà existante (la classe <a hreflang="en" href="http://www.mayer.dial.pipex.com/tex.htm">latexrender</a>, écrite en PHP pour un tas de supports); d'autre part, j'ai simplifié la classe (un bon nombre de choses sont complètement simplifiables dans le cadre restreint de Dotclear 2) mais aussi amélioré l'algorithme de choix de décalage vertical (lui-même ajouté par Mike Boyle) et introduit une gestion des couleurs (des gens utilisent des fonds sombres, et les équations en noir sur noir ou en noir sur bleu nuit, ce n'est pas très lisible).</p> 
     10<p>Le plugin LaTeXrender est une extension destinée à permettre à un serveur web hébergeant une installation de Dotclear 2 et une installation de [tex]\LaTeX[/tex] (un traitement de texte dont un des points forts est la représentation des mathématiques et très utilisé pour publier dans le domaine de la recherche scientifique) d'afficher (sous forme d'image) des morceaux de texte composés en [tex]\LaTeX[/tex]. Il est livré avec une zone de réglages pour choisir les chemins de ses programmes auxiliaires.</p> 
     11<p>Ce plugin est d'une part une conversion d'une classe déjà existante (la classe <a hreflang="en" href="http://www.mayer.dial.pipex.com/tex.htm">latexrender</a>, écrite en PHP pour un tas de supports), d'autre part, j'ai simplifié la classe (un bon nombre de choses sont complètement simplifiables dans le cadre restreint de Dotclear 2) mais aussi amélioré l'algorithme de choix de décalage vertical (lui-même ajouté par Mike Boyle) et introduit une gestion des couleurs (des gens utilisent des fonds sombres, et les équations en noir sur noir ou en noir sur bleu nuit, ce n'est pas très lisible).</p> 
    1212<hr class="separator" /> 
    1313<p class="pluginlocation">La page de maintenance de cette extension est à cette adresse : <a href="/post/latexrender">http://jean-christophe.dubacq.fr/post/latexrender</a>.</p> 
     
    1717Paramètres en tant que <strong>super-administrateur</strong>, et 
    1818remplissez les chemins d'accès aux divers exécutables ([tex]\LaTeX[/tex] 
    19 et la suite ImageMagick; les valeurs par défauts doivent être 
     19et la suite ImageMagick&nbsp;; les valeurs par défaut doivent être 
    2020suffisantes pour la plupart des installations) ainsi que quelques 
    2121paramètres supplémentaires (dans le menu Extensions). Les paramètres 
    22 doivent être évidents ; si ce n'est pas le cas, soumettez un rapport de 
     22doivent être évidents&nbsp;; si ce n'est pas le cas, soumettez un rapport de 
    2323bug.</p> 
    2424<div class="photo"><a href="/public/photos/dotclear/latexrender-admin.png"><img src="/public/photos/dotclear/.latexrender-admin_m.jpg" alt="Interface d'administration de LaTeXrender" title="Interface d'administration de LaTeXrender" /></a><div class="legende">Interface d'administration de LaTeXrender</div></div> 
     
    3333les plateformes d'hébergement spécifiques doivent pouvoir le fournir 
    3434sans beaucoup d'efforts (entreprise, laboratoire, particulier 
    35 auto-hébergé) : ce sont des logiciels extrêmement courants sous Linux.</p> 
     35auto-hébergé)&nbsp;: ce sont des logiciels extrêmement courants sous Linux.</p> 
    3636<p>Il faut pour que cette extension fonctionne utiliser l'extension <a href="/post/stacker">stacker</a>. Une 
    3737solution sans cette extension est à l'étude, mais elle sera forcément 
    3838incompatible avec plusieurs autres extensions qui redéfinissent l'accès 
    39 au contenu des billets (note: comme l'auteur en utilise plusieurs, il 
    40 considère ceci comme un bug).</p> 
     39au contenu des billets (note&nbsp;: comme l'auteur en utilise plusieurs, il 
     40considère cela comme un bug).</p> 
    4141<p class="version">La version courante de cette extension est 0.9.3 (local svn  400).</p><p class="licence">Cette extension est sous la licence <a href="http://www.gnu.org/licenses/lgpl-2.1.html" hreflang="en">GPL version 2.0</a>.</p> 
    4242<h3>Utilisation</h3> 
    4343<h4>Utilisation basique</h4> 
    44 <p>L'utilisation en est souple, il suffit de taper son texte 
     44<p>L'utilisation est souple, il suffit de taper son texte 
    4545[tex]\LaTeX[/tex] entre deux 
    4646pseudos-balises <code>[tex]...[/tex]</code>. Par exemple, 
    4747[tex]$\displaystyle\int_{0}^{1}\frac{x^{4}\left(1-x\right)^{4}}{1+x^{2}}dx 
    4848=\frac{22}{7}-\pi$[/tex].</p> 
    49 <p>NB: en mode wiki, il faut passer temporairement en mode HTML pour que ça marche (un bug a été ouvert pour rendre cette procédure plus facile):</p> 
     49<p>NB&nbsp;: en mode wiki, il faut passer temporairement en mode HTML pour que ça marche (un rapport de bug a été ouvert pour rendre cette procédure plus facile)&nbsp;:</p> 
    5050<pre class="code"> 
    5151///html 
     
    5353/// 
    5454</pre> 
    55 <p>Les équations sont représentées sous forme d'image, et le code [tex]\LaTeX[/tex] est 
     55<p>Les équations sont représentées sous forme d'image et le code [tex]\LaTeX[/tex] est 
    5656donné comme titre de l'image.</p> 
    5757<div class="photo"><a href="/public/photos/dotclear/latexrender-exemple.png"><img src="/public/photos/dotclear/latexrender-exemple.png" alt="Exemple de rendu de LaTeXrender" title="Exemple de rendu de LaTeXrender" /></a><div class="legende">Exemple de rendu de LaTeXrender</div></div> 
     
    6060code doivent être composés en mode horizontal (si on veut composer en 
    6161mode vertical, par exemple des grandes équations, plusieurs 
    62 paragraphes..., il faut encadrer le tout par un 
     62paragraphes, il faut encadrer le tout par un 
    6363<code>\begin{minipage}{500px}...\end{minipage}</code>). C'est une restriction de 
    6464[tex]\LaTeX[/tex], pas de l'extension.</p> 
     
    6666dans un sous-répertoire <code>latexrender/images</code>.</p> 
    6767<h4>Gestion des couleurs</h4> 
    68 <p>La classe d'origine ne savait pas gérer des couleurs : le texte était 
     68<p>La classe d'origine ne savait pas gérer des couleurs&nbsp;: le texte était 
    6969toujours rendu en noir (sur fond transparent dans les dernières 
    7070versions). Certains thèmes sont de couleur sombre, ce qui rendait 
    7171l'extension inutilisable. Il est possible d'indiquer à LaTeXrender la 
    7272couleur dominante dans laquelle on veut que les équations soient rendues 
    73 pour qu'elles apparaissent sur la page. Par exemple, sur cette page, le thème d'origine <em>Grey Silence</em> ne fait aucun traitement spécifique, mais le thème <em>LIPN-hiver</em> était en blanc sur noir.</p> 
     73pour qu'elles apparaissent sur la page. Par exemple, le thème <em>Grey Silence</em> ne nécessite aucun traitement spécifique, mais le thème <em>LIPN-hiver</em> réclame du blanc sur noir.</p> 
    7474<p>Si vous choisissez la méthode de génération <em>avec couleur</em> 
    75 (qui nécessite un ImageMagick plus récent ; ça fonctionne au moins avec 
    76 ImageMagick 6.2.4 02/10/07 Q16), vous pourrez utiliser cette possibilité 
    77 ; il suffit d'ajouter dans l'un des 
     75(qui nécessite un ImageMagick plus récent&nbsp;; ça fonctionne au moins avec 
     76ImageMagick 6.2.4 02/10/07 Q16), vous pourrez utiliser cette possibilité&nbsp;;  
     77il suffit d'ajouter dans l'un des 
    7878fichiers de votre thème (juste avant la fin qui est normalement ?&gt;) 
    7979l'expression <code>$core-&gt;theme_color='FFFFFF';</code>. Cette ligne peut être 
    8080ajoutée avant la dernière ligne de <code>_public.php</code> ou <code>_prepend.php</code>. Si aucun 
    8181de ces fichiers n'est présent, un fichier <code>_public.php</code> constitué d'une 
    82 seule ligne peut être ajouté:</p> 
     82seule ligne peut être ajouté&nbsp;:</p> 
    8383<pre class="code">&lt;?php $core-&gt;theme_color='FFFFFF'; ?&gt;</pre> 
    8484<p>FFFFFF est à remplacer par la <a href="http://www.commentcamarche.net/html/htmlcouleurs.php3" hreflang="fr">couleur voulue en hexadécimal</a> (ici, blanc; 
    8585jaune est FFFF00, rouge est FF0000...).</p> 
    86 <div class="bug"><h3>Pour signaler un bug ou aider cette extension</h3><p>Le mieux est de me contacter <a href="http://jean-christophe.dubacq.fr/pages/Contact">par courrier</a> (pour un bug) ou de laisser un commentaire (pour dire que vous avez testé cette extension). En cas de mise à jour, je modifierai ce billet.</p></div><div class="changelog"><h3>Liste des changements</h3><p>Note : ce journal est non-exhaustif, généré automatiquement, en anglais, et sans doute non-informatif avant 2009.</p><ul><li>Local SVN release 400 (jcdubacq,2009-10-03)<ul> <li>Bump version number (oops)</li> </ul></li> <li>Local SVN release 369 (jcdubacq,2009-04-30)<ul> <li>Clean code</li> <li>Lift for the admin backend</li> <li>New screenshot</li> </ul></li> <li>Local SVN release 348 (jcdubacq,2009-04-22)<ul> <li>Fix documentation</li> </ul></li> <li>Local SVN release 346 (jcdubacq,2009-04-22)<ul> <li>Fix licence block, reindent</li> <li>Switch to LGPL 2.1 in order to keep the original licence</li> </ul></li> <li>Local SVN release 333 (jcdubacq,2009-04-18)<ul> <li>Allow for public path to be an absolute path, release</li> </ul></li> <li>Local SVN release 303 (jcdubacq,2009-01-27)<ul> <li>Fix locales</li> </ul></li> <li>Local SVN release 297 (jcdubacq,2009-01-26)<ul> <li>Adapt to version 0.3 of stacker (behavior initStacker)</li> </ul></li> <li>Local SVN release 292 (jcdubacq,2009-01-22)<ul> <li>Update documentation, release new version 0.6</li> </ul></li> <li>Local SVN release 259 (jcdubacq,2008-11-18)<ul> <li>Fix public url usage in admin area</li> </ul></li> <li>Local SVN release 205 (jcdubacq,2008-07-24)<ul> <li>Add documentation, new version</li> </ul></li> <li>Local SVN release 187 (jcdubacq,2008-07-09)<ul> <li>Add admin page, rewrite latexrender class to better fit the needs of DC2</li> </ul></li> <li>Local SVN release 168 (jcdubacq,2008-05-06)<ul> <li>Order plugins and themes</li> </ul></li> <li>Local SVN release 47 (jcdubacq,2008-02-15)<ul> <li>Add latexrender plugin</li> </ul></li></ul></div> 
     86<div class="bug"><h3>Pour signaler un bug ou aider cette extension</h3><p>Le mieux est de me contacter <a href="http://jean-christophe.dubacq.fr/pages/Contact">par courrier</a> (pour un bug) ou de laisser un commentaire (pour dire que vous avez testé cette extension). En cas de mise à jour, je modifierai cette aide.</p></div><div class="changelog"><h3>Liste des changements</h3><p>Note : ce journal est non-exhaustif, généré automatiquement, en anglais, et sans doute non-informatif avant 2009.</p><ul><li>Local SVN release 400 (jcdubacq,2009-10-03)<ul> <li>Bump version number (oops)</li> </ul></li> <li>Local SVN release 369 (jcdubacq,2009-04-30)<ul> <li>Clean code</li> <li>Lift for the admin backend</li> <li>New screenshot</li> </ul></li> <li>Local SVN release 348 (jcdubacq,2009-04-22)<ul> <li>Fix documentation</li> </ul></li> <li>Local SVN release 346 (jcdubacq,2009-04-22)<ul> <li>Fix licence block, reindent</li> <li>Switch to LGPL 2.1 in order to keep the original licence</li> </ul></li> <li>Local SVN release 333 (jcdubacq,2009-04-18)<ul> <li>Allow for public path to be an absolute path, release</li> </ul></li> <li>Local SVN release 303 (jcdubacq,2009-01-27)<ul> <li>Fix locales</li> </ul></li> <li>Local SVN release 297 (jcdubacq,2009-01-26)<ul> <li>Adapt to version 0.3 of stacker (behavior initStacker)</li> </ul></li> <li>Local SVN release 292 (jcdubacq,2009-01-22)<ul> <li>Update documentation, release new version 0.6</li> </ul></li> <li>Local SVN release 259 (jcdubacq,2008-11-18)<ul> <li>Fix public url usage in admin area</li> </ul></li> <li>Local SVN release 205 (jcdubacq,2008-07-24)<ul> <li>Add documentation, new version</li> </ul></li> <li>Local SVN release 187 (jcdubacq,2008-07-09)<ul> <li>Add admin page, rewrite latexrender class to better fit the needs of DC2</li> </ul></li> <li>Local SVN release 168 (jcdubacq,2008-05-06)<ul> <li>Order plugins and themes</li> </ul></li> <li>Local SVN release 47 (jcdubacq,2008-02-15)<ul> <li>Add latexrender plugin</li> </ul></li></ul></div> 
    8787<h3>Travail restant à faire</h3> 
    8888<ul><li>Faire une version qui ne dépend pas de l'extension <code>stacker</code></li> 
     
    9090<li>Gérer les couleurs des thèmes indépendamment des thèmes</li> 
    9191<li>Travailler avec Sacha pour fournir une version client/serveur de 
    92 latexrender qui sait fournir l'image et le décalage, et avec des 
     92latexrender qui sait fournir l'image et le décalage et avec des 
    9393conditions de sécurité suffisantes (le calcul des images peut être 
    9494coûteux ou risqué si n'importe qui peut le faire).</li> 
  • plugins/latexrender/doc/LISEZMOI.txt

    r1545 r1711  
    55la recherche scientifique) d'afficher (sous forme d'image) des morceaux de texte 
    66composés en [tex]\LaTeX[/tex]. Il est livré avec une zone de réglages pour 
    7 choisir les chemins ses programmes auxiliaires. 
     7choisir les chemins de ses programmes auxiliaires. 
    88 
    99Ce plugin est d'une part une conversion d'une classe déjà existante (la classe 
    10 [1]latexrender, écrite en PHP pour un tas de supports); d'autre part, j'ai 
     10[1]latexrender, écrite en PHP pour un tas de supports), d'autre part, j'ai 
    1111simplifié la classe (un bon nombre de choses sont complètement simplifiables 
    1212dans le cadre restreint de Dotclear 2) mais aussi amélioré l'algorithme de choix 
     
    2424zone d'administration Extensions > LaTeXrender > Paramètres en tant que 
    2525super-administrateur, et remplissez les chemins d'accès aux divers exécutables 
    26 ([tex]\LaTeX[/tex] et la suite ImageMagick; les valeurs par défauts doivent être 
     26([tex]\LaTeX[/tex] et la suite ImageMagick ; les valeurs par défaut doivent être 
    2727suffisantes pour la plupart des installations) ainsi que quelques paramètres 
    28 supplémentaires (dans le menu Extensions). Les paramètres doivent être évidents 
    29 ; si ce n'est pas le cas, soumettez un rapport de bug. 
     28supplémentaires (dans le menu Extensions). Les paramètres doivent être évidents;  
     29si ce n'est pas le cas, soumettez un rapport de bug. 
    3030 
    3131L'extension nécessite une installation sur le serveur de latex et du paquet 
     
    4040solution sans cette extension est à l'étude, mais elle sera forcément 
    4141incompatible avec plusieurs autres extensions qui redéfinissent l'accès au 
    42 contenu des billets (note: comme l'auteur en utilise plusieurs, il considère 
    43 ceci comme un bug). 
     42contenu des billets (note : comme l'auteur en utilise plusieurs, il considère 
     43cela comme un bug). 
    4444 
    4545La version courante de cette extension est 0.9.3 (local svn 400). 
     
    5151--- Utilisation basique --- 
    5252 
    53 L'utilisation en est souple, il suffit de taper son texte [tex]\LaTeX[/tex] 
     53L'utilisation est souple, il suffit de taper son texte [tex]\LaTeX[/tex] 
    5454entre deux pseudos-balises [tex]...[/tex]. Par exemple, 
    5555[tex]$\displaystyle\int_{0}^{1}\frac{x^{4}\left(1-x\right)^{4}}{1+x^{2}}dx 
    5656=\frac{22}{7}-\pi$[/tex]. 
    5757 
    58 NB: en mode wiki, il faut passer temporairement en mode HTML pour que ça marche 
    59 (un bug a été ouvert pour rendre cette procédure plus facile): 
     58NB : en mode wiki, il faut passer temporairement en mode HTML pour que ça marche 
     59(un ticket a été ouvert pour rendre cette procédure plus facile) : 
     60 
    6061///html 
    6162[tex]$(a+b)^2=a^2+2ab+b^2$[/tex] 
    6263/// 
    6364 
    64 Les équations sont représentées sous forme d'image, et le code [tex]\LaTeX[/tex] 
     65Les équations sont représentées sous forme d'image et le code [tex]\LaTeX[/tex] 
    6566est donné comme titre de l'image. 
    6667 
     
    6869autorisées (pas de \special, par exemple), les morceaux de code doivent être 
    6970composés en mode horizontal (si on veut composer en mode vertical, par exemple 
    70 des grandes équations, plusieurs paragraphes..., il faut encadrer le tout par un 
     71des grandes équations, plusieurs paragraphes, il faut encadrer le tout par un 
    7172\begin{minipage}{500px}...\end{minipage}). C'est une restriction de 
    7273[tex]\LaTeX[/tex], pas de l'extension. 
     
    8283possible d'indiquer à LaTeXrender la couleur dominante dans laquelle on veut que 
    8384les équations soient rendues pour qu'elles apparaissent sur la page. Par 
    84 exemple, sur cette page, le thème d'origine Grey Silence ne fait aucun 
    85 traitement spécifique, mais le thème LIPN-hiver était en blanc sur noir. 
     85exemple, le thème Grey Silence ne nécessite aucun 
     86traitement spécifique, mais le thème LIPN-hiver réclame du blanc sur noir. 
    8687 
    8788Si vous choisissez la méthode de génération avec couleur (qui nécessite un 
     
    9192l'expression $core->theme_color='FFFFFF';. Cette ligne peut être ajoutée avant 
    9293la dernière ligne de _public.php ou _prepend.php. Si aucun de ces fichiers n'est 
    93 présent, un fichier _public.php constitué d'une seule ligne peut être ajouté: 
     94présent, un fichier _public.php constitué d'une seule ligne peut être ajouté : 
    9495<?php $core->theme_color='FFFFFF'; ?> 
    9596 
    96 FFFFFF est à remplacer par la [6]couleur voulue en hexadécimal (ici, blanc; 
    97 jaune est FFFF00, rouge est FF0000...). 
     97FFFFFF est à remplacer par la [6]couleur voulue en hexadécimal (ici, blanc ; 
     98jaune est FFFF00, rouge est FF0000). 
    9899 
    99100=== Pour signaler un bug ou aider cette extension === 
     
    101102Le mieux est de me contacter [7]par courrier (pour un bug) ou de laisser un 
    102103commentaire (pour dire que vous avez testé cette extension). En cas de mise à 
    103 jour, je modifierai ce billet. 
     104jour, je modifierai ce fichier. 
    104105 
    105106=== Liste des changements === 
     
    143144  * Gérer les couleurs des thèmes indépendamment des thèmes 
    144145  * Travailler avec Sacha pour fournir une version client/serveur de latexrender 
    145 qui sait fournir l'image et le décalage, et avec des conditions de sécurité 
     146qui sait fournir l'image et le décalage et avec des conditions de sécurité 
    146147suffisantes (le calcul des images peut être coûteux ou risqué si n'importe qui 
    147148peut le faire). 
Note: See TracChangeset for help on using the changeset viewer.

Sites map