STI:MediaWiki:Ajuda:Formatação

Estilo e Formatação

A seguir apresentamos alguns elementos da formatação MediaWiki úteis para a elaboração de instruções em sequência.

• Convenção de linhas: uma linha de texto (ou um parágrafo, caso seu editor de texto corte as linhas para caber na tela) no formato MediaWiki não deve conter nenhum espaço em branco no início do texto para que não sejam consideradas como blocos de textos. A adoção de linhas em branco na maioria das vezes não são necessárias e podem atrapalhar se utilizadas no meio de seções com funções diferentes.

• Títulos: os títulos e subtítulos do texto são indicados usando caracteres com sinal de igual = demarcando o texto, que deve estar em uma linha separada.

• Dois caracteres de = ao redor do texto indicam um título principal. Normalmente, é usado em seções.
• Três caracteres de = ao redor do texto indicam um título secundário ou subtítulo (em fonte grande e negrito).
• Quatro indicam um título terciário, e assim por diante.

• Listas enumeradas: Uma lista numerada é feita usando o caractere # no início da linha. É proibido colocar linhas em branco dentro de uma lista numerada, sob o risco de reiniciar a numeração dos tópicos. Para manter a numeração, todas as linhas de uma lista numerada devem começar com o caractere #, incluindo linhas de subitens.

• Uma lista enumerada pode ter elementos internos (como este que você está lendo neste momento), enumerados ou não.
• Para um elemento interno enumerado, use duas cerquilhas ( ## ) para indicar o elemento, ou três ou mais para elementos numerados mais internos ainda.
• Para elementos internos não enumerados (uma lista de ações dentro do mesmo passo, por exemplo), use o caractere de lista ( * ) juntamente com a cerquilha ( #*). Colocar mais asteriscos fará com que o elemento fique mais interno ainda.

• Listas não enumeradas: uma lista não enumerada é indicada com o asterisco ( * ). Elementos mais internos são criados usando mais asteriscos.

Todas as opções acima podem ser usadas em conjunto com estilos.

• Negrito: o texto em negrito é demarcado com 3 aspas simples ( ''' )

de cada lado do texto.

• Itálico: texto em itálico é demarcado com 2 aspas simples ( '' )

de cada lado do texto.

• Tags: uma tag é um código que fica entre < e >. As tags são essenciais às linguagens HTML, XML, ColdFusion e muitas outras. Apesar do MediaWiki evitar o uso de tags, algumas são usadas. Existem dois tipos principais de tags: unárias e binárias. A tag unária é utilizada sozinha; as tags binárias são usadas em par, demarcando um trecho de texto.

Um exemplo de tag unária é o <br>

, que indica uma quebra de linha. Tags que têm efeito pontual no texto são unárias. Um exemplo de tag binária é o <br> e </br> , que indica uma seção de texto em negrito (ao invés de usar esse código, use três aspas simples sempre que possível). Tags que demarcam trechos de texto são binárias.

• Tags MediaWiki: uma tag muito utilizada é a tag binária <nowiki>

. Ela serve para dizer ao software MediaWiki para parar de interpretar os caracteres especiais ( * # [ ] , etc) como marcações wiki. Muito útil para um artigo metaWiki (uma wiki que fala sobre wikis) – como este artigo.

• Sublinhado: o efeito de sublinhado é obtido com a tag binária <ins>

.

• Marcado como removido (tachado): serve para indicar texto invalidado, mas que está mantido por motivos de entendimento. Normalmente usado em páginas de discussão (fóruns). Em edições de páginas wiki, o ideal é simplesmente remover o texto. Use a tag <del>

para demarcar o texto tachado (as tags de demarcação são binárias).

• Subescrito ou sobrescrito: use as tags <sub> ou <sup>

. Exemplo: x² e H₂O

• Tags HTML

<br>

- quebra de página. Ao final de toda linha de texto, o MediaWiki insere uma quebra, mas se você quiser inserir um espaço em branco na página, use esta tag.

• Comentários: comentários em HTML são feitos usando marcadores de tag unário especial: <!-- e -->

. O texto dentro da tag não será exibido na página; apenas na edição de seu código-fonte.

• Numeração: Os sistemas de numeração são especificados com:

:::: decimal - Números decimais, começando com 1.
:::: decimal-leading-zero - Números decimais preenchidos por zeros iniciais (por exemplo, 01, 02, 03, ..., 98, 99).
:::: lower-roman - Algarismos romanos em minúsculas (i, ii, iii, iv, v, etc.).
:::: upper-roman - Números romanos em maiúsculas (I, II, III, IV, V, etc.).
:::: lower-latin ou lower-alpha - Letras ascii em minúsculas (a, b, c, ... z).
:::: upper-latin ou upper-alpha - Letras ascii em maiúsculas (A, B, C, ... Z).

Os códigos wiki para formatar artigos

A seguir é apresentado os códigos Wiki básicos para fazer com que o texto se pareça com o que está na coluna da esquerda abaixo (efeito obtido), escreva aquilo que se encontra na coluna da direita (código). Você pode deixar esta página aberta numa janela separada do navegador para servir como referência e praticar na página de testes, ou se possuir uma conta utilizar sua página de testes pessoal.

Assim como a Wikipédia a STIWiki é uma Wiki, o que significa que qualquer pessoa lotada na STI que queira pode facilmente editar qualquer artigo e ver imediatamente as mudanças efetuadas. Esta página serve como referência para os códigos do Wiki. Para uma abordagem resumida veja: Guia de Referência Rápida - Wikipédia.

 

Texto, secções, parágrafos, listas e linhas

Resultado obtido (Publicado no Navegador)	A escrever (Editado na MediaWiki)
Cabeçalhos das secções: Nova secção Sub-secção Sub-sub-secção	== Nova secção == === Sub-secção === ==== Sub-sub-secção ====
Novo parágrafo: Um final de linha apenas é usado para separar frases dentro de um parágrafo. Um novo parágrafo é criado pressionando-se duas vezes a tecla enter, no seu teclado. Ou seja, para iniciar outro parágrafo tem de haver uma linha em branco entre as frases.	Um final de linha apenas é usado para separar frases dentro de um parágrafo. Um novo parágrafo é criado pressionando-se duas vezes a tecla ''enter'', no seu teclado. Ou seja, para iniciar outro parágrafo tem de haver uma linha em branco entre as frases.
Quebrar linhas: Você pode quebrar linhas sem começar um novo parágrafo.	Você pode quebrar linhas<br /> sem começar um novo parágrafo.
Lista com marcadores: Listas são fáceis de fazer: comece cada linha com um asterisco mais asteriscos significam níveis mais profundos	* Listas são fáceis de fazer: ** comece cada linha com um asterisco ** mais asteriscos significam níveis mais profundos
Listas mistas: Listas mistas and nest them like this definitions work: apple banana fruits	* Listas mistas *# and nest them *#* like this *#*; definitions *#*: work: *#*; apple *#*; banana *#*: fruits
Lista numerada: Listas numeradas também são boas aqui está um item aqui está um sub-item e aqui outro Mas lembre-se que o símbolo tem de estar completamente encostado à esquerda.	# Listas numeradas também são boas # aqui está um item ## aqui está um sub-item ## e aqui outro #Mas lembre-se que o símbolo # tem de estar completamente encostado à esquerda.
Lista numerada sequencial: About the author Foreword to the first edition Foreword to the second edition	# Lista numerada sequencial <ol style="list-style-type:lower-roman"> <li>About the author</li> <li>Foreword to the first edition</li> <li>Foreword to the second edition</li> </ol>
Lista numerada sequencial incremental: item item item item item item item item item item item item	# Lista numerada sequencial incremental <OL> <!-- (set item[0] to 0 --> <LI>item <!-- increment item[0] (= 1) --> <LI>item <!-- increment item[0] (= 2) --> <OL> <!-- (set item[1] to 0 --> <LI>item <!-- increment item[1] (= 1) --> <LI>item <!-- increment item[1] (= 2) --> <LI>item <!-- increment item[1] (= 3) --> <OL> <!-- (set item[2] to 0 --> <LI>item <!-- increment item[2] (= 1) --> </OL> <!-- ) --> <OL> <!-- (set item[3] to 0 --> <LI>item <!-- increment item[3] (= 1) --> </OL> <!-- ) --> <LI>item <!-- increment item[1] (= 4) --> </OL> <!-- ) --> <LI>item <!-- increment item[0] (= 3) --> <LI>item <!-- increment item[0] (= 4) --> </OL> <!-- ) --> <OL> <!-- (reset item[4] to 0 --> <LI>item <!-- increment item[4] (= 1) --> <LI>item <!-- increment item[4] (= 2) --> </OL>
Lista combinada: Você pode até mesmo combinar funções para formar um lista diferente como aqui	* Você pode até mesmo combinar funções *# para formar um lista diferente *#* como aqui
Título com texto: Título  com texto Item  a definição do item	; Título : com texto ; Item : a definição do item
Indentação: Dois pontos servem para indentar uma linha ou parágrafo. Duas vezes dois pontos indentam ainda mais. Um caractere numa nova linha inicia um novo parágrafo. Nota: Geralmente usado em páginas de discussão para diferenciar entre os diferentes comentários com facilidade.	: Dois pontos servem para indentar uma linha ou parágrafo. ::Duas vezes dois pontos indentam ainda mais. Um caractere numa nova linha inicia um novo parágrafo.
Não formatar: Se uma linha começa com um espaço então ela será formatada exatamente como for digitada; com uma fonte de tamanho fixo; e as linhas não serão quebradas; isto é útil para: * colagem de texto preformatado; * descrição de algoritmos; * código fonte de programas * arte ascii; Atenção: os browsers não quebram automaticamente linhas desse tipo, e simplesmente aumentam indefinidamente a largura da janela, que pode ser um efeito não desejável.	Se uma linha começa com um espaço então ela será formatada exatamente como for digitada; com uma fonte de tamanho fixo; e as linhas não serão quebradas; isto é útil para: * colagem de texto preformatado; * descrição de algoritmos; * código fonte de programas * arte ascii;
Mostrar o código wiki: Ha três maneiras para exibir o codigo wiki, ao invés de formatação: você pode usar o componente <code> você pode usar o componente <pre> você pode usar o componente <nowiki> A diferença entre o “code” e “pre” é que o componente "pre" preserva quebra de linhas, enquanto o componente "code" não. O componente "nowiki" tag funciona como o componente “code” exceto que ele não usa fonte monospace.	Há três maneiras para exibir o codigo wiki, ao invés de formatação: #<code>você pode usar o componente <code></code> #<pre>você pode usar o componente <pre> #<nowiki>você pode usar o componente <nowiki></nowiki> A diferença entre o “code” e “pre” é que o componente "pre" preserva quebra de linhas, enquanto o componente "code" não. O componente "nowiki" tag funciona como o componente “code” exceto que ele não usa fonte monospace.
Centrar texto: Texto centrado.	<div style="text-align: center;">Texto centrado.</div>
Linha horizontal: Uma linha horizontal de divisão com texto em cima e em baixo. Ou ainda duas linhas entre duas partes do texto.	Uma linha horizontal de divisão com texto em cima ---- e em baixo. Ou ainda duas linhas ---- ---- entre duas partes do texto.

Formatação de caracteres

Resultado obtido (Publicado no Navegador)	A escrever (Editado na MediaWiki)
Itálico e negrito Esta linha está em itálico. (envolta com duplo apóstrofo) Esta também! (envolta com tags de HTML) E ainda está! (usando um código ainda diferente). Esta linha está em bold/negrito (envolta com triplo apóstrofo) Esta também! (envolta com tags de HTML) Por exemplo, em fórmulas matemáticas: F = ma Nota: Todavia a diferença entre estes dois métodos não é muito importante para os navegadores gráficos, e a maioria das pessoas pode ignorá-la.	''Esta linha está em itálico.'' (envolta com duplo apóstrofo) <i>Esta também!</i> (envolta com tags de HTML) <em>E ainda está!</em> (usando um código ainda diferente). '''Esta linha está em bold/negrito''' (envolta com triplo apóstrofo) <b>Esta também!</b> (envolta com tags de HTML) Por exemplo, em fórmulas matemáticas: :<b>F</b> = <i>m</i><b>a</b>
Combinação de métodos Enfatizar, com força, com bastante força. Nota:Estes são apóstrofos duplos e triplos, e não aspas duplas.	''Enfatizar'', '''com força''', '''''com bastante força'''''.
Termos técnicos Uma fonte estilo máquina de escrever para termos técnicos.	Uma fonte estilo máquina de escrever para <code>termos técnicos</code>.
Reduzir fonte Você pode usar um texto pequeno para legendas ou notas.	Você pode usar um <small>texto pequeno</small> para legendas ou notas.
Riscar e sublinhar texto Você pode riscar material que deva ser apagado e sublinhar novo material..	Você pode <del>riscar material que deva ser apagado</del> e <ins>sublinhar novo material</ins>.
Sobrescrito e subscrito Você pode fazer sobrescrito e subscrito. f(x) = a0 + a1x1 +	Você pode fazer <sup>sobrescrito</sup> e <sub>subscrito</sub>. f(x) = a<sub>0</sub> + a<sub>1</sub>x<sub>1</sub> +
Cor e tamanho Caso seja necessário, você pode controlar o tamanho da fonte e sua cor! Pode também utilizar a propriedade color com uma cor RGB (Red, Green, Blue) f(x) = a0 + a1x1...	Caso seja necessário, você pode controlar o <span style="font-size:x-large;">tamanho</span> da fonte e sua <span style="color: #060;">cor</span>! Pode também utilizar a propriedade color com uma cor RGB (Red, Green, Blue) <span style="font-size:x-large; color:#060;">f(x) = a<sub>0</sub> + a<sub>1</sub>x<sub>1</sub>...</span>
Acentos e notações lexicais À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ	&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring; &AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml; &Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve; &Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave; &Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute; &acirc; &atilde; &auml; &aring; &aelig; &ccedil; &egrave; &eacute; &ecirc; &euml; &igrave; &iacute; &icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc; &oelig; &otilde; &ouml; &oslash; &ugrave; &uacute; &ucirc; &uuml; &yuml;
Pontuação ¿ ¡ « » § ¶ † ‡ • —	&iquest; &iexcl; &laquo; &raquo; &sect; &para; &dagger; &Dagger; &bull; &mdash;
Símbolos comerciais ™ © ® ¢ € ¥ £ ¤	&trade; &copy; &reg; &cent; &euro; &yen; &pound; &curren;
Índice e expoente Índice: x2 Expoente: x2 ou x² Nota: O último método de escrever índices superiores não pode ser usado em todos os contextos, mas seu uso é recomendado sempre que possível (como em unidades de medida) porque a maioria dos navegadores gasta menos tempo na formatação das linhas com ele. ε0 = 8.85 × 10−12C² / J m.	Índice: x<sub>2</sub> Expoente: x<sup>2</sup> ou x&sup2; &epsilon;<sub>0</sub> = 8.85 &times; 10<sup>&minus;12</sup> C&sup2; / J m.
Caracteres gregos α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω	&alpha; &beta; &gamma; &delta; &epsilon; &zeta; &eta; &theta; &iota; &kappa; &lambda; &mu; &nu; &xi; &omicron; &pi; &rho; &sigma; &sigmaf; &tau; &upsilon; &phi; &chi; &psi; &omega; &Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi; &Sigma; &Phi; &Psi; &Omega;
Caracteres matemáticos ∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ → × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇔ → ↔	&int; &sum; &prod; &radic; &minus; &plusmn; &infin; &asymp; &prop; &equiv; &ne; &le; &ge; &rarr; &times; &middot; &divide; &part; &prime; &Prime; &nabla; &permil; &deg; &there4; &alefsym; &oslash; &isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;&not; &and; &or; &exist; &forall; &rArr; &hArr;&rarr; &harr;
x2   ≥   0 verdadeiro. Nota: Para criar espaçamentos, use espaços inquebráveis -  .   também evita quebras de linha no meio do texto. Útil para fórmulas.	<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 verdadeiro.
Suspensão da interpretação da marcação   Link → (<i>para</i>) a [[FAQ da Wikipedia]] Nota: Usado para mostrar literalmente dados que, de contrário, teriam significado especial. Cancela todos os códigos wiki, inclusive aqueles semelhantes a códigos HTML. Não cancela entidades de caractere HTML.	<nowiki>Link &rarr; (<i>para</i>) a [[FAQ da Wikipedia]]</nowiki>
Inserção de comentários invisíveis Não são mostrados na página Nota: usado, por exemplo, para deixar comentários numa página para futuros editores. Só é visível ao editar uma página.	<!-- o comentário vai aqui -->