Ekstensi:Math

From mediawiki.org
This page is a translated version of the page Extension:Math and the translation is 69% complete.
Outdated translations are marked like this.
Ekstensi ini tersedia di MediaWiki 1.38 dan selanjutnya. Jadi Anda tidak perlu mengunduhnya lagi. Akan tetapi, Anda masih perlu mengikuti instruksi lain yang diberikan.
Ekstensi MediaWiki
Math
Status rilis stabil
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.42.0
Perubahan basis data Ya
Tabel math
mathoid
mathlatexml
Lisensi Lisensi Publik Umum GNU 2.0 atau lebih baru
Unduh
  • $wgMathEnableWikibaseDataType
  • $wgMathDefaultLaTeXMLSetting
  • $wgMathUseInternalRestbasePath
  • $wgMathMathMLUrl
  • $wgMathFullRestbaseURL
  • $wgMathTexVCService
  • $wgMathInternalRestbaseURL
  • $wgMathConcurrentReqs
  • $wgMathEnableFormulaLinks
  • $wgMathValidModes
  • $wgMathEntitySelectorFallbackUrl
  • $wgMathWikibasePropertyIdQuantitySymbol
  • $wgMathDisableTexFilter
  • $wgMathMathMLTimeout
  • $wgMathWikibasePropertyIdSymbolRepresents
  • $wgMathWikibasePropertyIdHasPart
  • $wgMathWikibasePropertyIdInDefiningFormula
  • $wgMathWikibasePropertyIdDefiningFormula
  • $wgMathoidCli
  • $wgMathLaTeXMLUrl
  • $wgMathLaTeXMLTimeout
  • $wgMathEnableExperimentalInputFormats
‎<math>
Quarterly downloads 191 (Ranked 37th)
Public wikis using 7,934 (Ranked 18th)
Terjemahkan ekstensi Math jika tersedia di translatewiki.net
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 m:Help:Menampilkan formula.

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

Melihat matematika

The type of output depends on the software that you use to read the page. Ekstensi Math mencoba mengirimkan keluaran MathML, dengan cadangannya adalah gambar dalam SVG (mengonversi karakter menjadi <path>) atau PNG (pilihan terakhir). Dukungan matematika dasar bekerja untuk semua penjelajah. Namun, untuk rendering yang optimal, mungkin diperlukan penyetelan khusus:


Instalasi

  • Unduh dan letakkan berkas-berkasnya di dalam sebuah direktori yang bernama Math di folder extensions/ Anda.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Math
  • Tambahkan kode berikut di bagian bawah LocalSettings.php Anda:
    wfLoadExtension( 'Math' );
    
  • 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.
  • Jika Anda punya masalah dalam merepresentasikan rumus ketika mencoba menggunakan RESTBase, Anda bisa mencoba menggunakan tambalan berikut
  • Yes Selesai – Telusuri ke Special:Version di wiki Anda untuk memastikan ekstensinya berhasil dipasang.


Instalasi Vagrant:

  • Jika menggunakan Vagrant , pasanglah dengan vagrant roles enable math --provision

Anda sebaiknya juga pergi ke halaman Special:MathStatus untuk melihat apakah semua komponene ekstensi Math sekarang bekerja. 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. Silakan berkontribusi di Extension:Math/RESTBase .

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'

Anda dapat menggunakan Mathoid, sebuah aplikasi yang menggunakan MathJax di sisi peladen untuk mengonversi masukan texvc menjadi rendering MathML+SVG. Ini adalah opsi yang paling disarankan; Mathoid adalah mode rendering yang digunakan di Wikipedia.

Mathoid sebagai layanan

"Mathoid sebagai layanan" adalah pendekatan yang disarankan untuk ekstensi Math dan pendekatan standar. Jika Anda tidak menambahkan setelah tambahan ke LocalSettings.php, Math akan mengguankan Mathoid klaster Beta dan layanan RESTBase untuk melakukan semua rendering rumus matematika. Pengaturan bawaannya adalah:

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

Anda bisa mengubah pengaturan ini untuk menggunakan layanan Mathoid dan RESTBase yang berbeda, bisa jadi layanan Anda sendiri.

Antarmuka CLI Mathoid

Anda bisa menjalankan Mathoid sebagai utilitas baris perintah di peladen lokal. Untuk pendekatan ini, 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;
Jika Anda menjalankan MediaWiki dalam sistem yang mengandung SELinux dan Anda mendapatkan pesan Mathoid cli '/path/to/mathoid/cli.js' is not executable di log galat, Anda bisa menjalankan yang berikut ini untuk memastikan peladen Apache membolehkan pengubahan batas sistem:
setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

LaTeX

Versi MediaWiki:
1.39

Mode: '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'

Menggunakan utilitas LaTeXML. Rendering dilakukan melalui layanan daring (ditetapkan dengan $wgLaTeXMLUrl, yang punya nilai baku https://latexml.formulasearchengine.com/convert).

Native MathML

Versi MediaWiki:
1.40

Mode: 'native'

This mode will generate MathML from LaTeX via PHP without Mathoid. Note this mode does not have image fallback, so formulas will only be displayed correctly if the browser supports MathML. Firefox and Safari introduced MathML support early (2006 and 2008), but support in Chromium-based browsers is a much more recent addition (Chrome 109, released in 2023).

No rendering

Mode: '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.

Daftar setelah konfigurasi yang signifikan

Nama setelan Nilai standar Deskripsi
$wgMathValidModes [ 'source', 'mathml' ] Menetapkan mode yang dibolehkan di peladen.
$wgMathDisableTexFilter 'never' Pilihan untuk mematikan penyaring tex. Jika diatur menjadi true, maka ekspresi LaTeX apa pun akan diuraikan. Ini bisa menjadi risiko keamanan. Jika diatur menjadi false, hanya sebagian perintah TeX yang dibolehkan. Lihat halaman Wikipedia Help:Math funtuk rinciannya. Gunakan "always" untuk mematikan fitur ini.
$wgMathFullRestbaseURL false Ekstensi math mendapatkan konfigurasi bawaan dari Penyunting Visual, apabila tersedia. Rincian.
$wgMathPreferRestbaseURL true Whether to allow using of internal RESTBase path instead of $wgMathFullRestbaseURL and $wgVisualEditorFullRestbaseURL. Set false if you want to use external RESTBase in any case.

Kategori pelacak

Ekstensi ini membuat beberapa kategori pelacak untuk mendetetksi galat dan fitur yang usang. Nama persis dari kategorinya ditentukan oleh halaman-halaman di ruang nama MediaWiki.

Halaman MediaWiki Nilai standar Deskripsi
MediaWiki:Math-tracking-category-error Category:Pages with math errors Halaman di mana ada galat sintaksis dalam formula sehingga penggambaran gagal
MediaWiki:Math-tracking-category-render-error Category:Pages with math render errors Halaman di mana terjadi galat sementara dalam proses penggambaran sehingga penggambaran gagal. Ini biasanya menjadi normal dengan sendirinya.
MediaWiki:Math-tracking-category-texvc-deprecation Category:Pages that use a deprecated format of the math tags Halaman yang menggunakan sintaksis texvc usang seperti $ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor, yang seharusnya digantikan dengan LaTeX \$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed) yang lebih standar. Lihat Extension:Math/Roadmap .
MediaWiki:Math-tracking-category-mhchem-deprecation Category:Pages that use a deprecated format of the chem tags

Markah kimia usang, lihat Extension:Math/Peta jalan#Tahap 1 Bagian C: Memperbaiki sintaksi mhchem secara manual.

Tips and tricks

  • You can use the Firefox MathML copy addon to copy formulae to other applications such as Microsoft Word (video), or Google docs with the g(Math) plugin (video)
  • 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:Integral article. Afterwards you need to bypass your browser cache so that the new created images of the formulas are actually downloaded.

Pelaporan galat

Jika ada yang salah dengan ekstensi math, Anda bisa melaporkannya di Phabricator. Selain itu, Anda sebaiknya memeriksa apakah masalah Anda berhubungan dengna tes satuan otomatis yang dihasilkan dari halaman CoverageTest.

Bacaan lebih lanjut

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

Subhalaman

Lihat pula