Diferenças entre edições de "Ajuda:Marcação TeX"

31 bytes removidos ,  18h27min de 12 de julho de 2008
m
ortografia
(→‎Diagramas comutativos: tradução de meta:Help:Displaying a formula#Commutative diagrams (fim da atualização, exceto possivelmente por erros menores))
m (ortografia)
O [[Wikt:software|software]], [[w:MediaWiki|MediaWiki]] usa um subconjunto de intruçõesinstruções da '''marcação [[w:TeX|TeX]]''' (incluindo algumas extençõesextensões do LaTeX e AMSLaTeX) para formulação matemática. Ele gera ou imagens [[w:PNG|PNG]] ou marcação [[w:HTML|HTML]] simples, dependendo das '''''preferências do usuário''''' e da complexidade da expressão. No futuro, a medida que os navegadores tornem-se mais inteligentes, serão capazes de gerar HTML avançado ou mesmo [[w:MathML|MathML]] em muitos casos.
==MediaWiki e TeX==
 
Mais precisamente, o MediaWiki filtra a marcação atravezatravés do [[w:en:Texvc|Texvc]], que por sua vez passa os comandos ao TeX para [[w:Renderização|renderização]]. Portanto, apenas uma parte limitada de toda a linguagem TeX é suportada; Leialeia abaixo para maiores detalhes.
O [[Wikt:software|software]],[[w:MediaWiki|MediaWiki]] usa um subconjunto de intruções da '''marcação [[w:TeX|TeX]]''' (incluindo algumas extenções do LaTeX e AMSLaTeX) para formulação matemática. Ele gera ou imagens [[w:PNG|PNG]] ou marcação [[w:HTML|HTML]] simples, dependendo das '''''preferências do usuário''''' e da complexidade da expressão. No futuro, a medida que os navegadores tornem-se mais inteligentes, serão capazes de gerar HTML avançado ou mesmo [[w:MathML|MathML]] em muitos casos.
 
Mais precisamente, MediaWiki filtra a marcação atravez do [[w:en:Texvc|Texvc]], que por sua vez passa os comandos ao TeX para [[w:Renderização|renderização]]. Portanto, apenas uma parte limitada de toda a linguagem TeX é suportada; Leia abaixo para maiores detalhes.
 
==Sintaxe==
 
Marcações matemáticas entram dentro das ''tags'': <code><nowiki><math> ... </math></nowiki></code>. A '''Barra de edição''' tem um botão para isso ([[Image:Math icon.png|Fórmula matemática (LaTeX)]]).
 
Similarmente ao HTML, no TeX espaços e "enter"s são ignorados.
 
Predefinições do MediaWiki, variáveis e parâmetros não podem ser usados dentro de ''tags'' matemáticas, veja auma [[m:Template talk:Demo of attempt to use parameters within TeX|Demonstraçãodemonstração]].
 
==Renderização==
As imagens PNG são mostradas em preto e branco (não transparente). Estas cores, assim como os tamanhos e tipos de fontes, não dependem das configurações do navegador ou CSS. Tamanhos e tipos de fontes irão muitas vezes se distinguir das que o HTML renderiza. O alinhamento vertical com o texto em volta pode também ser um problema. O '''seletor css''' das imagens é img.tex.
 
<!--It should be pointed out that most of these shortcomings have been addressed by [[m:Help talk:Formula#Maynard_Handley.27s_suggestions|Maynard Handley]], but have not been released yet.-->
 
O atributo <code>alt</code> das imagens PNG (o texto que é mostrado se seu navegador não pode mostrar imagens; Oo "Internet Explorer" as mostra no alto da caixa dentro da área da imagem) é o wikitexto que as produziu, excluindo-se <code><nowiki><math></nowiki></code> e <code><nowiki></math></nowiki></code>.
 
Diferente de nomes de funções e operadores, como é costumeiramente observado na matemática para variáveis, letras são usadas em itálico; os números não. Para outros tipos de texto, (como rótulos de variáveis), para evitar que sejam renderizados em itálico como variáveis, use <code>\mbox</code> ou <code>\mathrm</code>. Por exemplo, <code><nowiki><math>\mbox{abc}</math></nowiki></code> nos dá <math>\mbox{abc}</math>.
 
==TeX x HTML==
Antes de introduzir a marcação TeX para produzir characterescaracteres especiais, seria usual verificar que, como esta tabela de comparação mostra, que algumas vezes resultados similares podem ser produzidos com HTML.
 
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse;"
===Prós do HTML===
# Formulação com HTML em linha sempre alinha apropriadamente com o resto do texto HTML.
# A cor de fundo das formulasfórmulas, tamanho das fontes e cor do texto combinam com o resto do conteúdo em HTML e a aparência respeita a CSS e as configurações do navegador.
# Páginas que utilizam HTML serão carregadas com maior velocidade.
 
===Prós do TeX===
# O TeX é semanticamente superior ao HTML. No TeX, "<code><nowiki><math>x</math></nowiki></code>" significa "variável matemática <math>x</math>", enquanto que no HTML "<code>x</code>" pode ser qualquer coisa. A informação foi irremediavelmente perdida.
# O TeX foi especificamente desenhado para formatação de fórmulas, logo sua entrada é mais fácil e mais natural, e sua saída é mais esteticamente agradável. Também qualquer pessoa que já tenha escrito fórmulas matemáticas num nível profissional já é familiar com TeX.
# Uma consequência do tópico 1um é que o TeX pode ser transformado em HTML, mas o contrário não. Isto significa que no lado do servidor nós podemos sempre transformar uma fórmula, baseado na sua complexidade e localização no texto, preferências do usuário, tipo do navegador, etc. Portanto, onde é possível, todos os benefícios do HTML podem ser mantidos, junto com os benefícios do TeX. É verdade que a situação atual não é a ideal, mas não é uma boa razão para descartar informação/conteúdo.
# Outra consequência do ponto 1um é que TeX pode ser convertido para [[w:MathML|MathML]] em navegadores que suportam tal recurso, mantendo assim sua semântica e permitindo a renderização vetorial.
# Quando escrevendo em TeX, os editores não precisam se preocupar se esta ou aquela versão deste ou daquele navegador suporta esta ou aquela entidade HTML. A estrutura que toma decisões é colocada no servidor. Isto não é mantido na formulação HTML, que pode facilmente acabar sendo renderizada incorretamente ou com aspecto que não era aquele da intenção do editor em um navegador diferente do que este usou.
# O TeX é a linguagem de formatação preferida pela maioria dos profissinais da matemática, das ciências e das engenharias em geral. É mais fácil persuadi-los a contribuir se eles podem escrever em TeX.
 
== Funções, símbolos, caracteres especiais ==
! colspan="2" |
 
<h3>Funções padrõespadrão</h3>
|-
|<code>\sin a \cos b \tan c</code>
 
</table>
 
 
=== Expressões grandes com parênteses, colchetes, barras ===
 
</table>
 
 
== Alfabetos e fontes==
 
O [[w:Texvc|Texvc]] não pode renderizar caracteres [[w:Unicode|Unicode]] arbitrários. Aqueles que ele consegue tratar podem ser adicionados ao texto usando as expressões abaixo. Outras, tais como [[w:Alfabeto cirílico|cirílico]], podem ser adicionadas como entidades Unicode ou HTML em texto corrido, mas não podem ser usados em fórmulas.
Outras, tais como [[w:Alfabeto cirílico|cirílico]], podem ser adicionadas como entidades Unicode ou HTML em texto corrido, mas não podem ser usados em fórmulas.
 
{| class="wikitable"
 
</table>
 
 
== Cores ==
Veja [http://oregonstate.edu/%7Epeterseb/tex/samples/docs/color-package-demo.pdf todos os nomes de cores] suportados pelo LaTeX.
 
Note que a cor não deve ser usada como o único meio de identificar alguma coisa, pois essa informação se perde quando se utiliza um meio preto e branco e também para pessoas com [[w:Daltonismo|discromatopsia]]. Veja [[:en:Wikipedia:Manual of Style#Color coding]].
 
==Questões de formatação==
Se você precisa alinhá-la mesmo assim, use <tt><nowiki><font style="vertical-align:-100%;"><math>...</math></font></nowiki></tt> e experimente configurações com o argumento <tt>vertical-align</tt> até conseguir o correto; porém, a formatação pode depender do navegador e de suas configurações.
 
Ainda tenha em mente que você terá que lidar com estes problemas: se a renderização no servidor for corrigida em versões futuras, como conseqüência desta formatação manual extra suas formulasfórmulas irão de repente aparecerem formatadas incorretamente. Portanto use este recurso moderadamente.
 
=== Renderização PNG forçada ===
 
Para forçar uma fórmula a ser renderizada como PNG, adicione <tt>\,</tt> (espaço pequeno) no fim da fórmula (Ondeonde ela não está sendo renderizada). Isto forçará imagens PNG se o usuário estiver em modo "HTML apenas", mas não para o modo "HTML se possível" (as configurações de renderização matemática nas '''preferências do usuário''').
 
Você pode também pode usar <tt>\,\!</tt> (espaço pequeno e espaço negativo, com cancelar) em qualquer lugar dentro das ''tags'' matemáticas. Isto ''realmente'' força PNG mesmo em modo "HTML se possível", diferente de <tt>\,</tt>.
 
Isto pode ser útil para manter a renderização das fórmulas de um modo consistente, por exemplo, ou para corrigir fórmulas que renderizam incorretamente em HTML (uma vez, a^{2+2} renderiza com uma extra ''underscore''), ou para demonstrar como algo é renderizado quando normalmente aparece como HTML (como nestes exemplos acima).
 
Por exemplo:
 
</table>
 
 
Isto foi testado com a maioria das fórmulas desta página, e aparentemente funciona adequadamente.
Para fazer [[w:diagrama comutativo|diagramas comutativos]], há três passos:
* Escrever o diagrama em [[w:TeX|TeX]]
* Converter para [[:en:SVG|SVG]]
* [[commons:Commons:First steps/Upload form|Carregar o arquivo]] para o ''[[commons:|Wikimedia Commons]]''.
 
* O [http://www.ctan.org/tex-archive/help/Catalogue/entries/borceux.html Diagrams] de François Borceux.
 
O que segue é uma predefinição para Xy-pic, juntamente com um [[w:en:Hack (technology)|hack]] para aumentar as [[:en:Margin (typography)|margens]] em [[:en:dvips|dvips]], de modo que o diagrama não seja truncado por ''over-eager cropping'' (<!--tradução?)-->
(sugerido em [[w:en:TUGboat|TUGboat]]: [http://www.tug.org/TUGboat/Articles/tb17-3/tb52rahtz.pdf TUGboat, Volume 17 1996, No. 3]):
 
\end{document}
</source>
 
 
 
=== Converter para [[w:SVG|SVG]] ===
Sendo o diagrama um trabalho feito por você mesmo, carregue-o para o [[commons:|Wikimedia Commons]], de modo que todos os projetos (notavelmente, de todas as línguas) possam usá-lo sem ter que fazer uma cópia para uma wiki em seu próprio idioma. (Se você carregou anteriormente algum arquivo para outro lugar que não o Commons, [[w:en:Wikipedia:Moving images to the Commons|faça um transwiki]] do mesmo para o Commons.)
 
;Confira o tamanho: Antesantes de realizar o carregamento, confira se o tanhotamanho padrão da imagem não é muito grande ou muito pequeno, abrindo a mesma em alguma [[meta:SVG#Support in applications|aplicação SVG]] e vizualizando-a em seu tamanho padrão (escala de 100%), caso contrário, ajuste a opção <tt>-y</tt> para <tt>dvips</tt>.
;Nome: Tenhatenha certeza de escolher um nome [[en:Wikipedia:Naming_conventions|significativo]].
;Carregue: [[commons:Special:Userlogin|Faça Login no Wikimedia Commons]], e então <span class="plainlinks">[http://commons.wikimedia.org/w/index.php?title=Special:Upload&uselang=ownwork carregue o arquivo]</span>; No '''Sumário''', coloque uma pequena descrição.
Agora vá até a [[w:en:Help:Image page|página da imagem]] e adicione [[commons:Commons:First steps/Quality and description#Good file descriptions|uma descrição]], incluindo o '''código fonte''', usando essa predefinição:
* Inclua o código fonte na [[w:en:Help:Image page|página da imagem]], na seção <tt>Source</tt> da predefinição <tt>[[commons:Template:Information|Information]]</tt>, assim o diagrama poderá ser editado no futuro.
* Inclua o arquivo <tt>.tex</tt> completo, não apenas o fragmento, assim os futuros editores não precisarão reconstruir um arquivo compilável.
* (Não inclua ele na seção do Sumário, que como o nome indica deve ser apenas um sumário.).
;Licença: A licença mais comum para diagramas comutativos é <tt>[[commons:Template:PD-self|PD-self]]</tt>; alguns usam <tt>[[commons:Template:PD-self|PD-ineligible]]</tt>, especialmente para diagramas simples, ou outras licenças. Por favor ''não'' use a [http://www.gnu.org/copyleft/fdl.html GFDL], pois ela exige que todo o texto da licença GFDL seja anexado a qualquer documento que use o diagrama.
;Descrição: Sese possível, faça uma ligação para uma página relevante da Wikipédia relacionada ao diagrama.
;Categoria: Incluainclua <tt><nowiki>[[Category:Commutative diagrams]]</nowiki></tt>, para que a imagem apareça em [[commons:Category:Commutative diagrams]]. Existem também subcategorias, que você pode preferir usar.
;Inclua a imagem: Agora,agora inclua a imagem na página original onde a mesma deve ser utilizada através do comando <tt><nowiki>[[Image:Diagram.svg]]</nowiki></tt>
 
=== Exemplos ===
<nowiki><math>x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math></nowiki>
 
===Parênteses altos e Fraçõesfrações===
<math>2 = \left( \frac{\left(3-x\right) \times 2}{3-x} \right)</math>
Discussões, relatórios de erros e pedidos de recursos devem ser encaminhados para a [[m:Mailing list#Wikitech|lista Wikitech-l]]. Estes também podem ser arquivados no [[Bugzilla:|Mediazilla]] sob o nome de ''MediaWiki extensions''.
 
==VejaVer também==
*[[w:Wikipedia:How to write a Wikipedia article on Mathematics#Typesetting_of_mathematical_formulas|Formatação de fórmulas matemáticas]] (em inglês)
*[[w:Table of mathematical symbols|Tabela de símbolos matemáticos]]
11 788

edições