Extension:Math/advancedSettings
Math uzantısı, Mathoid ve diğer arka uçlar aracılığıyla vikide matematiksel formüllerin işlenmesi için destek sağlar. Bu uzantı ile şu anda neler yapılabileceğine dair bir genel bakış Türkçe Vikipedi belgesinde bulunmaktadır.
 Uyarı: | Uzantının eski MediaWiki sürümlerinde yapılandırılmasına ilişkin bilgiler bu sayfadan kaldırılmıştır. Sayfa geçmişinde bulunabilir. |
Yapılandırma
Mathoid ile sunucu tarafı oluşturma
MW 1.23+ ile başlayarak, sunucu tarafındaki texvc girişini MathML+SVG oluşturmaya dönüştürmek için MathJax kullanan bir Mathoid sunucusu kullanabilirsiniz. Mathoid, gelecekteki Vikipedi'de kullanılacak oluşturma modudur. Bunun için aşağıdaki ayarlar önerilir:
// ensure 'mathml'; is added to the $wgMathValidModes array;
$wgMathValidModes[] = 'mathml';
// Set Mathoid as default rendering option;
$wgDefaultUserOptions['math'] = 'mathml';
Kendi Mathoid sunucunuzu nasıl çalıştıracağınızı öğrenmek için Mathoid'e bakın. MathML işleme modunu etkinleştirdikten sonra, gerekli tabloyu oluşturmak için veritabanı güncelleme betiğini yeniden çalıştırmanız gerekir.
LaTeXML ile sunucu tarafı oluşturma
LaTeX'i işlemek için uygun bir seçenek, LaTeXML web hizmetini kullanmaktır. Bu hizmet LaTeX'i yüksek kaliteli MathML'ye dönüştürür.
- Ayarlar (MW 1.22) 1.23+ ayarlarının çoğu veya tümü de çalışır
// Enable LaTeXML as rendering option
$wgUseLaTeXML = true; // this became an unused setting around 1.23
- Ayarlar (MW 1.23+)
$wgMathValidModes[] = 'latexml'; // adding LaTeXML as rendering option
// Set LaTeXML as default rendering option;
$wgDefaultUserOptions['math'] = 'latexml';
// Specify the path to your LaTeXML instance that converts the \TeX commands to MathML (optional)
$wgLaTeXMLUrl = 'http://example.com/';
LaTeXML'yi kendi sunucunuza kurmanız için kısa bir kılavuz burada bulunabilir: LaTeXML'yi yükleyin
LaTeXML oluşturma modunu etkinleştirdikten sonra, gerekli tabloyu oluşturmak için veritabanı güncelleme komut dosyasını yeniden çalıştırmanız gerekir.
Historical note
texvc used to be a rendering option before version 1.32. It is now completely replaced by Mathoid, but the subset of AMS-LaTeX it supports remains the basis of this extension.
Tüm yapılandırma ayarlarının listesi
Aşağıdaki değişkenler require_once "$IP/extensions/Math/Math.php"; çağrıldıktan sonra LocalSettings.php'de tanımlanabilir:
| Ad ayarlama | Varsayılan değer | Açıklama |
|---|---|---|
| $wgUseTeX | true
|
Küresel geriye dönük uyumluluk; artık hiçbir şey yapmıyor. |
| $wgTexvc | dirname( __FILE__ ) . '/math/texvc'
|
Texvc ikili dosyasının konumu (MW 1.32'de texvc'nin kaybolması nedeniyle kaldırıldı.) |
| $wgTexvcBackgroundColor | 'transparent'
|
Texvc arka plan rengi; \special işlevinde kullanılan LaTeX renk biçimini kullanın. Şeffaf arka plan için alfa şeffaflığı için "Şeffaf" değerini veya ikili şeffaflık için "şeffaf" değerini kullanın. (MW 1.32'de texvc'nin kaybolması nedeniyle kaldırıldı.) |
| $wgMathCheckFiles | true
|
Normalde matematik resimleri oluştururken, yazmak istediğimiz dizinlerin var olup olmadığını ve yeniden açmamız gerektiğinde oluşturulan dosyaların hala var olup olmadığını iki kez kontrol ederiz.
Bu, izin sorunları durumunda faydalı hata mesajları vermemizi ve kaybolan resimleri otomatik olarak yeniden oluşturmamızı sağlar. Yoğun NFS trafiği olan büyük bir sitede bu yavaş ve kesintili olabilir, bu nedenle bazen bunu false olarak ayarlayarak kısa devre yapmak isteriz. |
| $wgMathPath | false
|
Matematik dizininin URL yolu. Varsayılan değer "{$wgUploadPath}/math". |
| $wgMathDirectory | false
|
Matematik dizininin dosya sistemi yolu. Varsayılan değer "{$wgUploadDirectory}/math". |
| $wgUseMathJax | false
|
MathJax'i işleme seçeneği olarak etkinleştirir. |
| $wgMathJaxUrl | '$IP/extensions/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML'
|
http://cdn.mathjax.org/ altındaki varsayılan ayrıştırıcıyı kullanmıyorsanız MathJax URL'si. |
| $wgMathValidModes | [ 'png', 'source', 'mathml' ]
|
Sunucuda izin verilen modu tanımlar. |
| $wgMathMathMLUrl | 'https://mathoid-beta.wmflabs.org'
|
Mathoid sunucusunun url'si. |
| $wgMathMathMLTimeout | 20
|
Bir denklem oluşturmak için MathML'ye gönderilen HTTP İsteğinin saniye cinsinden zaman aşımı. |
| $wgMathLaTeXMLUrl | 'https://latexml.formulasearchengine.com/convert'
|
LaTeXML kullanımı.
Kendi sunucunuzu çalıştırmak istiyorsanız veya çalıştırmanız gerekiyorsa, bu kurulumu takip edin,
talimatları ve Ağır yük bekliyorsanız, birden çok sunucu belirtebilirsiniz. Bu durumda, her oluşturma işlemi için rastgele bir sunucu seçilir. Bir dizideki sunucuların listesini belirtin, örneğin:
|
| $wgMathLaTeXMLTimeout | 240
|
LaTeXML'ye bir denklem oluşturmak için gönderilen HTTP İsteğinin saniye cinsinden zaman aşımı. |
| $wgMathDefaultLaTeXMLSetting | [
'format' => 'xhtml',
'whatsin' => 'math',
'whatsout' => 'math',
'pmml',
'cmml',
'mathtex',
'nodefaultresources',
'preload' => [
'LaTeX.pool',
'article.cls',
'amsmath.sty',
'amsthm.sty',
'amstext.sty',
'amssymb.sty',
'eucal.sty',
'[dvipsnames]xcolor.sty',
'url.sty',
'hyperref.sty',
'[ids]latexml.sty',
'texvc'
],
'linelength': 90
}
|
Ayrıntılar için LaTeXML oluşturucu ayarı. |
| $wgMathDisableTexFilter | 'new'
|
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 Help:Bir formül görüntüleme sayfasına bakın. |
| $wgMathEnableExperimentalInputFormats | false
|
Deneysel MathML ve AsciiMath giriş biçimi desteğini etkinleştirir |
SVG geri dönüş modu ile MathML için CSS
Varsayılan olarak, MathML yalnızca erişilebilirlik araçlarına açıktır. Ancak, görsel oluşturmayı aşağıdaki MediaWiki stil sayfaları ile zorlayabilirsiniz:
.mwe-math-mathml-a11y {
clip: auto !important;
overflow: visible !important;
position: static !important;
width: auto !important;
height: auto !important;
opacity: 1 !important;
}
.mwe-math-fallback-image-inline,
.mwe-math-fallback-image-display {
display: none !important;
}
Daha sonra MathML formüllerinin stilini kolayca değiştirebilirsiniz, örn. matematik yazı tipini ayarlamak için:
.mw-body, mtext {
font-family: Latin Modern Roman;
}
math {
font-family: Latin Modern Math;
}
.mw-body,, madde metninin tamamı için aynı yazı tipi görünümünü elde etmek için eklenir. Ana yazı tipinizi değiştirmek istemiyorsanız, bunu dışarıda bırakın. Virgülü de kaldırmayı unutmayın!
Koyu arka plan için CSS
Uzantı, formülleri her zaman varsayılan olarak siyah metin olarak oluşturur; bu, koyu bir arka plan rengi çalıştıran kullanıcıları ve vikileri atabilir. Bir görünüm yazarı, CSS filtrelerini kullanarak formül resimlerinin açıklığını tersine çevirmek için aşağıdaki kodu ekleyebilir:
.mwe-math-fallback-image-inline,
.mwe-math-fallback-image-display {
filter: hue-rotate(180deg) invert(1);
}