Jump to content

Extension:Math/advancedSettings

From mediawiki.org
This page is a translated version of the page Extension:Math/advancedSettings and the translation is 70% complete.
Outdated translations are marked like this.

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";
Bu ayarların ayrı sayfalarında, bu uzantı o sürümde çekirdek mediawiki'den ayrıldığı için 1.18'de kullanımdan kaldırıldı yazıyor. Uzantıyı yüklediyseniz, bu ayarlar ne olursa olsun geçerlidir
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 $wgMathLaTeXMLUrl: [1] ile geçersiz kılın

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: $wgMathLaTeXMLUrl = [ 'http://latexml.example.com/convert', 'http://latexml2.example.com/convert' ];

$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.
$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);
}
Ton döndürme, tonları kabaca sabit tutar, böylece renkler biraz kullanışlı kalır. Bu çözüm nihai olmaya yakın değil. Daha fazla bilgi için bağlantılı göreve ve bağlantılı diğer biletlere bakın.