Extension:Math
Math Sürüm durumu: kararlı |
|
---|---|
Uygulama | Etiket |
Açıklama | Matematiksel formülleri oluşturmaya izin verir |
Yazar(lar) |
|
En son sürüm | continuous updates |
Uyumluluk politikası | MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil. |
MediaWiki | >= 1.43 |
Veritabanı değişiklikleri | Evet |
Tablolar | math mathoid mathlatexml |
Lisans | GNU Genel Kamu Lisansı 2.0 veya üstü |
İndir | |
|
|
<math> |
|
Quarterly downloads | 146 (Ranked 40th) |
Public wikis using | 7,934 (Ranked 18th) |
Translatewiki.net adresinde mevcutsa, Math uzantısını çevirin | |
Sorunlar | Açık görevler · Hata bildir |
Math uzantısı, matematiksel formülleri oluşturmak için destek sağlar. Bu uzantı ile halihazırda neler yapılabileceğine dair bir genel bakış m:Help:Bir formül görüntüleme sayfasında mevcuttur.
Daha eski sürümler de dahil olmak üzere bu uzantının yüklenmesi ve yapılandırılması hakkında daha fazla bilgi Extension:Math/advancedSettings sayfasında bulunabilir.
See an overview of what can currently be done with this extension at Extension:Math/Syntax.
Kurulum
- Dosyaları indirin ve
extensions/
klasörünüzdekiMath
adlı dizine yerleştirin.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Math - LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
wfLoadExtension( 'Math' );
- Bu uzantının ihtiyaç duyduğu gerekli veritabanı tablolarını otomatik olarak oluşturacak betik güncelleme komutunu çalıştırın.
- Düz metin çıkışının ötesinde matematiği görmek için, çeşitli matematik çıkış modlarını etkinleştirmek için aşağıdaki talimatları izleyin.
- wikipedia restbase ile kullanmaya çalışırken formülleri temsil etmede sorun yaşıyorsanız, aşağıdaki yamayı kullanmayı deneyebilirsiniz.
- Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.
Vagrant kurulumu:
- Vagrant kullanıyorsanız,
vagrant roles enable math --provision
ile yükleyin
Math uzantısının tüm bileşenlerinin şimdi çalışıp çalışmadığını görmek için ayrıca Special:MathStatus sayfasına gitmelisiniz. Gördüğünüz herhangi bir sorun için en iyi seçenek https://phabricator.wikimedia.org üzerinde bir görev oluşturmaktır.
Ne yazık ki, Math uzantısıyla çalışmak için Mathoid ve RESTBase ile kurmak için iyi test edilmiş bir kılavuz yok, ancak en azından bir çalışma taslağı var. Extension:Math/RESTBase lütfen katkı sağlayın.
Ek olarak, MW1.28'de Restbase ve Mathoid ile Mediawiki Kurma ve Ayarlama Kılavuzu vardır.
Usage
Once installed, you write formulas using TeX markup syntax inside the <math>
tag. For example:
<math>E=mc^2</math>
Renders as:
Matematik görüntüleme
The type of output depends on the software that you use to read the page. Math uzantısı MathML çıkışını SVG'deki (karakterleri <path> yollarına dönüştürme) veya PNG (en azından tercihli olarak) resimlerle geri dönüşle sunmaya çalışır. Temel matematik desteği tüm tarayıcılarda çalışır. Bununla birlikte, optimum işleme için özel ayar gerekli olabilir:
- Firefox veya diğer Gecko tarayıcılar için, Yerel MathML uzantısı ve matematik yazı tiplerinin yüklenmesi gerekir.
Erişilebilirlik desteği NVDA, VoiceOver veya Orca tarafından sağlanmaktadır. Ayrıca NVDA, matematiği okumak için MathPlayer eklentisine ihtiyaç duyar. - Safari veya diğer WebKit tarayıcıları için, matematik yazı tiplerini de yükleyebilir ve bazı CSS kuralları ekleyerek yerel MathML oluşturmayı etkinleştirebilirsiniz.
Erişilebilirlik desteği VoiceOver ekran okuyucusu tarafından sağlanmaktadır ancak henüz Orca tarafından sağlanmamaktadır. - Chrome için ChromeVox üzerinden erişilebilirlik desteği veya MathJax eklentisi görsel oluşturma için tarayıcı tercihinizin özel stil sayfasına bazı CSS kuralları eklemeniz gerekir.
Önemli yapılandırma ayarlarının listesi
Ad ayarlama | Varsayılan değer | Açıklama |
---|---|---|
$wgMathValidModes | [ 'source', 'mathml' ]
|
Sunucuda izin verilen modu tanımlar. |
$wgMathDisableTexFilter | 'never'
|
Tex filtresini devre dışı bırakma seçeneği. true olarak ayarlanırsa, herhangi bir LaTeX ifadesi ayrıştırılırsa, bu potansiyel bir güvenlik riski olabilir. false olarak ayarlanırsa, yalnızca TeX komutlarının bir alt kümesine izin verilir. Ayrıntılar için Vikipedi sayfasına Yardım:Matematik'e bakın. Bu özelliği devre dışı bırakmak için "always" seçeneğini kullanın. |
$wgMathFullRestbaseURL | false | Math uzantısı, mevcutsa Görsel Düzenleyici'den varsayılan yapılandırmayı alır. Ayrıntılar. |
$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. |
Matematik çıkış modları
$wgMathValidModes ayarı, oluşturma için kullanılabilecek çıkış modlarının adlarını içeren bir diziyi tutar. Birden fazla mod etkinleştirilirse, oturum açmış kullanıcılar, kullanıcı tercihleri sayfasının görünüm bölmesinde kişisel bir tercih ayarlayabilir.
Bu modlardan hangisinin varsayılan olması gerektiğini ayarlamak için $wgDefaultUserOptions ayarını da kullanabilirsiniz, örneğin:
$wgDefaultUserOptions['math'] = 'mathml';
Mathoid
Mod: 'mathml'
Texvc girişini MathML+SVG işlemeye dönüştürmek için sunucu tarafında MathJax kullanan bir uygulama olan Mathoid ile kullanabilirsiniz. Bu en çok önerilen seçenektir; Mathoid, Vikipedi'de kullanılan Matematik oluşturma modudur.
Mathoid hizmet olarak
"Hizmet olarak Mathoid", Math uzantısı için önerilen ve varsayılan yaklaşımdır. LocalSettings.php dosyasına herhangi bir ek ayar eklemezseniz Math, tüm matematik formülü oluşturma işlemini yapmak için Wikimedia Mathoid ve RESTBase hizmetlerini kullanır. Varsayılan ayarlar şunlardır:
// MathML'yi varsayılan oluşturma seçeneği olarak ayarla
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';
Potansiyel olarak kendinizinki de dahil olmak üzere farklı Mathoid ve RESTBase hizmetlerini kullanmak için bu ayarları değiştirebilirsiniz.
Mathoid'in CLI arayüzü
Bunun yerine Mathoid'i yerel sunucuda bir komut satırı yardımcı programı olarak çalıştırabilirsiniz. Bu yaklaşımı kullanmak için aşağıdaki ayarlar önerilir:
// MathML'yi varsayılan oluşturma seçeneği olarak ayarla
$wgDefaultUserOptions['math'] = 'mathml';
// Lütfen önceden bir config.yaml oluşturun. Şablonlar Mathoid deposundadır.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// MediaWiki'nin bellek sınırını mathoid için 1,2G'ye yükseltin.
$wgMaxShellMemory = 1228800;
Mathoid cli '/path/to/mathoid/cli.js' is not executable
mesajını alırsanız, aşağıdakileri çalıştırabilirsiniz. Apache sunucusunun sistem sınırlarını değiştirmeye izin verdiğinden emin olun:
setsebool -P httpd_execmem 1 setsebool -P httpd_setrlimit 1
LaTeX
MediaWiki sürümü: | ≤ 1.39 |
Mod: 'png'
MediaWiki 1.32'den beri, bu modun çalışması için bir Mathoid sunucusu da gerekecektir. Daha eski sürümlerde, texvc ve texvccheck yüklemesi gerektirir, bu da çoğu kurulum çalışmasını gerektirebilir.
LaTeXML
Mod: 'latexml'
LaTeXML yardımcı programını kullanır. Oluşturma bir çevrimiçi hizmet aracılığıyla yapılır (varsayılan değeri https://latexml.formulasearchengine.com/convert olan $wgLaTeXMLUrl ile ayarlayın).
Native MathML
MediaWiki sürümü: | ≥ 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).
MathJax
MediaWiki sürümü: | ≥ 1.42 |
Mode: 'mathjax'
This mode works the same as Native MathML mode (generating MathML from LaTeX via PHP), but it will use MathJax 3 to render MathML. Therefore it will work for browsers that do not have MathML support, with the overhead of loading MathJax library (bundled in Math extension) on page views.
Oluşturma yok
Mod: 'source'
Bu mod, Latex girişini oluşturmadan iletir ve onu $ :formula $ ile çevrili <span>
bir öğe içinde sunar.
Yalnızca ham latex formülünü istiyorsanız $wgMathDisableTexFilter ile 'always' ayarladığınızdan emin olun (aşağıya bakın), aksi takdirde PNG tasvirlerinin başarısız kontrolü nedeniyle bir hata görünecektir.
İzleme kategorileri
Uzantı, hataları ve kullanımdan kaldırılan özellikleri tespit etmek için bir dizi izleme kategorisi oluşturur.
Their message keys begin with math-
.
Administrators may change a tracking category's name in a wiki by editing the message's value in that wiki's MediaWiki namespace.
Special:TrackingCategories shows each tracking category's name, message key, and description.
MediaWiki sayfası | Varsayılan | Açıklama |
---|---|---|
MediaWiki:Math-tracking-category-error | Category:Pages with math errors | Formülde oluşturma işleminin başarısız olmasına neden olan bir sözdizimi hatası olan sayfalar |
MediaWiki:Math-tracking-category-render-error | Category:Pages with math render errors | İşleme hattında oluşturmanın başarısız olmasına neden olan geçici bir hatanın olduğu sayfalar. Bunlar normalde kendilerini düzeltir |
MediaWiki:Math-tracking-category-texvc-deprecation | Category:Pages that use a deprecated format of the math tags | $ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor gibi kullanımdan kaldırılmış texvc sözdizimini kullanan sayfalar, sırasıyla daha standart LaTeX \$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed) ile değiştirilmelidir. Extension:Math/Roadmap sayfasına bakın.
|
MediaWiki:Math-tracking-category-mhchem-deprecation | Category:Pages that use a deprecated format of the chem tags |
Kullanımdan kaldırılan işaretleme, Extension:Math/Yol Haritası#Adım 1 Bölüm C: mhchem sözdiziminin manüel olarak düzeltilmesi'ne bakın. |
İpuçları ve püf noktaları
- Formülleri Microsoft Word (video) gibi diğer uygulamalara veya g(Math) eklentisine (video) sahip Google dokümanlarına kopyalamak için Firefox MathML copy addonu kullanabilirsiniz
<math>
öğesineforcemathmode
özniteliğini ekleyerek, kullanıcının tercih ettiği ve varsayılan oluşturma modunu geçersiz kılabilirsiniz. ör. işlenmekte olan bir resmi zorlamak için<math forcemathmode="png">...</math>
.- Oluşturulan formülün tüm resimleri bir önbellekte saklanır ve sayfa görüntülendiğinde veya düzenlendiğinde otomatik olarak yeniden oluşturulmaz. Bir sayfanın tüm formüllerinin yeniden oluşturulmasını zorlamak için,
?action=purge&mathpurge=true
eylemini kullanarak temizleyin. Örneğin, URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true tr:İntegral maddesini yeniden oluşturulmasını zorunlu kılacaktır. Daha sonra formüllerin yeni oluşturulan resimlerin gerçekten indirilmesi için tarayıcı önbelleğinizi atlamanız gerekir.
Hata bildirme
Math uzantısında bir sorun varsa, bunu Phabricator'da bildirebilirsiniz. Ek olarak, sorunuzun CoverageTest sayfasından oluşturulan otomatik birim testleriyle nasıl ilişkili olduğunu kontrol etmelisiniz.
Daha fazla okuma
Eski sürümler ve daha fazla bilgi için Extension:Math/advancedSettings sayfasına bakın.
Alt sayfalar
- Math/Announcement
- Math/CoverageTest
- Math/CustomizationHook
- Math/Displaystyle
- Math/Hooks/MathAfterTexvc
- Math/Hooks/MathFormulaPostRender
- Math/Hooks/MathFormulaRendered
- Math/Hooks/MathRenderingResultRetrieved
- Math/Inputtypes
- Math/MathJaxMenu
- Math/MathJax testing
- Math/Native MathML/Reported Cases
- Math/Native MathML rollout (2024)
- Math/Popups
- Math/RESTBase
- Math/Roadmap
- Math/Syntax
- Math/T140217
- Math/T167569
- Math/T1835557
- Math/T183559
- Math/T218295
- Math/T247697
- Math/T305613
- Math/T317065
- Math/T32215
- Math/T325625
- Math/T334842
- Math/T350004
- Math/T350737
- Math/T363081
- Math/T366983
- Math/T375241
- Math/T375244
- Math/T375317
- Math/T86450
- Math/T87007
- Math/TeX-header
- Math/Torture Test
- Math/Unique Ids
- Math/Url2Image
- Math/Wikibooks-20160516
- Math/additionalAnnotationTypes
- Math/advancedSettings
- Math/annotation.js
- Math/bug/35189
- Math/bug/38641
- Math/bug/48032
- Math/bug/49210
- Math/bug/54818
- Math/bug/69554
- Math/bug/75285
- Math/chemrm
- Math/math table
- Math/mathlatexml table
- Math/mathoid table
- Math/modifyMenu.js
- Math/newFeatures
Ayrıca bakınız
- Extension:Math/Roadmap
- Mathoid
- Extension:SimpleMathJax - texvc veya LaTeX olmadan viki üzerinde matematiksel formülleri oluşturmak için destek sağlamanın alternatif bir yolu
- Texvc PHP Alternative
- Manual:Enable TeX/problems
- Manual:Math
Bu uzantı bir veya daha fazla Wikimedia projelerinde kullanılıyor. Bu, muhtemelen uzantının kararlı olduğu ve bu tür yüksek trafikli web siteleri tarafından kullanılacak kadar iyi çalıştığı anlamına gelir. Nerede kurulduğunu görmek için bu uzantının adını Wikimedia'nın CommonSettings.php ve InitialiseSettings.php yapılandırma dosyalarında arayın. Belirli bir vikide yüklü olan uzantılar listesinin tamamı vikinin Special:Version sayfasında görülebilir. |
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |
- Stable extensions/tr
- Tag extensions/tr
- GPL licensed extensions/tr
- Extensions in Wikimedia version control/tr
- GetPreferences extensions/tr
- LoadExtensionSchemaUpdates extensions/tr
- MaintenanceRefreshLinksInit extensions/tr
- ParserAfterTidy extensions/tr
- ParserFirstCallInit extensions/tr
- ParserOptionsRegister extensions/tr
- ResourceLoaderGetConfigVars extensions/tr
- SpecialPage initList extensions/tr
- UserGetDefaultOptions extensions/tr
- WikibaseClientDataTypes extensions/tr
- WikibaseRepoDataTypes extensions/tr
- All extensions/tr
- Extensions bundled with MediaWiki 1.38/tr
- Extensions used on Wikimedia/tr
- Extensions included in BlueSpice/tr
- Extensions included in Canasta/tr
- Extensions included in Fandom/tr
- Extensions included in Miraheze/tr
- Extensions included in ProWiki/tr
- Extensions included in Telepedia/tr
- Extensions included in wiki.gg/tr
- Extensions included in WikiForge/tr
- TeX/tr
- Math display extensions/tr
- Extensions with VisualEditor support/tr