MediaWiki/TeX

Wikibooks, manuali e libri di testo liberi.
Jump to navigation Jump to search

È possibile visualizzare formule matematiche scritte in linguaggio TeX, ricorrendo ad estensioni del software. Esistono molte estensioni diverse che svolgono questo compito.

Estensione Math[modifica]

Per visualizzare formule matematiche, si installa l'estensione Math e la si configura come indicato di seguito.

Si aggiungono le seguenti righe nel file LocalSettings.php:

$wgUploadPath = "images";
$wgUploadDirectory = "images";
$wgMathPath = "{$wgUploadPath}/math";
$wgMathDirectory = "{$wgUploadDirectory}/math";
$wgTmpDirectory = "{$wgUploadDirectory}/tmp";

Se queste cartelle non esistono, vanno create:

  • /images/math
  • /images/tmp

assegnando loro i permessi 755.

Quindi, si compila il programma texvc (fornito insieme con MediaWiki), lo si colloca nella cartella /math, e gli si assegnano i permessi 755.

Alternativa a texvc

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:

 $wgUseMathJax = true;

Questa modalità è disabilitata per default nelle preferenze utente; spetta a ciascun utente abilitarla nel pannello delle preferenze.

Installare TeX[modifica]

Prima di questa operazione, è necessario aver installato Ocaml, ImageMagick, LaTeX, GhostScript.

Nel file LocalSettings.php inserire:

$wgUseTeX = true;

Per installare la funzione:

# cd math/
# make

A operazione conclusa, un'espressione come viene resa correttamente.

Installare Ocaml[modifica]

Procurarsi il software da http://caml.inria.fr/

# cd
# tar -xjvf ocaml*.tar.bz2
# cd ocaml*
# ./configure
# make world
# make opt
# make install

Installare teTeX[modifica]

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
# cd /usr/local/bin
# ln -s /usr/share/texmf/bin/* .

Questa installazione funziona soltanto su GNU/Linux Slackware.

Estensione Mimetex[modifica]

L'estensione Mimetex costituisce un'alternativa all'estensione Math.

Installazione sul wiki[modifica]

Incollare il codice seguendo le istruzioni in Extension:Mimetex_alternative. L'estensione, quindi, va attivata nel file LocalSettings.php.

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[1] o potrebbe presentare problemi di funzionamento, in quanto il codice non è stato revisionato né aggiornato dagli sviluppatori del software.

Installazione su un server privato[modifica]

Un'alternativa più sicura è svolgere la conversione grafica su un server diverso da quello che ospita il wiki. MediaWiki invierà il testo al server richiamando una pagina CGI, che convertirà il testo wiki in formato grafico, e restituirà il risultato a MediaWiki, che lo mostrerà all'utente.
Per far questo, si installa Mimetex su un server apposito, quindi si inserisce il nome del server nel file Math.php di MediaWiki, seguendo le istruzioni apposite.

Note[modifica]

  1. Extension_talk:Mimetex_alternative

Collegamenti esterni[modifica]