Dicas de formatação

De Stoa
Edição feita às 00h34min de 2 de fevereiro de 2010 por Ewout (disc | contribs)

(dif) ← Edição anterior | ver versão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Conteúdo

Edição simples de texto

ATENÇÃO: antes de inserir ou editar qualquer texto, lembre-se que este é um material didático, não uma comunidade do Orkut. O que você posta nessas páginas é um verbete, não um comentário simples. Portanto se assegure que seu conteúdo é relevante e inédito, lendo o que seus colegas postaram antes de inserir sua parte - principalmente quando se tratar de verbetes coletivos. Tenha noção ou seu conteúdo será apagado e você, advertido.

Em caso de dúvidas, examine primeiro esta seção. Se não encontrar a resposta, pode me mandar um e-mail.

Acompanhe as dicas de formatação a seguir:

Revisões

Como na Wikipédia, o objetivo deste sistema é criar uma fonte de referência pública, que todos os alunos podem consultar e editar. A razão disto é muito simples: compartilhar conhecimento. Na maioria das vezes, alguém já terá postado sobre o assunto que você tem para contribuir. Sua tarefa nesses casos é editar o artigo e acrescentar a sua parte. Nesse processo, você complementa o que já pesquisou e ajuda a criar um material de referência mais completo.
Para editar um verbete já existente, clique no link edit que fica no canto superior de seu título. Repare que existem diversos links desses, cada um relativo ao texto diretamente abaixo. O link levará você à página de edição, com o código que o servidor usa para produzir a página final.
Por mais que esse código pareça assustador, ele foi feito para ser o mais amigável possível, como um editor de texto simples. Suas principais funções estão em sua barra de navegação:


Barra de botões 0.gif
Se quiser experimentar use este link, não as páginas de conteúdo final.

Novos verbetes

Cada vez que se criar um link para um verbete inexistente, o sistema criará uma página nova, com o formulário acima. Por isso, se a página que você pretende escrever não existe ainda, vá para a página que chamaria seu conteúdo e a edite para criar um link. Grave a página e a acesse. Ao clicar no novo link que você criou, o sistema abre um formulário para seu novo verbete. Em caso de dúvidas, fale comigo.

Escreva seu texto ou alteração

No formulário, digite simplesmente seu texto, sem se preocupar com acentuação. Para marcações especiais, use a barra de formatação. É tão simples quanto editar um blog. À medida que você aplica estilos de formatação e links, no entanto, seu texto se torna mais difícil de ler. Para quem não está habituado eu recomendo ter uma cópia em um editor de texto e alterar um sub-tópico por vez, evitando danos a outras áreas.
Mas não se intimide: a única forma de pegar prática é treinar. Se der errado, recomece. Se for mexer no texto já começado por outros, imprima o original e o copie para um editor de texto, se prevenindo para o eventual caso em que seja obrigado a refazê-lo.

Para criar links

Para criar um link para uma página externa, basta escrevê-lo (ex: http://www.wikipedia.org).
Se quiser colocar outro nome que não o link direto, escreva-o após o endereço ([http://www.wikipedia.org Wikipédia em inglês] esconde o link e deixa o texto Wikipédia em inglês).
Se o link for para um verbete desta Wiki, coloque-o entre colchetes duplos ([[Aulas]] gera o link para a página Aulas).
Se o link for para uma sub-seção de uma página, coloque o símbolo # antes do nome da seção ([[Aulas #Aula 3]] redireciona para o sub-item Aula 3 na página Aulas, assim).

Registre suas alterações

Se você alterou uma página, registre resumidamente o que fez no campo logo abaixo da edição de texto. Isso facilita a identificação da autoria de cada verbete.

Reveja suas alterações antes de gravá-las

Sempre que você fizer alguma alteração de porte, clique no botão Mostrar previsão antes de gravar a página. Isso permite a correção de erros antes de tornar a página permanente. Ao gravá-la (salvar), suas alterações serão imediatamente aplicadas ao verbete.

Date e assine

Ao terminar a criação ou alterações do texto, não se esqueça de clicar no botão de assinatura e registrar suas mudanças, assim:

--Luli 20:21, 24 Abril 2007 (BRT)Luli

Formatação de texto

Se você quiser formatar páginas usando o código Wiki, ou simplesmente compreendê-lo melhor, consulte a tabela a seguir:

O que digitar Como fica
Para se escrever textos em ''itálico'',
coloque dois apóstrofos (') de cada lado.

3 apóstrofos deixarão o texto em '''negrito'''. 

5 apóstrofos o formatarão em 
'''''negrito e itálico'''''.

(Usar 4 apóstrofos não fará nada de especial,
eles apenas deixarão '''' restos''''
como parte do texto.)

Para se escrever textos em itálico,
coloque dois apóstrofos (') de cada lado.

3 apóstrofos deixarão o texto em negrito.

5 apóstrofos o formatarão em negrito e itálico.

(Usar 4 apóstrofos não fará nada de especial, eles apenas deixarão ' restos' como parte do texto.)

Uma quebra de linha
geralmente não tem efeito no layout.
Elas podem ser utilizadas para separar
frases dentro de um parágrafo
(e facilitar a revisão de sua formatação).

Uma linha em branco, no entanto,
inicia um novo parágrafo.

Quando usada em uma lista, uma quebra
de linha ''afeta''<br>
o layout ([[#listas|veja abaixo]]).

Uma quebra de linha geralmente não tem efeito no layout. Elas podem ser utilizadas para separar frases dentro de um parágrafo (e facilitar a revisão de sua formatação).

Uma linha em branco, no entanto, inicia um novo parágrafo.

Quando usada em uma lista, uma quebra de linha afeta
o layout (veja abaixo).

Você pode forçar a quebra<br>
de linhas<br>
sem iniciar um novo parágrafo.<br>
Fica estranho, use conscientemente.

Para maior eficiência de sua página Wiki,<br>
não comece o '''bold''' ou ''itálico''
em uma linha para terminar em outra.

Você pode forçar a quebra
de linhas
sem iniciar um novo parágrafo.
Fica estranho, use conscientemente.

Para maior eficiência de sua página Wiki,
não comece o bold ou itálico em uma linha para terminar em outra.

Divisões internas

Ferramentas para organizar seus verbetes - seções, parágrafos, listas e linhas:

O que digitar Como fica

= NÃO USE ESTE =

== Nova seção ==

=== Sub-seção ===

==== Sub-subseção ====


Nova seção


Sub-seção


Sub-subseção


Comece as seções com seus títulos. Um único = de cada lado determina o maior nível de seção, equivalente a um título de página. Por convenção, ele é reservado para tal e não usado internamente. Para fazer seções, recomenda-se:

  • Começar com um título secundário (==); e
  • Respeitar a hierarquia de níveis (evitar ir do segundo para o quarto níveis; ou vice-versa).


* Listas de ''bullets'' são fáceis de fazer:
* comece cada linha com um asterisco;
** mais asteriscos indicam níveis inferiores.
** Uma quebra de linha em uma lista
marca o fim da lista.

* E você
** sempre pode
* recomeçar.

  • Listas de bullets são fáceis de fazer:
  • comece cada linha com um asterisco;
    • mais asteriscos indicam níveis inferiores.
    • Uma quebra de linha em uma lista

marca o fim da lista.

  • E você
    • sempre pode
  • recomeçar.
# Listas ''numeradas'' também são fáceis,
## organizam seu texto
## e são de fácil acompanhamento
## Uma quebra de linha em uma lista
marca o fim da lista.

#A numeração sempre recomeça com 1.
  1. Listas numeradas também são fáceis,
    1. organizam seu texto
    2. e são de fácil acompanhamento
    3. Uma quebra de linha em uma lista

marca o fim da lista.

  1. A numeração sempre recomeça com 1.
* Você também pode fazer listas ''mistas''
*# e intercalá-las
*#* ou quebrar linhas<br/>em listas
  • Você também pode fazer listas mistas
    1. e intercalá-las
      • ou quebrar linhas
        em listas
; Termo : Definição de uma palavra.
; Termo ou frase maior
: Sua definição logo abaixo.

Definições:

Termo 
Definição de uma palavra.
Termo ou frase maior
Sua definição logo abaixo.
: O uso de dois pontos (:) no início
de um parágrafo o desloca para a direita.
Uma nova linha sem (:) devolve o parágrafo
para sua posição original.

Deslocamento

O uso de dois pontos (:) no início de um parágrafo o desloca para a direita.

Uma nova linha sem (:) devolve o parágrafo para sua posição original.

Quando houver a necessidade
de se destacar um bloco de texto,
<BLOCKQUOTE>
'''BLOCKQUOTE''' é um comando HTML
que cria recuos em ambas as margens.
Muito usado para citações de outras fontes.
</BLOCKQUOTE>

Quando houver a necessidade de se destacar um bloco de texto,

BLOCKQUOTE é um comando HTML que cria recuos em ambas as margens. Muito usado para citações de outras fontes.


Uma linha de divisão: 

texto acima dela...
----
...texto abaixo dela.

Linhas de divisão sem indicações de seção não são listadas no índice, por isso é melhor usar seções para dividir o texto.

Uma linha de divisão:

texto acima dela...


...texto abaixo dela.


InterWikis

InterWiki é uma idéia de ter um sistema unificado de Wikis entre todos os sites que utilizam o sistema wiki. Com os códigos interwiki pode-se facilitar a referência:

  • a outros projetos relacionados à wikipedia e seus derivados;
  • a cópias de determinados artigos disponíveis em outro idioma.

Para fazer referência a um artigo sobre design, por exemplo, da Wikipédia em português, digite:

[[:pt:design|título do link]].

O código :pt significa que o link se referirá ao determinado artigo na Wikipédia em português. Use :en para se referir à Wikipédia em inglês, :it para italiano e assim por diante.

Veja o mapa de interwikis do StoaWiki (lista incompleta). Para você ter uma idéia de várias interwikis que podem ser usadas aqui, visite o mapa de interwikis da Wikipédia.

O que digitar Como fica
Este é o link de
[[:pt:design|design em Português]]
da Wikipédia.
Este é o em [[:en:design|Inglês]].
Este é o link de design em Português da Wikipédia. Este é o em Inglês.

Referências e rodapés

Para referências e rodapés, você precisa do comando <ref>.

Coloque a referência ou nota de rodapé entre <ref> e </ref>, depois coloque o comando <references/> no local onde quiser citar a fonte.

Exemplo

A eletrodinâmica quântica é atualmente a teoria física mais precisa
<ref>[http://www.physorg.com/news8731.html Measurement of physics]</ref>
das testadas experimentalmente.

O texto acima fica assim:

A eletrodinâmica quântica é atualmente a teoria física mais precisa[1] das testadas experimentalmente.

Múltiplos usos da mesma nota de rodapé

Para usar a mesma nota de rodapé para várias citações, use o comando <ref name="name">.

No exemplo seguinte, a mesma fonte é citada três vezes.

Limãos não são laranjas. <ref name="cor">'''''RADFAHRER, Luli'''. Almanaque do Daltônico em tempos modernos. Edusp, São Paulo, 1993.''</ref>

Essas referências são bastante úteis para citar vários trechos que remetam à mesma fonte.
<ref name="cor">Depois de definida a citação, qualquer texto que vier a seguir será supérfluo e não aparecerá em lugar algum.</ref>

Você pode substituí-los por comandos vazios, com uma barra no final, como aqui.<ref name="cor" />

O texto acima fica formatado assim:

Limãos não são laranjas. [2]

Essas referências são bastante úteis para citar vários trechos que remetam à mesma fonte.[2]

Você pode substituí-los por comandos vazios, com uma barra no final, como aqui.[2]

Adicionando as referências ou notas de rodapé

O comando <references/> insere o texto completo de todas as notas de rodapé, em qualquer lugar da página.

Baseado nos comandos acima, o código <references/> produz:

  1. Measurement of physics
  2. 2,0 2,1 2,2 RADFAHRER, Luli. Almanaque do Daltônico em tempos modernos. Edusp, São Paulo, 1993

Imagens

Antes de incluir uma imagem em um verbete, certifique-se que ela está no endereço certo.

Normas

O comando completo para se referenciar uma imagem carregada dentro deste wiki é:

[[Imagem:link da imagem|moldura|alinhamento|largura da imagem|legenda]]

Mas você pode colocar apenas:

[[Imagem:link]]


Veja em detalhes o que significa cada termo:

Parâmetro Opções Tipo Definição
link da imagem várias Necessário Link para a imagem.
Se for de sua autoria e estiver em uma pasta do Stoa, deverá ser algo como:

http://stoa.usp.br/luli/files/122/294/limoes.jpg

moldura thumb
frame
Opcional
(recomendado)
A imagem é apresentada dentro de uma moldura.
alinhamento left
center
right
none
Opcional Define o alinhamento horizontal da imagem.
Quando vazio, a imagem é alinhada à esquerda.
Se o campo moldura estiver preenchido, a imagem será alinhada à direita.
largura da imagem várias Opcional
(não recomendado)
Especifica a largura da imagem em px (pixels).
Quando vazio, a imagem aparece em seu tamanho original, até o máximo ode 800x600 pixels em páginas de descrição de imagens, e de 180x180 pixels quando estiverem dentro de molduras.
legenda várias Opcional
(recomendado)
Caso não se preencha este campo, o nome da imagem aparecerá como legenda.

Exemplos

Descrição O que digitar Como fica
Em geral

Como regra geral, deve-se preencher o parâmetro thumb e incluir uma legenda descritiva. Não se deve especificar o largura da imagem, para que seja definido nas preferências do usuário. A largura máxima das imagens é de 180 pixels.

[[Imagem:PG_Limoes.jpg|thumb|Limões.]]
Limões.
Galeria de imagens

Permite mostrar um grid de até 4 colunas com imagens. A legenda é opcional e não se pode especificar o tamanho das imagens.

<gallery>
Imagem:PG_Limoes.jpg|Imagens de [[Aulas]].
Imagem:PG_Limoes.jpg
</gallery>
Alinhamento padrão

Utilizando o parâmetro none a imagem interrompe o fluxo de texto.

"Olha o verde, 
[[Imagem:PG_Limao.jpg|none]]
olha o limão verdinho,
sem nada de magenta,
só cyan, amarelo e preto!"
"Olha o verde,
PG Limao.jpg

olha o limão verdinho, sem nada de magenta, só cyan, amarelo e preto!"

Alinhamento bruto

A imagem aparece em linha com o texto.

"Olha o verde, 
[[Imagem:PG_Limao.jpg]]
olha o limão verdinho!"

"Olha o verde, PG Limao.jpg olha o limão verdinho!"

Quebra de linha

Pode-se definir a linha em que o texto quebra ao lado da imagem.

"Olha o verde, 
[[Imagem:PG_Limao.jpg|left]]
olha o limão verdinho,
sem nada de magenta,
só cyan, amarelo e preto!"
| 

"Olha o verde,

PG Limao.jpg

olha o limão verdinho, sem nada de magenta, só cyan, amarelo e preto!"

Links externos

Basta colocar o endereço, como em
http://stoa.usp.br/luli/files/122/303/limoes.jpg

limoes.jpg

Sua imagem também pode apontar para um link externos usando o seguinte comando
[http://link.externo http://link.da.imagem]

Usando a imagem acima e apontando para ela mesma, teremos o código
[http://stoa.usp.br/luli/files/122/303/limoes.jpg http://stoa.usp.br/luli/files/122/303/limoes.jpg]

limoes.jpg

Colocando o link da figura acima para um local qualquer, por exemplo, o resultado da busca por 'limão' no images google, temos
[http://images.google.com/images?q=limão http://stoa.usp.br/luli/files/122/303/limoes.jpg]

limoes.jpg

Se quiser centralizar a imagem, coloque o link entre <center></center>. Por exemplo, <center>http://stoa.usp.br/luli/files/122/303/limoes.jpg</center>, retorna

limoes.jpg

Ferramentas pessoais
Espaços nominais

Variantes
Ações
Navegação
Imprimir/exportar
Ferramentas