mozilla
Os seus resultados da pesquisa

    Criação de MathML

    Esta tradução está incompleta. Ajude atraduzir este artigo.

    Essa página explica como escrever expressões matemáticas utilizando a linguagem MathML. Da mesma forma que HTML, MathML é descrita por meio de tags e atributos. HTML torna-se mecânico quando seu documento possui estruturas avançadas como listas e figuras mas, felizmente, existem vários geradores apartir de notações simplificadas, editores gráficos (WYSIWYG) e gerenciadores de conteúdo para ajudar a escrever páginas web.

    Notação matemática é ainda mais complexa com estruturas como fração, raízes e matrizes que muito provavelmente precisam de sua própria tag. Como uma consequência, boas ferramentas para criação de MathML são ainda mais importante. Em particular, a comunidade MathML da Mozilla tem desenvolvido TeXZilla, uma biblioteca Javascript que convert LaTeX para MathML para cenários como os descritos aqui. Essa lista não possui o objetivo de ser exaustiva e convidamos-o para visitar a lista de softwares da W3C sobre MathML que possui várias outras ferramentas.

    Note que por projeto, MathML é bem integrado ao HTML5 e em particular você pode utilizar outras ferramentas/especificações Web como CSS, DOM, Javascript e SVG. Está fora do escopo deste documento mas qualquer leitor com um conhecimentos básicos da linguagem Web não terá dificuldade de misturar essas tecnologias com MathML. Verifique nossos demos e referência sobre MathML para maiores detalhes.

    Usand MathML

    MathML em paginas HTML

    Você pode utilizar o modo de apresentação do MathML dentro de documentos HTML5:

    <!DOCTYPE html>
    <html>
    <head>
     <title>MathML em documentos HTML5</title>
    </head>
    <body>
    
      <h1>MathML em documentos HTML5</h1>
    
      <p>
        A raiz quadrada de dois:
        <math>
          <msqrt>
            <mn>2</mn>
          </msqrt>
        </math>
      </p>
    
    </body>
    </html> 

    O modo de conteúdo do MathML ainda não é suportada por nenhum navegador. É recomendado que você converta suas equações no modo de conteúdo do MathML antes de publicá-las, por exemplo utilizando a ajuda da folha de estilo ctop.xsl. Ferramentas mencionadas nessa página produzem equações no modo de apresentação do MathML.

    Fallback para Navegadores sem suporte a MathML

    Infelizmente, alguns navegadores não são capazes de renderizar MathML ou possuem um suporte bastante limitado. Nesses casos, você deve detectar o navegador utilizado e carregar uma biblioteca de polyfill se necessário. Por exemplo, o trecho de código Javascript permite detectar os motores de renderização com suporte a MathML (Gecko and WebKit):

    var ua = navigator.userAgent;
    var isGecko = ua.indexOf("Gecko") > -1 && ua.indexOf("KHTML") === -1 && ua.indexOf('Trident') === -1;
    var isWebKit = ua.indexOf('AppleWebKit') > -1 && ua.indexOf('Chrome') === -1;
    

    O exemplo anterior não é o método mais confiável e pode parar de funcionar devido a mudança nas versões dos motores de renderização. Uma alternativa é implementar a detecção de suporte a MathML, por exemplo, pelo suporte ao elemento mspace:

     function hasMathMLSupport() {
      var div = document.createElement("div"), box;
      div.innerHTML = "<math><mspace height='23px' width='77px'/></math>";
      document.body.appendChild(div);
      box = div.firstChild.firstChild.getBoundingClientRect();
      document.head.remove(div);
      return Math.abs(box.height - 23) <= 1  && Math.abs(box.width - 77) <= 1;
    }
    mathml-sniffing
    HTML Content
     <pre id="result"></pre>
    
    JavaScript Content
    var ua = navigator.userAgent;
    var isGecko = ua.indexOf("Gecko") > -1 && ua.indexOf("KHTML") === -1 && ua.indexOf('Trident') === -1;
    var isWebKit = ua.indexOf('AppleWebKit') > -1 && ua.indexOf('Chrome') === -1;
    
    function hasMathMLSupport() {
      var div = document.createElement("div"), box;
      div.innerHTML = "<math><mspace height='23px' width='77px'/></math>";
      document.body.appendChild(div);
      box = div.firstChild.firstChild.getBoundingClientRect();
      document.head.remove(div);
      return Math.abs(box.height - 23) <= 1  && Math.abs(box.width - 77) <= 1;
    }
     
    function load()
    {
      document.getElementById("result").textContent = "Result in your browser:\n\n  isGecko: " + isGecko + "\n  isWebKit: " + isWebKit + "\n  hasMathMLSupport(): " + hasMathMLSupport();
    }
    
    window.addEventListener("load", load, false);
    

    Recomendamos utilizar MathJax como a biblioteca de polyfill para MathML. Por exemplo, adicionando o código Javascript abaixo no cabeçalho do seu documento ou em um arquivo Javascript externo para carregar MathJax em navegadores que não utilizam Gecko:

    if (!isGecko) {
      var s = document.createElement("script");
      s.src = "http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=MML_HTMLorMML";
      document.head.appendChild(s);
    }

    Note que MathJax é um grande biblioteca Javascript e em algumas situações você pode preferir uma pequena folha de estilo mathml.css limitado apenas a construções matemáticas básicas. Por exemplo, para carregar essa folha de estilo em navegadores que não suportam MathML:

    if (!hasMathMLSupport()) {
      var s = document.createElement("link");
      s.href = "http://fred-wang.github.io/mathml.css/mathml.css";
      s.rel = "stylesheet";
      document.head.appendChild(s);
    }
    

    Fontes Matemáticas

    Nota: navegadores podem utilizar apenas um conjunto limitado de fontes matemáticas para desenhar operadores MathML. Entretanto, implementação da tabela OpenType MATH encontra-se em progresso para Gecko e WebKit. Isso irá proporcionar suporte genérico para fontes matemáticas e simplificar a configuração descrita nessa sessão.

    Para obter uma boa renderização matemática em navegadores, algumas fontes com suporte a MathML são necessárias. É uma boa idéia proporcionar a seus visitantes um link para a página do MDN explicando como instalar fontes com suporte a MathML. Alternativamente, você pode torná-las disponível como fontes Web. Você pode obter essas fontes através do plugin de fontes com suporte a MathML; o arquivo xpi é apenas um zip que você pode baixar e extrair com o seguinte comando:

    wget https://addons.mozilla.org/firefox/downloads/latest/367848/addon-367848-latest.xpi -O mathml-fonts.zip; \
    unzip mathml-fonts.zip -d mathml-fonts

    Então copie o diretório mathml-fonts/resource/ para algum lugar no seu Web site e garanta que o arquivo woff é disponibilizado com o MIME type correto. Finalmente, inclua a folha de estilo mathml-fonts/resource/mathml.css na sua página Web, por exemplo, adicionando a seguinte regra na folha de estilo padrão do seu Web site:

    @import url('/path/to/resource/mathml.css');

    Então você precisa modificar a família de fontes dos elementos <math> e, para Gecko, o pseudo-elemento ::-moz-math-stretchy também. Por exemplo, para utilizar fontes STIX:

    math {
      font-family: STIXGeneral;
    }
    
    ::-moz-math-stretchy {
      font-family: STIXNonUnicode, STIXSizeOneSym, STIXSize1, STIXGeneral;
    }
    

    Utilize o teste MathML para comparar a renderização de várias fontes e regras de CSS para selecionar a que mais lhe agrada.

    MathML in XML documents (XHTML, EPUB, etc)

    Nota: a maioria dos leitores EPUB não suportam EPUB3 ainda mas se você desejar utilizá-lo sem compatibilidade com a versão anterior você apenas precisa da seção anterior:

    "The XHTML document type defined by this specification is based on W3C [HTML5], and inherits all definitions of semantics, structure and processing behaviors from the HTML5 specification unless otherwise specified." From EPUB Content Documents 3.0.

    Se por alguma razão você precisa utilizar MathML em documentos XML, tenha certeza de satisfazer as requisições usuais: documento bem formatado, uso correto do MIME type, MATHML namespace "http://www.w3.org/1998/Math/MathML" na raiz <math>. Por exemplo, a versão XHTML do exemplo anterior corresponde a:
     

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN"
      "http://www.w3.org/Math/DTD/mathml2/xhtml-math11-f.dtd">
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
     <title>Exemplo XHTML+MathML</title>
    </head>
    <body>
    
    <h1>Exemplo XHTML+MathML</h1>
    
      <p>
        Raíz quadrada de dois:
        <math xmlns="http://www.w3.org/1998/Math/MathML">
          <msqrt>
            <mn>2</mn>
          </msqrt>
        </math>
      </p>
    
    </body>
    </html> 

    Note que se você estiver utilizando MathML com um documento .mml ou .svg ou dentro de um EPUB, nem sempre será possível de utilizar MathJax como a biblioteca de polyfill para motores de renderização que não suportam MathML. A forma como MathML é processada irá variar de acordo com a ferramenta para ler o documento.

    MathML em clientes de email e messange instantânea

    Clientes de email modernos podem enviar e receber emails no fomato HTML5 e podem utilizar expressões em MathML. Certifique-se de ter as opções "enviar como HTML" e "visualizar como HTML" habilitadas. No Thunderbird, você pode utilizar o comando "Inserir HTML" para colar o seu código HTML+MathML. MathBird é um plugin conveniente para Thunderbird que adiciona expressões em MathML expressions utilizando como entrada texto no formato AsciiMath. Novamente, a maneira como MathML é tratado e a qualidade da renderização  dependerá do cliente de email. Mesmo que seu navegador suporte MathML, seu Webmail pode prevenir que você envie e receba emails contendo MathML.

    Em teoria, clientes de mensagens instantâneas baseados no Gecko podem integrar uma das bibliotecas Javascript para converer texto em MathML mencioandas na próxima seção para renderizar expressões em MathML. Por exemplo existe o plugin InstantBird para lidar com expressões em LaTeX.

    Conversion from a Simple Syntax

    There are many simple notations (e.g. wiki or markdown syntaxes) to generate HTML pages. The same is true for MathML: for example ASCII syntaxes as used in calculators or the more powerful LaTeX language, very popular among the scientific community. In this section, we present some of these tools to convert from a simple syntax to MathML.

    • pros:
      • Writing mathematical expressions may only require a standard text editor.
      • Many tools are available, some of them are compatible with the classical LaTeX-to-pdf workflow.
      • This gives access to advanced features of LaTeX like macros.
    • cons:
      • This may be harder to use: people must learn a syntax, typos in the code may easily lead to parsing or rendering errors etc
      • The interface is not user-friendly: only code editor without immediate display of the mathematical expression.
      • None of the syntax has been standardized, making cross-compatibility between converters difficult. Even the popular LaTeX language keeps having new packages added.

    Client-side Conversion

    In a Web environment, the most obvious method to convert a simple syntax into a DOM tree is to use Javascript and of course many libraries have been developed to perform that task.

    • pros:
      • This is very easy setup: only a few Javascript and CSS files to upload and/or a link to add to your document header.
      • This is a pure Web-based solution: everything is done by the browsers and no other programs must be installed or compiled.
    • cons:
      • This won't work if the visitor has Javascript disabled.
      • The MathML code is not exposed to Web crawlers (e.g. those of math search engines or feed aggregators). In particular, your content won't show up properly on Planet.
      • The conversion must be done at each page load, may be slow and may conflict with the HTML parsing (e.g. "<" for tags or "$" for money amounts)
      • You may need to synchronize the Javascript converter with other Javascript programs on your page.

    TeXZilla has an <x-tex> custom element, that can be used to write things like

    <x-tex>\frac{x^2}{a^2} + \frac{y^2}{b^2} = 1</x-tex>

    and get it automatically converted into MathML. This is still a work-in-progress, but could be improved in the future thanks to Web Components and shadow DOM. Alternatively, you can use the more traditional Javascript parsing of expressions at load time as all the other tools in this section do.

    One simple client-side conversion tools is ASCIIMathML. Just download the ASCIIMathML.js script and copy it to your Web site. Then on your Web pages, add a <script> tag to load ASCIIMathML and the mathematical expressions delimited by ` (grave accent) will be automatically parsed and converted to MathML:

    <html>
    <head>
    ...
    <script type="text/javascript" src="ASCIIMathML.js"></script>
    ...
    </head>
    <body>
    ...
    <p>blah blah `x^2 + y^2 = r^2` blah ...
    ...
    

    LaTeXMathML is a similar script that allows to parse more LaTeX commands. The installation is similar: copy LaTeXMathML.js and LaTeXMathML.standardarticle.css, add links in the header of your document and the LaTeX content of your Web page marked by the "LaTeX" class will be automatically parsed and converted to HTML+MathML:

    <head>
    ...
    <script type="text/javascript" src="LaTeXMathML.js"></script>
    <link rel="stylesheet" type="text/css" href="LaTeXMathML.standardarticle.css" /> 
    ...
    </head>
    
    <body>
    ...
    
    <div class="LaTeX">
    \documentclass[12pt]{article}
    
    \begin{document}
    
    \title{LaTeXML Example}
    \maketitle
    
    \begin{abstract}
    This is a sample LaTeXML document.
    \end{abstract}
    
    \section{First Section}
    
      $$ \sum_{n=1}^{+\infty} \frac{1}{n^2} = \frac{\pi^2}{6} $$
    
    \end{document}
    </div>
    ...

    jqMath is another script to parse a simple LaTeX-like syntax but which also accepts non-ASCII characters like  √{∑↙{n=1}↖{+∞} 6/n^2} = π  to write n = 1 + 6 n 2 = π . The installation is similar: download and copy the relevant Javascript and CSS files on your Web site and reference them in your page header (see the COPY-ME.html file from the zip archive for an example). One of the advantage of jqMath over the previous scripts is that it will automatically add some simple CSS rules to do the mathematical layout and make the formulas readable on browsers with limited MathML support.

    Another way to work around the lack of MathML support in some browsers is to use MathJax. However, note that you may find conflicts and synchronization issues between MathJax and the Javascript libraries previously mentioned. So if you really want to use MathJax as a MathML polyfill, you'd better use its own LaTeX/ASCIIMath parsers too. Note that on the one hand MathJax has better parsing and rendering support but on the other hand it is much bigger, more complex and slower than the previous Javascript libraries. Fortunately, you can use MathJax's CDN so that you don't need to install it on your Web server. Also, the slowest part of MathJax is currently its HTML-CSS / SVG output modes so we recommend to use the Native MathML output for Gecko-based browsers. Hence a typical configuration to use the AMS-LaTeX input is:

    ...
        <script type="text/x-mathjax-config">
          MathJax.Hub.Config({
            MMLorHTML: { prefer: { Firefox: "MML" } }
          });
        </script>
        <script type="text/javascript"
                src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
       </script>
      </head>
      <body>
       \[ \tau = \frac{x}{y} + \sqrt{3} \]
    ...
    

    Note that the dollar delimiters are not used by default. To use the ASCIIMathML input instead, just replace TeX-AMS-MML_HTMLorMML by AM-MML_HTMLorMML.  MathJax has many other features, see the MathJax documentation for further details.

    Command-line Programs

    An alternative way is to parse the simple syntax before publishing your web pages. That is, you use command-line programs to generate them and publish these static pages on your server.

    • pros:
      • You get static Web pages: the LaTeX source don't need to be parsed at each page load, the MathML code is exposed to Web crawlers and you can put them easily on any Web server.
      • Binary programs may run faster than Javascript programs and can be more sophisticated e.g. have a much complete LaTeX support or generate other formats like EPUB.
      • You can keep compatibility with other tools to generate pdf e.g. you can use the same .tex source for both latex and latexml.
    • cons:
      • This requires to install programs on your computer, which may be a bit more difficult or they may not be available on all platforms.
      • You must run the programs on your computer and have some kind of workflow to get the Web pages at the end ; that may be a bit tedious.
      • Binary programs are not appropriate to integrate them in a Mozilla extension or XUL application.

    TeXZilla can be used from the command line and will essentially have the same support as itex2MML described below. However, the stream filter behavior is not implemented yet.

    If you only want to parse simple LaTeX mathematical expressions, you might want to try tools like itex2MML or Blahtex. The latter is often available on Linux distributions. Let's consider the former, which was originally written by Paul Gartside at the beginning of the Mozilla MathML project and has been maintained by Jacques Distler since then. It's a small stream filter written in C/C++ and generated with flex and bison ; in particular it is very fast. Install flex/bison as well as the classical compiler and make tools. On Unix, you can then download itex2MML, build and install it:

    wget http://golem.ph.utexas.edu/~distler/blog/files/itexToMML.tar.gz; \
    tar -xzf itexToMML.tar.gz; \
    cd itex2MML/itex-src;
    make
    sudo make install
    

    Now suppose that you have a HTML page with TeX fragments delimited by dollars:

    input.html
    
    ...
    </head>
    <body>
      <p>$\sqrt{a^2-3c}$</p>
      <p>$$ {\sum_{i=1}^N i} = \frac{N(N+1)}{2} $$</p>
    </body>
    </html>
    

    Then to generate the HTML page input.html with TeX expressions replaced by MathML expressions, just do

    cat input.html | itex2MML > output.html

    There are even more sophisticated tools to convert arbitrary LaTeX documents into HTML+MathML. For example TeX4ht is often included in TeX distributions and has an option to use MathML instead of PNG images. This command will generate an XHTML+MathML document foo.xml from a foo.tex LaTeX source:

       mk4ht mzlatex foo.tex # Linux/Mac platforms
       mzlatex foo.tex       # Windows platform
    

    LaTeXML is another tool that is still actively developed but the release version is rather old, so you'd better install the development version. In particular, this version can generate HTML5 and EPUB documents. Here is the command to execute in order to create a foo.html Web page from the foo.tex LaTeX source:

      latexml --dest foo.xml foo.tex
      latexmlpost --dest foo.html --format=html5 foo.xml
    

    If you want to have a MathJax fallback for non-Gecko browsers, copy the Javascript lines given above into a mathjax.js file and use the --javascript parameter to tell LaTeXML to include that file:

      latexmlpost --dest foo.html --format=html5 --javascript=mathjax.js foo.xml
    

    If your LaTeX document is big, you might want to split it into several small pages rather putting everything in a single page. This is especially true if you use the MathJax fallback above, since in that case MathJax will take a lot of time to render the equations in non-Gecko browsers. Use the --splitat parameter for that purpose. For example, this will split the pages at the \section level:

      latexmlpost --dest foo.html --format=html5 --splitat=section foo.xml
    

    Finally, to generate an EPUB document, you can do

      latexmlc --dest foo.epub --splitat=section foo.xml
    

    Server-side Conversion

    • pros:
      • Conversion is done server-side and the MathML output can be cached, which is more efficient and cleaner than client-side conversion.
    • cons:
      • This might be a bit more difficult to set up, since you need some admin right on your server.

    TeXZilla can be used as a Web server in order to perform server-side LaTeX-to-MathML conversion. LaTeXML can also be used as a deamon to run server-side. Mathoid is another tool based on MathJax that is also able to perform additional MathML-to-SVG conversion.

    Instiki is a Wiki that integrates itex2MML to do server-side conversion. In future versions, MediaWiki will support server-side conversion too.

    Graphical Interface

    Input Box

    TeXZilla has several interfaces, including a CKEditor plugin used on MDN, an online demo, a Firefox add-on or a FirefoxOS Webapp. Abiword contains a small equation editor, based on itex2MML. Bluegriffon is a mozilla-based Wysiwyg HTML editor and has an add-on to insert MathML formulas in your document, using ASCII/LaTeX-like syntax.

    BlueGriffon

    WYSIYWG Editors

    Firemath is an extension for Firefox that provides a WYSIWYG MathML editor. A preview of the formula is displayed using the rendering engine of Mozilla. The generated MathML code is available at the bottom. Use the text field for token elements and buttons to build advanced constructions. Once you are done, you can save your document as a XHTML page.

    OpenOffice and LibreOffice have an equation editor (File → New → Formula). It is semi-WYSIWYG: you enter the source of the formula using the equation panel/keyboard and a preview of the formula is regularly refreshed. The editor uses its own syntax "StarMath" for the source but MathML is also generated when the document is saved. To get the MathML code, save the document as mml and open it with any text editor. Alternatively, you can extract the odf file (which is actually a zip archive) and open an xml file called content.xml.

    Open Office Math

    Amaya is the W3C's web editor, which is able to handle MathML inside XHTML documents. Use the Elements and the Special Chars panels to create various advanced mathematical constructs. Simple text such as a+2 is automatically parsed and the appropriate MathML markup is generated. Once you are done, you can directly save your XHTML page and open it in Mozilla.

    Optical Character & Handwriting Recognition

    Inftyreader is able to perform some Optical Character Recognition, including translation of mathematical equations into MathML. Other tools can do handwriting recognition such as the Windows Math Input Panel

    Windows Math Input Panel

    or the online converter Web Equation.

    Original Document Information

    • Author(s): Frédéric Wang
    • Other Contributors: Florian Scholz
    • Copyright Information: Portions of this content are © 2010 by individual mozilla.org contributors; content available under a Creative Commons license | Details.

     

    Etiquetas do documento e colaboradores

    Contribuíram para esta página: raniere
    Última atualização por: raniere,