LaTeX w MediaWiki

Z KdmWiki
Przejdź do nawigacji Przejdź do wyszukiwania

Wymagania

  • texvc, skrypt MediaWiki wywoływany przy generowaniu fragmentów zamkniętych w znacznikach "math", dołączony jest do dystrybucji pakietu MediaWiki, powinien znajdować się w katalogu instalacji w podkatalogu "math".
  • OCaml (Objective Caml) - wymagana jest wersja 3.06 lub nowsza, potrzebna do kompilacji texvc; można go pobrać ze strony http://caml.inria.fr/ jeżeli system nie udostępnia go w pakiecie.
  • Plik makefile wymaga GNU make.
  • Rasteryzacja wykonywana jest poprzez LaTeX, dvips i ImageMagick. Pakiety te muszą być zainstalowane w systemie i dostarczać komend w ścieżce PATH: latex, dvips, convert, gs.
  • Do poprawnego generowania znaków unicode (non-ASCII) potrzebny jest supplemental TeX package ("cjk-latex" w Debianie)

Komponenty

texvc
dostarczane w dystrybucji MediaWiki
OCaml
Najnowsza wersja Objective Caml
(PLD: ocaml-3.06-4)
GNU make
powinien być dostępny w systemie Linux
Pod Windows, można użyć MinGW lub Cygwin.
Inne systemy: zobacz GNU Make - GNU Project - Free Software Foundation (FSF)
LaTeX, dvips, ams
zobacz TeX Live - TeX Users Group
(PLD: tetex-latex, tetex-dvips, tetex-ams, tetex-fonts)
ImageMagick
ImageMagick: Install from Binary Distribution
(PLD: ImageMagick-5.4.9-4)
ghostscript

Powyższe pakiety powinny być dostępne w systemie przed przystąpieniem do instalacji rozszerzenia MediaWiki.

Instalacja

  1. Przejdź do podkatalogu math katalogu instalacji MediaWiki
  2. Uruchom make (lub gmake jeżeli GNU make nie jest domyślny). Ten krok powinien wygenerować plik wykonywalny texvc.
  3. Ustaw $wgUseTeX = true; w pliku LocalSettings.php i wszystko powinno działać.

Uwagi

  • Jeżeli po instalacji kod LaTeX'owy nie jest nadal renderowany, przeładuj stronę, może to wynikać z cache'a.
  • Jeżeli pojawia się komunikat o błędzie parsera, najlepiej sprawdź 'niepoprawną' formułę używając polecenia latex z command-line. Zobacz też: KDMWiki:Edycja wzorów.
  • Kod Tex-a jest renderowany podczas zapisywania strony, ale tylko zmienione dane są renderowane ponownie i zgrywane
  • Więcej informacji znajduje się w pliku README w katalogu "math".

Zobacz też