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.
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
The following variables can be defined in LocalSettings.php
after calling:
require_once "$IP/extensions/Math/Math.php";
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 |
Alternate rendering
CSS for visual rendering of MathML
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: However, you can force visual rendering with the following MediaWiki stylesheets:
.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!Userscript renderers
It is also possible to use other client-side renderers, according to the comments of phab:T99369. None of these options should be actually deployed for general users; they are just for side-stepping parts of the current pipeline for experimentation.
- JS script for client-side MathJax, interpreting math code directly: phab:T99369#1482730.
- JS script for client-side MathJax, interpreting MathML: phab:T99369#1484437.
- JS script for client-side KaTeX, interpreting either TeX code embedded in MathML, or raw "text mode" TeX code: phab:T99369#1484437.
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);
}