MediaWiki/TeX: differenze tra le versioni

Contenuto cancellato Contenuto aggiunto
incollo da "MediaWiki/Estensione Mimetex" testo scritto da me il 1 feb 2012
m forma
Riga 3:
{{avanzamento|25%}}
 
È possibile visualizzare formule matematiche scritte in linguaggio TeX, ricorrendo ad estensioni del software. Esistono molte estensioni diverse che svolgono questo compito.
==Visualizzare formule matematiche==
 
Per visualizzare formule matematiche, si installa l'estensione [[mw:Extension:Math|Math]] e la si configura opportunamente.
== Estensione Math ==
Per visualizzare formule matematiche, si installa l'estensione [[mw:Extension:Math|Math]] e la si configura opportunamentecome indicato di seguito.
 
Si aggiungono le seguenti righe nel file <tt>LocalSettings.php</tt>:
 
<pre><nowiki>
<code>
$wgUploadPath = "images";
$wgUploadDirectory = "images";
Line 14 ⟶ 16:
$wgMathDirectory = "{$wgUploadDirectory}/math";
$wgTmpDirectory = "{$wgUploadDirectory}/tmp";
</nowiki></pre>
</code>
 
Se queste cartelle non esistono, vanno create:
Line 21 ⟶ 23:
assegnando loro i permessi 755.
 
Quindi, si compila il programma <tt>texvc</tt> (fornito insieme con MediaWiki), lo si colloca nella cartella <code>/math</code>, e gli si assegnaassegnano i permessi 755.
 
; Alternativa a texvc
=== Estensioni alternative ===
A partire da MediaWiki 1.19/1.20, è supportata in via sperimentale la visualizzazione delle formule tramite una libreria Javascript eseguita lato client. Questa modalità rende l'installazione molto più semplice, in quanto non è necessario installare texvc, invece si aggiunge solo questa riga al file LocalSettings.php:
Su alcuni web server, LaTeX non è installato, pertanto l'estensione Math potrebbe non funzionare. In questo caso, si può usare l'[[MediaWiki/Estensione Mimetex|estensione Mimetex]].
<pre><nowiki>
$wgUseMathJax
</nowiki></pre>
 
Questa modalità è disabilitata per default nelle preferenze utente; spetta a ciascun utente abilitarla nel pannello delle preferenze.
====Link di riferimento====
* [[mw:Manual:Math|Guida all'uso delle formule TeX su MediaWiki]]
* [[mw:Manual:Troubleshooting math display errors|Manual:Troubleshooting math]]
 
=== Installare TeX ===
Prima di questa operazione, è necessario aver installato Ocaml, ImageMagick, LaTeX, GhostScript.
 
Line 40 ⟶ 43:
A operazione conclusa, un'espressione come <math>a^2+b^2=c^2</math> viene resa correttamente.
 
====installare Installare Ocaml ====
Procurarsi il software da http://caml.inria.fr/
# cd
Line 49 ⟶ 52:
# make opt
# make install
 
====installare Installare teTeX ====
Procurarsi il software da http://www.tug.org/tetex/ ...la versione 3 di teTeX richiede un download di circa 100 Mb, mentre il pacchetto precompilato per Slackware circa 50 (vedi "ricerca tarball" su http://www.slackit.org).
# installpkg tetex*.tgz
Line 56 ⟶ 60:
Questa installazione funziona soltanto su GNU/Linux Slackware.
 
== Estensione Mimetex ==
L'estensione Mimetex costituisce un'alternativa nel caso in cui lall'[[MediaWiki/LocalSettings.php#Visualizzare_formule_matematiche|estensione Math]] non funzioni.
 
=== Installazione sul wiki ===
L'estensione Mimetex costituisce un'alternativa nel caso in cui l'[[MediaWiki/LocalSettings.php#Visualizzare_formule_matematiche|estensione Math]] non funzioni.
 
== Installazione sul wiki ==
[[File:Extra edit page buttons.png|thumb|left]]
Incollare il codice seguendo le istruzioni in [[mw:Extension:Mimetex_alternative|Extension:Mimetex_alternative]]. L'estensione, quindi, va attivata nel file <tt>LocalSettings.php</tt>.
Line 66 ⟶ 69:
Tuttavia, poiché il codice è stato incollato direttamente dal wiki invece di essere stato scaricato dal repository di MediaWiki, questa soluzione potrebbe esporre il wiki a vulnerabilità non ancora conosciute<ref>[[mw:Extension_talk:Mimetex_alternative|Extension_talk:Mimetex_alternative]]</ref> o potrebbe presentare problemi di funzionamento, in quanto il codice non è stato revisionato né aggiornato dagli sviluppatori del software.
 
=== Installazione su un server privato ===
Un'alternativa più sicura è riservaresvolgere unla secondoconversione servergrafica allasu conversioneun graficaserver diverso da testoquello wikiche inospita formuleil matematichewiki. Il wikiMediaWiki invierà il testo al server richiamando una pagina CGI, che convertirà il servertesto svolgeràwiki lain conversioneformato grafico, e restituirà il risultato ala wikiMediaWiki, che lo mostrerà all'utente.<br />
InPer questofar casoquesto, si installa Mimetex su un server apposito, quindi si inserisce il nome del server nel file <tt>Math.php</tt> di MediaWiki, seguendo [[mw:LaTeX_on_a_shared_host|le istruzioni apposite]]. Ciò forza MediaWiki ad utilizzare il server specificato per interpretare le espressioni matematiche racchiuse tra tag <nowiki><math></nowiki>, invece di usare il proprio motore interno.
 
In questo caso, si installa Mimetex su un server apposito, quindi si inserisce il nome del server nel file <tt>Math.php</tt> di MediaWiki, seguendo [[mw:LaTeX_on_a_shared_host|le istruzioni apposite]]. Ciò forza MediaWiki ad utilizzare il server specificato per interpretare le espressioni matematiche racchiuse tra tag <nowiki><math></nowiki>, invece di usare il proprio motore interno.
 
== Note ==
Line 75 ⟶ 77:
 
== Collegamenti esterni ==
* [[mw:Manual:Math|Guida all'uso delle formule TeX su MediaWiki]]
*[[mw:LaTeX_on_a_shared_host|LaTeX on a shared host]]
* [[mw:Manual:Troubleshooting math display errors|Manual:Troubleshooting math]]
* [[mw:LaTeX_on_a_shared_host|LaTeX on a shared host]]