Extension:Math

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Math and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎magyar • ‎polski • ‎português do Brasil • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
Math
Sürüm durumu: kararlı
ExtensionMath (cropped).png
Uygulama Etiket
Açıklama Matematiksel formülleri oluşturmaya izin verir
Yazar(lar)
  • Moritz Schubotz,
  • Tomasz Wegrzanowski,
  • Brion Vibber
  • ve diğerleri
En son sürüm continuous updates
MediaWiki 1.25+
Veritabanı değişiklikleri Evet
Tablolar math
mathoid
mathlatexml
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
  • $wgMathEnableWikibaseDataType
  • $wgMathDefaultLaTeXMLSetting
  • $wgMathWikibasePropertyIdHasPart
  • $wgMathoidCli
  • $wgMathLaTeXMLTimeout
  • $wgMathWikibasePropertyIdQuantitySymbol
  • $wgMathDisableTexFilter
  • $wgMathMathMLTimeout
  • $wgMathLaTeXMLUrl
  • $wgMathEnableExperimentalInputFormats
  • $wgMathValidModes
  • $wgMathWikibasePropertyIdDefiningFormula
  • $wgMathFullRestbaseURL
  • $wgMathMathMLUrl
  • $wgMathConcurrentReqs
  • $wgMathEnableFormulaLinks
<math>
Translatewiki.net adresinde mevcutsa, Math uzantısını çevirin
Kullanım ve sürüm matrisini kontrol edin.
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ış İngilizce Vikipedi belgelerinde 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.

Matematik görüntüleme

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. Kullandığınız cihazın yeteneklerine bağlı olarak, çıkış türü seçilir. Temel matematik desteği tüm tarayıcılarda çalışır. Bununla birlikte, optimum işleme için özel ayar gerekli olabilir:

Erişilebilirlik desteği VoiceOver ekran okuyucusu tarafından sağlanmaktadır ancak henüz Orca tarafından sağlanmamaktadır.

Kurulum

  • Vagrant kullanıyorsanız, vagrant roles enable math --provision ile yükleyin
Manüel kurulum
  • Dosyaları indirin ve extensions/ klasörünüzdeki Math adlı dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Math' );
    // Kurulum gereksinimleri ve yapılandırma ayarları için aşağıya bakın:
    
  • 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.
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work. 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.

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' (pre-July 2015: MW_MATH_MATHML)

MW 1.23 ve üstü için, sunucu tarafındaki texvc girişini MathML+SVG oluşturmaya dönüştürmek için MathJax kullanan bir Mathoid sunucusu kullanabilirsiniz. Bu en çok önerilen seçenektir; Mathoid, gelecekte Vikipedi'de kullanılacak oluşturma modudur.

Mathoid hizmet olarak

Mathoid hizmet olarak kullanmak ve performans avantajları elde etmek için aşağıdaki ayarlar önerilir:

// MathML'yi varsayılan oluşturma seçeneği olarak ayarla
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathFullRestbaseURL = 'https://en.wikipedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org/';

Kendi Mathoid sunucunuzu nasıl çalıştıracağınızla ilgili talimatlar için Mathoid'e bakın. Mart 2017 itibarıyla bunun da RESTBase sunucu/kurulum gerektireceğini unutmayın (görev T154394 sayfasına bakın).

Mathoid'in CLI arayüzü

Kurulumu muhtemelen daha kolay olan ve performansı düşürürken daha az kalıcı bellek tüketimiyle sonuçlanan Mathoid'in CLI arayüzünü 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;

If you run MediaWiki under system containing SELinux and you get Mathoid cli '/path/to/mathoid/cli.js' is not executable message from the error log, you can run

setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

to make sure the Apache server allow to change system limits.

LaTeX

Mod: 'png' (pre-July 2015: MW_MATH_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' (pre-July 2015: MW_MATH_LATEXML)

LaTeXML yardımcı programını kullanır. Oluşturma, çevrimiçi bir hizmet üzerinden yapılır (varsayılan bir değere sahip $wgLaTeXMLUrl ile ayarlanır).

Oluşturma yok

Mod: 'source', (pre-July 2015: MW_MATH_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.

MathJax

Uyarı Uyarı: İstemci tarafı MathJax işleme modu MediaWiki 1.26'da kaldırılmıştır. Bir alternatif için Extension:SimpleMathJax sayfasına bakın.

Önemli yapılandırma ayarlarının listesi

Ad ayarlama Varsayılan değer Açıklama
$wgMathValidModes array( 'png', '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.

İzleme kategorileri

Uzantı, hataları ve kullanımdan kaldırılan özellikleri tespit etmek için bir dizi izleme kategorisi oluşturur. Kategorilerin tam adı MediaWiki ad alanındaki sayfalara göre belirlenir.

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> öğesine forcemathmode ö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>.

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

Ayrıca bakınız