Ekstensi:Math

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Math and the translation is 57% complete.
Outdated translations are marked like this.
Manual ekstensi MediaWiki
OOjs UI icon advanced-invert.svg
Math
Status rilis: stabil
ExtensionMath (cropped).svg
Implementasi Tag
Deskripsi Memungkinkan untuk menampilkan rumus matematika
Perancang awal
  • Moritz Schubotz,
  • Tomasz Wegrzanowski,
  • Brion Vibber
  • dan lain-lain
Versi terbaru continuous updates
Kebijakan kompatibilitas Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.25+
Perubahan basis data Ya
Tabel math
mathoid
mathlatexml
Lisensi Lisensi Publik Umum GNU 2.0 atau lebih baru
Unduh
  • $wgMathEnableWikibaseDataType
  • $wgMathDefaultLaTeXMLSetting
  • $wgMathWikibasePropertyIdHasPart
  • $wgMathoidCli
  • $wgMathLaTeXMLTimeout
  • $wgMathWikibasePropertyIdQuantitySymbol
  • $wgMathDisableTexFilter
  • $wgMathMathMLTimeout
  • $wgMathLaTeXMLUrl
  • $wgMathEnableExperimentalInputFormats
  • $wgMathValidModes
  • $wgMathWikibasePropertyIdDefiningFormula
  • $wgMathFullRestbaseURL
  • $wgMathMathMLUrl
  • $wgMathConcurrentReqs
  • $wgMathEnableFormulaLinks
‎<math>
Terjemahkan ekstensi Math jika tersedia di translatewiki.net

Periksa matriks penggunaan dan versi.

Masalah Tugas terbuka · Laporkan kekutu

Ekstensi Math menyediakan dukungan untuk menampilkan rumus-rumus matematika. Gambaran umum mengenai apa yang bisa dilakukan menggunakan ekstensi ini tersedia di dokumentasi Wikipedia bahasa Inggris.

Informasi lebih lanjut mengenai memasang dan mengonfigurasi ekstensi ini, termasuk untuk versi lama, bisa ditemukan di Extension:Math/advancedSettings .

Melihat matematika

Ekstensi Math mencoba mengirimkan keluaran MathML, dengan cadangannya adalah gambar dalam SVG (mengonversi karakter menjadi <path>) atau PNG (pilihan terakhir). Bergantung pada kemampuan perangkat yang Anda gunakan, jenis keluaran dipilih. Dukungan matematika dasar bekerja untuk semua penjelajah. Namun, untuk rendering yang optimal, mungkin diperlukan penyetelan khusus:

Dukungan aksesibilitas disediakan oleh VoiceOver pembaca layar tetapi tidak oleh Orca namun.

Instalasi

  • Jika menggunakan Vagrant , pasanglah dengan vagrant roles enable math --provision
Instalasi manual
  • Unduh dan letakkan berkas-berkasnya di dalam sebuah direktori yang bernama Math di folder extensions/ Anda.
  • Tambahkan baris berikut di bawah LocalSettings.php Anda:
    wfLoadExtension( 'Math' );
    // Lihat di bawah untuk persyaratan instalasi dan pengaturan konfigurasi:
    
  • Jalankan skrip pembaruan yang akan membuat tabel basis data yang diperlukan ekstensi ini secara otomatis.
  • Untuk melihat matematika di luar keluaran teks biasa, ikuti petunjuk di bawah ini untuk mengaktifkan berbagai mode keluaran matematika.
  • If you have problems for represent formulas when trying to use wikipedia restbase, you can try using the following patch
  • Yes Selesai – Telusuri ke Special:Version di wiki Anda untuk memastikan ekstensinya berhasil dipasang.

You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work. Untuk masalah apa pun yang Anda lihat, opsi terbaik adalah membuat tugas di https://phabricator.wikimedia.org

Sayangnya, tidak ada panduan yang teruji untuk menginstal Mathoid dan RESTBase untuk bekerja dengan ekstensi Math, tetapi setidaknya ada draf yang berfungsi. Extension:Math/Restbase silakan berkontribusi.

Selain itu, ada untuk Menginstal dan Menyiapkan Mediawiki dengan Restbase dan Mathoid di MW1.28.

Mode keluaran matematika

Pengaturan $wgMathValidModes menampung larik dengan nama mode keluaran yang dapat digunakan untuk rendering. Jika beberapa mode diaktifkan, pengguna yang masuk dapat mengatur preferensi pribadi di panel tampilan halaman preferensi pengguna mereka.

Anda juga dapat menggunakan setelan $wgDefaultUserOptions untuk menyetel mode mana yang harus dijadikan default, misal:

$wgDefaultUserOptions['math'] = 'mathml';

Mathoid

Mode: 'mathml' (pre-July 2015: MW_MATH_MATHML)

Untuk MW 1.23 dan lebih tinggi, Anda dapat menggunakan server Mathoid yang menggunakan MathJax untuk mengonversi input texvc di sisi server ke rendering MathML+SVG. Ini adalah opsi yang paling direkomendasikan; Mathoid adalah mode rendering yang akan digunakan di Wikipedia di masa mendatang.

Mathoid sebagai layanan

Untuk menggunakan Mathoid sebagai layanan, yang menghasilkan manfaat kinerja, disarankan pengaturan berikut:

// Tetapkan MathML sebagai opsi rendering default
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathFullRestbaseURL = 'https://en.wikipedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org/';

Lihat Mathoid untuk instruksi tentang cara menjalankan server Mathoid Anda sendiri. Perhatikan bahwa mulai Maret 2017 ini kemungkinan juga memerlukan server/instalasi RESTBase (lihat task T154394).

Antarmuka CLI Mathoid

Untuk menggunakan antarmuka CLI Mathoid, yang mungkin lebih mudah disiapkan dan konsumsi memori permanennya lebih sedikit, serta mengurangi performa, pengaturan berikut disarankan:

// Tetapkan MathML sebagai opsi ''rendering'' baku
$wgDefaultUserOptions['math'] = 'mathml';
// Dari awal buatlah sebuah config.yaml. Templat-templatnya ada di repositori Mathoid.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// Tingkatkan batas memori MediaWiki menjadi 1.2G untuk mathoid.
$wgMaxShellMemory = 1228800;

If you run MediaWiki under system containing SELinux and you get Mathoid cli '/path/to/mathoid/cli.js' is not executable message from the error log, you can run the following to make sure the Apache server allow to change system limits:

setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

LaTeX

Mode: 'png' (pre-July 2015: MW_MATH_PNG)

Sejak MediaWiki 1.32, mode ini juga memerlukan peladen Mathoid agar bekerja. Di versi yang lebih lama, mode ini memerlukan pemasangan texvc dan texvccheck, yang mungkin membutuhkan paling banyak pengaturan.

LaTeXML

Mode: 'latexml' (pre-July 2015: MW_MATH_LATEXML)

Menggunakan utilitas LaTeXML. Rendering dilakukan melalui layanan daring (ditetapkan dengan $wgLaTeXMLUrl, yang punya nilai baku).

No rendering

Mode: 'source', (pre-July 2015: MW_MATH_SOURCE)

This mode will forward the Latex input without rendering, presenting it in a ‎<span> element, surrounded by $ :formula $.

Make sure to set $wgMathDisableTexFilter to 'always' (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.

MathJax

Peringatan Peringatan The client-side MathJax rendering mode is removed in MediaWiki 1.26. See Extension:SimpleMathJax for an alternative.


List of significant configuration settings

Setting name Default value Description
$wgMathValidModes array( 'png', 'source', 'mathml' ) Defines the mode allowed on the server.
$wgMathDisableTexFilter 'never' Option to disable the tex filter. If set to true any LaTeX expression is parsed this can be a potential security risk. If set to false only a subset of the TeX commands is allowed. See the wikipedia page Help:Math for details. Use "always" to disable this feature.
$wgMathFullRestbaseURL false The math extension gets the default config from the Visual Editor, if available. Details.

Tracking categories

The extension creates a number of tracking categories to detect errors and deprecated features. The exact name of the categories is determined by pages in the MediaWiki namespace.

MediaWiki page Default Description
MediaWiki:Math-tracking-category-error Category:Pages with math errors Pages where there is a syntax error in the formula causing the rendering to fail
MediaWiki:Math-tracking-category-render-error Category:Pages with math render errors Pages where there has been a temporary error in the rendering pipeline causing the rendering to fail. These normally fix themselves
MediaWiki:Math-tracking-category-texvc-deprecation Category:Pages that use a deprecated format of the math tags Pages which use deprecated texvc syntax like $ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor, which should be replaced by more standard LaTeX \$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed) respectively. See Extension:Math/Roadmap .
MediaWiki:Math-tracking-category-mhchem-deprecation Category:Pages that use a deprecated format of the chem tags

Deprecated chemical markup, see Extension:Math/Roadmap#Step 1 Part C: Manual fixing of mhchem syntax.

Tips and tricks

  • You can override the user preferred and default rendermode by adding the forcemathmode attribute to the ‎<math> element. e.g. to force an image being rendered <math forcemathmode="png">...</math>.
  • All images of rendered formula are stored in a cache and not automatically recreated if the page is viewed or edited.

To force the re-rendering of all formulas of a page, purge using the ?action=purge&mathpurge=true action. For example the URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true will force re-rendering of the w:Integer article. Afterwards you need to bypass your browser cache so that the new created images of the formulas are actually downloaded.

Error reporting

If something is wrong with the math extension you can report that at Phabricator. In addition you should check how your problem relates to the automated unit tests that are generated from the page CoverageTest.

Bacaan lebih lanjut

Lihat Extension:Math/advancedSettings untuk versi lama dan informasi lebih lanjut.

Subhalaman

Lihat pula