View source for Extension:Math/hu

<languages />
{{Bundled|1.38}}
{{Extension
|status          = stable
|image           = ExtensionMath (cropped).svg
|type1           = tag
|newhook1        = MathRenderingResultRetrieved
|newhook2        = MathFormulaPostRender
|author          = <nowiki/>
* Moritz Schubotz,
* Tomasz Wegrzanowski,
* Brooke Vibber,
* André Greiner-Petter
* és mások
|description     = Matematikai formulák renderelését teszi lehetővé
|version         = continuous updates
|update          = 
|version preview = 
|update preview  =
|schema-registry = Yes
|compatibility policy = rel
|download        = {{WikimediaDownload|Math|phab=EMAT}}
|mediawiki       = 
|tags            = {{tag|math|open}}
|bugzilla        = Math
|table1          = math
|table2          = mathoid
|table3          = mathlatexml
|needs-updatephp = Yes <!--Yes (until 1.41)<br>No (since 1.42)-->
|phabricator     = Math
}}
A '''Math''' kiterjesztés matematikai képletek megjelenítésére ad támogatást. A jelenleg a kiterjesztéssel elvégezhető dolgok elérhetők itt: [[m:Special:MyLanguage/Help:Displaying a formula|m:Segítség:Képletek megjelenítése]].

<div lang="en" dir="ltr" class="mw-content-ltr">
More information about installing and configuring this extension, including for older versions, can be found at {{ll|Extension:Math/advancedSettings}}.
</div>

<span id="Viewing_math"></span>
== Képletek megjelenítése ==
<span lang="en" dir="ltr" class="mw-content-ltr">The type of output depends on the software that you use to read the page.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If it can, the Math extension outputs [[w:MathML|MathML]]. Otherwise, it outputs images in SVG (converting characters to &lt;path> elements) or PNG.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Basic math support works for all browsers. But, for best results, you might need to change your settings:</span>

* <span lang="en" dir="ltr" class="mw-content-ltr">For [[w:Firefox|Firefox]] or other [[w:Gecko (software)|Gecko]] browsers, install the [https://addons.mozilla.org/firefox/addon/native-mathml/ Native MathML extension] and [https://developer.mozilla.org/docs/Mozilla/MathML_Project/Fonts math fonts].</span><br><span lang="en" dir="ltr" class="mw-content-ltr">The [[w:NonVisual Desktop Access|NVDA]], [[w:VoiceOver|VoiceOver]], and [[w:Orca (assistive technology)|Orca]] screen readers provide accessibility support.</span> <span lang="en" dir="ltr" class="mw-content-ltr">To read mathematics, NVDA needs the [[w:MathPlayer|MathPlayer]] plugin.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">For [[w:Safari (web browser)|Safari]] or other [[w:WebKit|WebKit]] browsers, you can also install math fonts and enable native MathML rendering by [[Special:MyLanguage/Extension:Math/advancedSettings#CSS for the MathML with SVG fallback mode|inserting some CSS rules]] into the custom style sheet of your browser.</span><br><span lang="en" dir="ltr" class="mw-content-ltr">The [[w:VoiceOver|VoiceOver]] screen reader provides accessibility support. The [[w:Orca (assistive technology)|Orca]] screen reader does not do so yet.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">For [[w:Google Chrome|Chrome]], you must [[Special:MyLanguage/Extension:Math/advancedSettings#CSS for the MathML with SVG fallback mode|insert some CSS rules]] into the custom style sheet of your browser to get accessibility support with the [http://www.chromevox.com/ ChromeVox] screen reader or visual rendering with the [https://chrome.google.com/webstore/detail/math-anywhere/gebhifiddmaaeecbaiemfpejghjdjmhc MathJax plugin].</span>


<span id="Installation"></span>
== Telepítés ==
{{ExtensionInstall
|vagrant=math
|repo-name=Math
|registration=required
|db-update=1
|custom-steps=
* <span lang="en" dir="ltr" class="mw-content-ltr">To see math beyond a plain text output, follow instructions below for enabling various [[Special:MyLanguage/Extension:Math/advancedSettings#Math output modes|math output modes]].</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">If you have problems for represent formulas when trying to use RESTBase, you can try using the following [https://www.mediawiki.org/w/index.php?title=Topic:Uo3kkmmop1jj9vhw&topic_showPostId=v2pfwaghxx0fmu0c#flow-post-v2pfwaghxx0fmu0c patch]</span>
}}

<span lang="en" dir="ltr" class="mw-content-ltr">You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">For any problems you see, the best option is to create a task on https://phabricator.wikimedia.org</span>
<!--TODO: Make a reasonable template (something like https://phabricator.wikimedia.org/maniphest/task/create/?template=116263 for math extension installation problems -->

<span lang="en" dir="ltr" class="mw-content-ltr">Unfortunately, there is no well tested guide on installing {{ll|Mathoid}} and {{ll|RESTBase|RESTBase}} to work with the Math extension, but there is at least a working draft.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">{{ll|Extension:Math/RESTBase}} please contribute.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
In addition, there is a [https://github.com/physikerwelt/mathoid-docs/blob/master/Guide%20for%20Installing%20and%20Setting%20up%20Mediawiki%20with%20Restbase%20and%20Mathoid.pdf Guide for Installing and Setting up MediaWiki with RESTBase and Mathoid in MW1.28].
</div>

<span id="Math_output_modes"></span>
==Matematikai kimeneti módok==
<span lang="en" dir="ltr" class="mw-content-ltr">The setting $wgMathValidModes holds an array with the names of output modes that can be used for rendering.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If multiple modes are enabled, logged-in users can set a personal preference in the appearance pane of their user preferences page.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">You can also use the $wgDefaultUserOptions setting to set which of these modes should be the default, e.g.:</span>

<syntaxhighlight lang="php">
$wgDefaultUserOptions['math'] = 'mathml';
</syntaxhighlight>

===Mathoid===
Mód: 'mathml'

<span lang="en" dir="ltr" class="mw-content-ltr">You can use [[Special:MyLanguage/Manual:Mathoid|Mathoid]], an application that uses MathJax on the server side to convert texvc input to MathML+SVG rendering.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This is the most recommended option; Mathoid is the Math rendering mode used on Wikipedia.</span>

<span id="Mathoid_as_a_service"></span>
==== Mathoid szolgáltatásként ====

<div lang="en" dir="ltr" class="mw-content-ltr">
"Mathoid as a service" is the recommended approach for the Math extension, and the default one. If you do not add any additional settings to LocalSettings.php, Math will use the Beta cluster's [[Special:MyLanguage/Mathoid|Mathoid]] and {{ll|RESTBase|RESTBase}} services to do all math formula rendering. The default settings are:
</div>

<syntaxhighlight lang="php">
// Set MathML as default rendering option
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">You can modify these settings to use different Mathoid and RESTBase services, potentially including your own.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Mathoid's CLI interface ====
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">You can instead run Mathoid as a command-line utility on the local server.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">To use this approach, the following settings are recommended:</span>

<syntaxhighlight lang="php">
// Set MathML as default rendering option
$wgDefaultUserOptions['math'] = 'mathml';
// Please create a config.yaml in advance. Templates are in the Mathoid repository.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// Raise MediaWiki's memory limit to 1.2G for mathoid.
$wgMaxShellMemory = 1228800;
</syntaxhighlight>

{{Note|1=
<div lang="en" dir="ltr" class="mw-content-ltr">
If you run MediaWiki in a system containing {{ll|SELinux}} and you get the message <code>Mathoid cli '/path/to/mathoid/cli.js' is not executable</code> in  the error log, you can run the following to make sure that the Apache server allows to change system limits:
</div>
<pre>
setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1
</pre>
}}

===LaTeX===
{{MW 1.39|and before}}
<span lang="en" dir="ltr" class="mw-content-ltr">Mode:</span> 'png'

<span lang="en" dir="ltr" class="mw-content-ltr">Since MediaWiki 1.32, this mode will also require a Mathoid server to work.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">In older versions, it requires [[Special:MyLanguage/Extension:Math/advancedSettings#Installing texvc|installing texvc and texvccheck]], which may require the most setup work.</span>

===LaTeXML===
<span lang="en" dir="ltr" class="mw-content-ltr">Mode:</span> 'latexml'

<span lang="en" dir="ltr" class="mw-content-ltr">Uses the [http://math.nist.gov/~BMiller/LaTeXML/manual/intro/ LaTeXML] utility.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The rendering is done via an online service (set with $wgLaTeXMLUrl, which has a default value of https://latexml.formulasearchengine.com/convert).</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Native MathML===
</div>
{{MW 1.40|and later}}
<span lang="en" dir="ltr" class="mw-content-ltr">Mode:</span> 'native'

<span lang="en" dir="ltr" class="mw-content-ltr">This mode will generate MathML from LaTeX via PHP ''without'' Mathoid.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Note this mode does not have image fallback, so formulas will only be displayed correctly if the browser supports MathML.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">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).</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
===No rendering===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">Mode:</span>
'source'

<div lang="en" dir="ltr" class="mw-content-ltr">
This mode will forward the Latex input without rendering, presenting it in a {{tag|span|open}} element, surrounded by $ :formula $.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Make sure to set $wgMathDisableTexFilter to 'always' (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.
</div>

<span id="List_of_significant_configuration_settings"></span>
== Lényeges konfigurációs beállítások listája ==
{| class="wikitable"
! <span lang="en" dir="ltr" class="mw-content-ltr">Setting name</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Default value</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Description</span>
|-
| {{ll|Manual:$wgMathValidModes|$wgMathValidModes}}
| <code>[ 'source', 'mathml' ]</code>
| <span lang="en" dir="ltr" class="mw-content-ltr">Defines the mode allowed on the server.</span>
|-
| {{ll|Manual:$wgMathDisableTexFilter|$wgMathDisableTexFilter}}
| <code>'never'</code>
| <span lang="en" dir="ltr" class="mw-content-ltr">Option to disable the tex filter. If set to true any LaTeX expression is parsed this can be a potential security risk. If set to false only a subset of the TeX commands is allowed. See the wikipedia page [[wikipedia:Help:Math|Help:Math]] for details.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Use "always" to disable this feature.</span>
|-
|$wgMathFullRestbaseURL
|false
| <span lang="en" dir="ltr" class="mw-content-ltr">The math extension gets the default config from the Visual Editor, if available.</span> [https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/Math/+/master/src/MathRestbaseInterface.php#182 <span lang="en" dir="ltr" class="mw-content-ltr">Details</span>].
|-
|$wgMathPreferRestbaseURL
| true
| <span lang="en" dir="ltr" class="mw-content-ltr">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.</span>
|}

<span id="Tracking_categories"></span>
== Nyomkövető kategóriák ==
A kiterjesztés több nyomkövető kategóriát is létrehoz, amivel meg lehet találni a hibákat és elavult funkciókat.
A kategóriák pontos nevét MediaWiki-névtérbeli lapok határozzák meg.

{| class="wikitable" 
|-
! MediaWiki-lap
! Alapértelmezés
! Leírás
|-
| [[MediaWiki:Math-tracking-category-error]] || [[:Category:Pages with math errors]]
| Olyan lapok, ahol a képlet szintaktikailag hibás, így nem dolgozható fel.
|-
| [[MediaWiki:Math-tracking-category-render-error]] || [[:Category:Pages with math render errors]]
| Olyan lapok, ahol feldolgozás során ideiglenes hiba akadályozta a képlet megjelenítését. Ezek a lapok normál esetben maguktól megjavulnak egy idő után.
|-
| [[MediaWiki:Math-tracking-category-texvc-deprecation]] || [[:Category:Pages that use a deprecated format of the math tags]]
| Olyan lapok, amik elavult texvc-szintaxist használnak (pl. <code>$ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor</code>). Ezeket a szabványosabb LaTeX-re kell cserélni (rendre <code>\$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed)</code>). Lásd még: {{ll|Extension:Math/Roadmap}}.
|-
| [[MediaWiki:Math-tracking-category-mhchem-deprecation]] || [[:Category:Pages that use a deprecated format of the chem tags]]
|
<span lang="en" dir="ltr" class="mw-content-ltr">Deprecated chemical markup, see [[Special:MyLanguage/Extension:Math/Roadmap#Step 1 Part C: Manual fixing of mhchem syntax|Extension:Math/Roadmap#Step 1 Part C: Manual fixing of mhchem syntax]].</span>
|}

<span id="Tips_and_tricks"></span>
== Tippek és trükkök ==
* <span lang="en" dir="ltr" class="mw-content-ltr">You can use the Firefox [https://addons.mozilla.org/de/firefox/addon/mathml-copy MathML copy addon] to copy formulae to other applications such as Microsoft Word ([https://www.youtube.com/watch?v=FDMfT27zE54 video]), or Google docs with the [https://chrome.google.com/webstore/detail/gmath/hhaencnpmaacoojogjkobikbmkhikjmm?utm_source=permalink g(Math)] plugin ([https://www.youtube.com/watch?v=KKwF6IKRkHU&hd=1 video])</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">You can override the user preferred and default rendermode by adding the <code>forcemathmode</code> attribute to the {{tag|math|open}} element. e.g. to force an image being rendered <syntaxhighlight lang=html inline><math forcemathmode="png">...</math></syntaxhighlight>.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">All images of rendered formula are stored in a cache and not automatically recreated if the page is viewed or edited.</span> <span lang="en" dir="ltr" class="mw-content-ltr">To force the re-rendering of all formulas of a page, [[Special:MyLanguage/Manual:Purge|purge]] using the <code>?action=purge&mathpurge=true</code> action.</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example the URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true will force re-rendering of the [[w:Integral]] article.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Afterwards you need to [[w:WP:Bypass your cache|bypass your browser cache]] so that the new created images of the formulas are actually downloaded.</span>

<span id="Error_reporting"></span>
== Hibabejelentés ==

<div lang="en" dir="ltr" class="mw-content-ltr">
If something is wrong with the math extension you can report that at [https://phabricator.wikimedia.org/maniphest/task/create/?projects=MediaWiki-extensions-Math Phabricator]. In addition you should check how your problem relates to the automated unit tests that are generated from the page [[Special:MyLanguage/Extension:Math/CoverageTest|CoverageTest]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Further reading ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
See {{ll|Extension:Math/advancedSettings}} for old versions and further information.
</div>

<span id="Subpages"></span>
== Allapok ==
{{subpages|Extension:Math}}

<span id="See_also"></span>
== Lásd még ==
* {{ll|Extension:Math/Roadmap}}
* {{ll|Mathoid}}
* {{ll|Extension:SimpleMathJax}} - <span lang="en" dir="ltr" class="mw-content-ltr">an alternative way to provide support for rendering mathematical formulas on-wiki, without texvc or LaTeX</span>
* {{ll|Texvc PHP Alternative}}
* {{ll|Manual:Enable TeX/problems}}
* {{ll|Manual:Math}}

{{OnWikimedia}}
{{Used by}}

[[Category:TeX{{#translation:}}]]
[[Category:Math display extensions{{#translation:}}]]
[[Category:Extensions with VisualEditor support{{#translation:}}]]