aboutsummaryrefslogtreecommitdiff
path: root/files/pt-pt/web/mathml/element/semantics/index.html
blob: 49db97fb8eea27f4dba70ead221eb15682a95b67 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
---
title: <semantics>
slug: Web/MathML/Element/semantics
tags:
  - MathML
  - 'MathML:Element'
  - Referência de MathML
translation_of: Web/MathML/Element/semantics
---
<div>{{MathMLRef}}</div>

<div>
<p>Em MathML há duas formas de marcar a matemática: A <em>Presentation MathML</em>  (MathML de apresentação) é utilizada para controlar a apresentação das equações, enquanto o <em>Content MathML</em> (MathML de conteúdo) foi concebida para codificar o significado matemático semântico e para tornar as expressões compreensíveis para os sistemas de álgebra computacionais. Os elementos MathML <code>&lt;semantics&gt;</code>, <code>&lt;annotation&gt;</code> e <code>&lt;annotation-xml&gt;</code> são utilizados para combinar a apresentação e a marcação do conteúdo e para fornecer ambas, a informação de disposição e o significado semântico das expressões matemáticas.</p>
</div>

<p>O elemento <code>&lt;semantics&gt;</code> atua como um elemento contentor que associa anotações e então deve ter elementos (senão levanta um erro de marcação inválido). O elemento <code>&lt;annotation&gt;</code> é o elemento contentor que contem informação semântica num formato não XML, enquanto o elemento <code>&lt;annotation-xml&gt;</code> contém conteúdo num formato XML, por exemplo, <em>Content MathML</em> ou <em>OpenMath</em>.</p>

<p>As regras para determinar o elemento filho visível no elemento <code>&lt;semantics&gt;</code> são as seguintes:</p>

<ul>
 <li>Se mais nenhuma regra se aplica: O primeiro elemento filho é apresentado por pré-definição, este é suposto ser notação de apresentação.</li>
 <li>Se o primeiro filho é um elemento MathML de apresentação que não é <code>&lt;annotation&gt;</code> nem <code>&lt;annotation-xml&gt;</code>, é apresentado o primeiro filho.</li>
 <li>Se não existem elementos MathML de apresentação, apresenta o primeiro elemento <code>&lt;annotation&gt;</code> ou <code>&lt;annotation-xml&gt;</code> que seja filho do <code>&lt;semantics&gt;</code>.<br>
  Atenção que elementos de <code>&lt;annotation-xml&gt;</code> só são reconhecidos se o atributo de codificação tem um dos seguintes valores:
  <ul>
   <li><code><span id="the-code"><span class="s">"application/mathml-presentation+xml</span></span></code>"</li>
   <li><code><span id="the-code"><span class="s">"MathML-Presentation</span></span></code>"</li>
   <li><span id="the-code"><span class="s"><code>"SVG1.1</code></span></span>"</li>
   <li><code>"text/html"</code></li>
   <li><code>"image/svg+xml"</code></li>
   <li><code><span class="st">"application/xml</span></code>".</li>
  </ul>
  Note que<span id="the-code"><span class="c"> <code>"application/mathml+xml</code></span></span><code>"</code> não é mencionado aqui, já que não distingue entre MathML de apresentação ou MathML de conteúdo.</li>
</ul>

<h2 id="Atributos">Atributos</h2>

<p>Os seguintes atributos podem ser adicionados aos elementos <code>&lt;annotation&gt;</code> e <code>&lt;annotation-xml&gt;</code>:</p>

<dl>
 <dt id="attr-definitionurl">definitionURL</dt>
 <dd>A localização do símbolo da chave da anotação.</dd>
 <dt id="attr-encoding">encoding</dt>
 <dd>A codificação da informação semântica na anotação (e.g. "<code>MathML-Content</code>", "<code>MathML-Presentation</code>", "<code>application/openmath+xml</code>", "<code>image/png</code>")</dd>
 <dt id="attr-cd">cd</dt>
 <dd>O dicionário que ontem o símbolo da chave da anotação.</dd>
 <dt id="attr-name">name</dt>
 <dd>O nome do símbolo da chave da anotação.</dd>
 <dt id="attr-src">src</dt>
 <dd>A localização de uma fonte externa de informação semântica.</dd>
</dl>

<h2 id="Exemplo">Exemplo</h2>

<pre class="brush: html notranslate">&lt;math&gt;
  &lt;semantics&gt;

    &lt;!-- Presentation MathML --&gt;
    &lt;mrow&gt;
      &lt;msup&gt;
        &lt;mi&gt;x&lt;/mi&gt;
        &lt;mn&gt;2&lt;/mn&gt;
      &lt;/msup&gt;
      &lt;mo&gt;+&lt;/mo&gt;
      &lt;mi&gt;y&lt;/mi&gt;
    &lt;/mrow&gt;

    &lt;!-- Content MathML --&gt;
    &lt;annotation-xml encoding="MathML-Content"&gt;
      &lt;apply&gt;
        &lt;plus/&gt;
        &lt;apply&gt;
          &lt;power/&gt;
          &lt;ci&gt;x&lt;/ci&gt;
          &lt;cn type="integer"&gt;2&lt;/cn&gt;
        &lt;/apply&gt;
        &lt;ci&gt;y&lt;/ci&gt;
      &lt;/apply&gt;
    &lt;/annotation-xml&gt;

    &lt;!-- anotar uma imagem --&gt;
    &lt;annotation encoding="image/png" src="some/path/formula.png"/&gt;

    &lt;!-- anotar TeX --&gt;
    &lt;annotation encoding="application/x-tex"&gt;
      x^{2} + y
    &lt;/annotation&gt;

  &lt;/semantics&gt;
&lt;/math&gt;</pre>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Estado</th>
   <th scope="col">Comentário</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('MathML3', 'chapter5.html', 'Mixing Markup Languages for Mathematical Expressions') }}</td>
   <td>{{ Spec2('MathML3') }}</td>
   <td>Especificação atual</td>
  </tr>
  <tr>
   <td>{{ SpecName('MathML2', 'chapter5.html', 'Combining Presentation and Content Markup ') }}</td>
   <td>{{ Spec2('MathML2') }}</td>
   <td>Especificação inicial</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidade">Compatibilidade</h2>



<p>{{Compat("mathml.elements.semantics")}}</p>

<h2 id="Notas_para_Gecko">Notas para Gecko</h2>

<ul>
 <li>O algoritmo para determinar o elemento visível em <code>&lt;semantics&gt;</code> foi corrigido em {{geckoRelease("23")}} para ser conforme a especificação de MathML. Em versões anteriores o primeiro elemento era apresentado.</li>
 <li>No Gecko, os elementos <code>&lt;annotation&gt;</code> e <code>&lt;annotation-xml&gt;</code> são ignorados se têm o atributo <code>src</code>.</li>
</ul>