Jump to content

Ekstensi:Math

Issue tracker: #Math
From mediawiki.org
This page is a translated version of the page Extension:Math and the translation is 95% complete.
Languages:
Ekstensi MediaWiki
Math
Status rilis stabil
Implementasi Tag
Deskripsi Memungkinkan untuk menampilkan rumus matematika
Perancang awal
  • Moritz Schubotz,
  • Tomasz Wegrzanowski,
  • Brooke Vibber,
  • Johannes Stegmüller,
  • André Greiner-Petter,
  • dan lain-lain
Versi terbaru continuous updates
Kebijakan kompatibilitas Snapshots releases along with MediaWiki. Master is not backward compatible.
Perubahan basis data Ya
Tabel math
mathoid
mathlatexml
Lisensi Lisensi Publik Umum GNU 2.0 atau lebih baru
Unduh
Unduh ekstensi
Git [?]:
Parameter
  • $wgMathEnableWikibaseDataType
  • $wgMathDefaultLaTeXMLSetting
  • $wgMathUseInternalRestbasePath
  • $wgMathMathMLUrl
  • $wgMathFullRestbaseURL
  • $wgMathTexVCService
  • $wgMathInternalRestbaseURL
  • $wgMathConcurrentReqs
  • $wgMathTexMaxLength
  • $wgMathValidModes
  • $wgMathWikibasePropertyIdSymbolRepresents
  • $wgMathEntitySelectorFallbackUrl
  • $wgMathoidCli
  • $wgMathWikibasePropertyIdQuantitySymbol
  • $wgMathDisableTexFilter
  • $wgMathSvgRenderer
  • $wgMathWikibasePropertyIdInDefiningFormula
  • $wgMathWikibasePropertyIdHasPart
  • $wgMathEnableFormulaLinks
  • $wgMathWikibasePropertyIdDefiningFormula
  • $wgMathMathMLTimeout
  • $wgMathLaTeXMLUrl
  • $wgMathLaTeXMLTimeout
  • $wgMathEnableExperimentalInputFormats
Tag
‎<math>
Hooks used
Hooks provided
Quarterly downloads 154 (Ranked 44th)
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.

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

Lihat selayang pandang dari apa yang saat ini telah dilakukan dengan ekstensi ini pada Ekstensi:Math/Sintaks.

Instalasi

This extension comes with MediaWiki 1.38 and above. Jadi Anda tidak perlu mengunduhnya lagi. Akan tetapi, Anda masih perlu mengikuti instruksi lain yang diberikan.
  • 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' );
  • Jika Anda menggunakan versi MediaWiki sebelum 1.42, jalankan skrip update.php untuk membuat tabel basis data yang diperlukan. Ini tidak diperlukan lagi jika Anda telah memasang Math pada MediaWiki 1.42+.
  • 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.

Penggunaan

Saat dipasang, Anda menulis rumus-rumus dengan sintaks markup TeX di dalam tag ‎<math>. Misalnya: 

<math>E=mc^2</math>

Ditampilkan sebagai:

E=mc2

Melihat matematika

Tipe keluaran bergantung pada perangkat lunak yang Anda gunakan untuk membaca halaman. Jika bisa, ekstensi Math mengeluarkan MathML. Selain itu, ekstensi ini mengeluarkan gambar dalam SVG (mengonversi karakter ke elemen <path>) atau PNG. Dukungan matematika dasar bekerja untuk semua peramban. Namun, untuk hasil terbaik, Anda mungkin perlu melakukan penyetelan khusus:

Pengaturan konfigurasi

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 Anda dapat memilih untuk menggunakan jalur RESTBase internal alih-alih $wgMathFullRestbaseURL dan $wgVisualEditorFullRestbaseURL. Atur false jika Anda ingin menggunakan RESTBase eksternal dalam bentuk apa pun.

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'

Peringatan Peringatan Mathoid is no longer actively developed in favor of Native MathML mode. Akan dihentikan.

Anda dapat menggunakan Mathoid, sebuah aplikasi yang menggunakan MathJax di sisi peladen untuk mengonversi masukan texvc menjadi rendering MathML+SVG. Mathoid saat ini menjadi mode penampil Math yang digunakan pada 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';
Peringatan Peringatan Wikimedia plans to discontinue RESTBase services including the Mathoid endpoint used by Math extension by default, though there is no specific EOL date yet. For sites using newer MediaWiki versions, Native MathML mode is recommended instead.

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'

Mode ini akan menghasilkan MathML dari LaTeX melalui PHP tanpa Mathoid. Catat bahwa mode ini tidak memiliki gambar cadangan, jadi rumus hanya akan ditampilkan secara benar juga peramban mendukung MathML. Firefox dan Safari memperkenalkan dukungan MathML lebih dulu (2006 dan 2008), tapi dukungan pada peramban berbasis Chromium adalah tambahan yang jauh lebih baru (Chrome 109, dirilis pada 2023).

MathJax

Versi MediaWiki:
≥ 1.42

Mode: 'mathjax'

Mode ini bekerja sama seperti mode Native MathML (menghasilkan MathML dari LaTeX melalui PHP), tapi menggunakan MathJax 3 untuk menampilkan MathML. Oleh karena itu, mode ini akan bekerja pada peramban yang tidak memiliki dukungan MathML, dengan tambahan pemuatan pustaka MathJax (dipadukan dalam ekstensi Math) pada tampilan halaman.

Peringatan Peringatan Sebelumnya, mode MathJax didasarkan pada MathJax 2 yang disediakan oleh Media Wiki 1.19-1.25. To use MathJax to render formulas in MediaWiki 1.26-1.41, see Extension:SimpleMathJax .

Tanpa penampil

Mode: 'source'

Mode ini akan meneruskan masukan Latex tanpa penampil, menyajikan dalam elemen ‎<span>, dikelilingi oleh $ :formula $.

Pastikan untuk mengatur $wgMathDisableTexFilter ke 'always' (lihat di bawah) jika Anda hanya ingin rumus latex mentah, jika tidak, galat akan muncul karena gagak memeriksa gambar PNG.

Kategori pelacak

Ekstensi ini menghasilkan beberapa kategori pelacak untuk mendeteksi galat dan fitur usang. Their message keys begin with math-. Administrator dapat mengubah nama kategori pelacakan di wiki dengan mengedit nilai pesan di ruang nama MediaWiki wiki itu. Special:TrackingCategories shows each tracking category's name, message key, and description.

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.

Tip dan trik

  • Anda dapat menggunakan add on MathML copy Firefox untuk menyalin rumus-rumus ke aplikasi lain, seperti Microsoft Word (video), atau Google Docs dengan pligin g(Math) (video).
  • Anda dapat membatalkan mode penampil yang lebih disukai pengguna atau bawaan dengan menambahkan atribut forcemathmode pada elemen ‎<math>. Misalnya, untuk memaksa menampilkan gambar, <math forcemathmode="png">...</math>.
  • Semua gambar yang menampilkan rumus disimpan pada tembolok dan tidak secara otomatis dibuat ulang jika halaman ditampilkan atau disunting. Untuk memaksa rekacitra kembali pada sema rumus pada suatu halaman, bersihkan dengan aksi ?action=purge&mathpurge=true. Misalnya, URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true akan memaksa rekacitra kembali pada artikel w:Integral. Setelah itu, Anda harus memotong tembolok peramban Anda agar gambar yang baru dibuat dari rumus-rumus akan benar-benar diunduh.

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

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:Math/id&oldid=7244592"