Extension:Math/id

From testwiki
Jump to navigation Jump to search

<languages /> Template:Extension 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 Template:Ll.

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

Instalasi

Template:Bundled Template:ExtensionInstall

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 Template:Ll dan Template:Ll untuk bekerja dengan ekstensi Math, tetapi setidaknya ada draf yang berfungsi. Silakan berkontribusi di Template:Ll.

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 Template:Tag. 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
Template:Ll [ 'source', 'mathml' ] Menetapkan mode yang dibolehkan di peladen.
Template:Ll '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' Template:Warning

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 Template:Ll 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';

Template:Warning

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;

Template:Note

LaTeX

Template:MW 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

Template:MW 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

Template:MW 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. Template:Warning

Tanpa penampil

Mode: 'source'

Mode ini akan meneruskan masukan Latex tanpa penampil, menyajikan dalam elemen Template:Tag, 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 Template:Ll 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 Template:Ll.
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 Template:Tag. 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 Template:Ll untuk versi lama dan informasi lebih lanjut.

Subhalaman

Template:Subpages

Lihat pula

Template:OnWikimedia Template:Used by

[[Category:TeX{{#translation:}}]] [[Category:Math display extensions{{#translation:}}]] [[Category:Extensions with VisualEditor support{{#translation:}}]]

Retrieved from "https://mediawiki.wiki.beta.math.wmflabs.org/w/index.php?title=Extension:Math/id&oldid=268"