Ekstensi:Math

From mediawiki.org
This page is a translated version of the page Extension:Math and the translation is 88% complete.
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.
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.39.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
  • $wgMathConcurrentReqs
  • $wgMathEnableFormulaLinks
  • $wgMathValidModes
  • $wgMathEntitySelectorFallbackUrl
  • $wgMathWikibasePropertyIdQuantitySymbol
  • $wgMathDisableTexFilter
  • $wgMathMathMLTimeout
  • $wgMathWikibasePropertyIdSymbolRepresents
  • $wgMathWikibasePropertyIdHasPart
  • $wgMathWikibasePropertyIdInDefiningFormula
  • $wgMathWikibasePropertyIdDefiningFormula
  • $wgMathoidCli
  • $wgMathLaTeXMLUrl
  • $wgMathLaTeXMLTimeout
  • $wgMathEnableExperimentalInputFormats
‎<math>
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

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

  • 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' );
    
  • 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 basis rest Wikipedia, Anda bisa mencoba menggunakan tambalan berikut
  • Yes Selesai – Telusuri ke Special:Version di wiki Anda untuk memastikan ekstensinya berhasil dipasang.


Vagrant installation:

  • 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. 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'

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 Wikimedia dan layanan RESTBase untuk melakukan semua rendering rumus matematika. Pengaturan bawaannya adalah:

// Tetapkan MathML sebagai opsi rendering default
$wgDefaultUserOptions['math'] = 'mathml';
$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).

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 array( 'png', '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.

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