Ajuda:Linha temporal: diferenças entre revisões

Saltar para a navegação Saltar para a pesquisa
13 103 bytes adicionados ,  5 de outubro de 2007
+ (ainda não está finalizado)
(pequenas correções)
(+ (ainda não está finalizado))
A extensão EasyTimeline é bastante completa mas a sintaxe é complexa e difícil de usar, especialmente para pessoas com poucos conhecimentos sobre o funcionamento de código. Foi por isso desenvolvida uma predefinição, a {{tl|graphical timeline}}, que facilita a execução de linhas temporais.
 
==Instruções de uso da linha temporal==
==A forma mais simples==
{{Graphical timeline/doc}}
Escreva {{tl|linha temporal}} ou {{tl|include timeline}} no módulo e clique em "mostrar previsão". Aparecerá o seguinte texto:
 
{| class="messagebox standard-talk"
|-
| [[Image:Splitsection.gif|40px|New article]]
| Clique <font color=#4682B4>aqui</font> para iniciar uma linha temporal horizontal, ou <font color=#4682B4>aqui</font> para uma vertical.
 
Quando tiver terminado, guarde esta página; a sua linha temporal estará incluída aqui!
 
''Para mais detalhes, veja [[Ajuda:Linha temporal]]''
|}
Siga o link desejado: você poderá querer criar uma linha temporal com orientação vertical ou uma com orientação horizontal. De acordo com a sua escolha, ser-lhe-á apresentada uma predefinição pronta-a-usar na janela de edição, com instruções já colocadas na previsão. Regressando ao módulo, a predefinição <nowiki>{{include timeline}}</nowiki> apresentará a sua linha temporal.
 
===Se usar a opção "vertical"===
Se seguir o link para criar uma linha temporal vertical, aparecerá o seguinte texto na página de edição:
 
::Está pronto a criar a predefinição!
 
::Siga estes simples passos e terá a predefinição pronta num instante!
 
::* Adicione uma chaveta de fecho para completar Linha_temporal.
::* Preencha os parâmetros "from" (de) e "to" (a): estes são os únicos parâmetros obrigatórios.
::* Copie tantas barras, notas, etc, quantas as necessárias, substituindo # com números 1, 2, 3… etc.
::* Apague os parâmetros desnecessários.
 
seguido de algumas notas importantes. Aparecerá também na janela de edição o código apresentado na coluna à esquerda:
<table><tr><td>
<pre>{{Graphical timeline
| help=off
| link-to={{subst:PAGENAMEE}<!--substitua este comentário por }-->
 
| from=
| to=
| scale-increment=
| align=
| margin=
| width=
| width-unit=
| height=
| height-unit=
| unit=
 
| title=
| title-colour=
| plot-colour=
 
| bar#-from=
| bar#-to=
| bar#-left=
| bar#-colour=
| bar#-border-width=
| bar#-border-colour=
| bar#-text=
| bar#-nudge-left=
| bar#-nudge-right=
| bar#-nudge-up=
| bar#-nudge-down=
 
| legend#=
| legend#-colour=
 
| note#=
| note#-nudge-down=
| note#-nudge-up=
| note#-nudge-left=
| note#-nudge-right=
| note#-remove-arr=
| note#-colour=
 
| caption=
 
}}</pre>
</td><td>
<pre>
{{Graphical timeline
| help=off
| link-to={{subst:PAGENAMEE}<!--substitua este comentário por }-->
 
| from=
| to=
| scale-increment=
| align=
| margin=
| width=
| width-unit=
| height=
| height-unit=
| unit=
 
| title=
| title-colour=
| plot-colour=
 
| bar#-from=
| bar#-to=
| bar#-left=
| bar#-colour=
| bar#-border-width=
| bar#-border-colour=
| bar#-text=
| bar#-nudge-left=
| bar#-nudge-right=
| bar#-nudge-up=
| bar#-nudge-down=
 
| legend#=
| legend#-colour=
 
| note#=
| note#-nudge-down=
| note#-nudge-up=
| note#-nudge-left=
| note#-nudge-right=
| note#-remove-arr=
| note#-colour=
 
| caption=
 
}}
</pre>
</td></tr></table>
===Se usar a opção "horizontal"===
 
 
==Função da predefinição==
Esta predefinição fornece uma forma intuitiva, simples de utilizar e flexível de inserir linhas temporais num módulo. Foi feita de forma a requerer um número mínimo de variáveis e de se inserir numa tabela - embora possa ser adicionada uma margem.
 
==Porquê usar esta predefinição?==
 
Esta predefinição é uma alternativa a [[m:EasyTimeline]], que usa uma sintaxe <nowiki><template></nowiki>. A EasyTimeline apresenta os seguintes pontos fracos:
*Produção de imagens pixeladas e que aumentam o tempo de carregamento da página.
*Longo tempo de edição - pode levar mais de meia hora mesmo sabendo o que está a fazer.
*Código difícil que requer uma sintaxe precisa.
*Difícil de colocar barras no local exacto desejado.
*Pequenas mudanças em datas e tamanhos requer modificação em diversos locais.
*Todos os parâmetros têm de ser especificados - nenhum é automático.
*Não tem escalável, ou seja, não aumenta com o tamanho do texto.
 
==Usando a predefinição==
===Onde a usar===
Enquanto que é possível inserir pequenas linhas temporais num módulo, foi notado que linhas temporais complexas e longas podem interromper o fluxo da página e tornar difícil a edição desta. Assim, pode ser desejável usar {{tl|Include timeline}} numa página separada, automaticamente incluída no texto final.
===Início===
Você pode incluir <tt>|help=on</tt> na predefinição para que esta produza alguns links rápidos.
 
Ao iniciar, você poderá querer utilizar <tt>{</tt><tt>{Graphical timeline|help=on}}</tt> de modo a gerar uma predefinição pronta a preencher; em alternativa, escreva {<tt>{subst:Graphical timeline/blank}</tt>} na página de testes, guarde a página e edite o código resultante. Os nomes dos parâmetros são intuitivos (em inglês).
 
===O que significam os números===
Os valores numéricos encontram-se, por omissão em unidades [[:w:en:em (typography)|em]], isto é, a altura e largura de uma letra M maiúscula.
 
A excepção encontra-se nps paraâmetros left e right de uma barra, que usam coordenadas fraccionais. Isto é, o código <code> |bar1-left=0 |bar1-right=0.5 |bar2-left=0.666 |bar3-left=0.5 |bar3-right=0.666 </code> produz bar1, que cobre a parte esquerda da área, bar2 que cobre a parte direita e bar3 que cobre o espaço ao meio. Por razões operacionais, as unidades de altura são sempre utilizadas para gerar espessuras das bordas.
 
===Bordas das barras===
As bordas aparecem apenas no topo e fundo de uma dada barra. Infelizmente, tal não pode ser modificado - para ter uma borda apenas num, deve ser criada uma barra em separado para cobrir a zona pretendida.
 
O estilo da borda pode seguir os standards CSS <code>solid, dotted, dashed, double, groove, ridge, inset</code> ou <code>outset</code>. A largura encontra-se nas mesma unidades que a altura e, se não for especificada, 0,1 a 0,2 é um valor adequado para obter uma linha fina.
 
===Linhas em branco===
Deixar um parâmetro em branco NÃO é o mesmo que não o especificar - prevalecerá sobre o valor or omissão da predefinição. Certifique-se que retira as linhas que não deseja especificar.
 
===Considerações===
====Navegadores web====
Infelizmente, diferentes navegadores possuem diversas formas de lidar com linhas de texto que extravazam a sua caixa de edição - alguns expandem a caixa, enquanto outros envolvem o texto. Tal significa que é útil verificar a linha temporal em pelo menos dois navegadores diferentes, como o Internet Explorer e o Firefox, especialmente se fizer uma linha particularmente complexa.
 
====Cores====
Se você definir cores usando valores html (com o aspecto <code>#e0b539</code>). tenha em consideração que alguns monitores mais antigos e diversos projectores não conseguem mostrar algumas cores. Ao manter-se cores que sejam múltiplos de <tt>33</tt> - por exemplo, <code>#ff99cc</code> ou <code>#03C</code> - assegurará compatibilidade máxima.
 
====Capacidade====
Se você verificar que barras, notas ou legendas com numeração alta não aparecem, poderá ser porque a predefinição não foi programada para lidar com tão alta numeração. Existem instruções na própria predefinição de como adicionar mais barras, etc (é uma simples acção de copiar e colar). Se ainda assim não conseguir o resultado que pretende, contacte o usuário [[w:en:User:Verisimilus|Verisimilus]] na Wikipédia anglófona.
 
====Facilidade de edição====
Se criar uma linha temporal numa subpágina, use o parâmetro <code> | link-to= </code>. Especifique o nome da página (por exemplo <tt>Predefinição:A minha linha temporal</tt>); aparecem então links para "editar" e para o "histórico" da página.
 
<!--====The Stowaway Pipe====
A mysterious pipe appears on the top-left of the timeline, and I can't for the life of me work out how to eradicate it. I've narrowed it down to one of the sub-templates (I can't recall which, irritatingly) and can work around it by covering it up by an opaque div; however this is an inelegant solution to a problem probably caused by my poor coding. If you could fix it - great!-->
 
==Um exemplo==
O código mostrado à esquerda produz o resultado à direita. Este exemplo mostra algumas das limitações da predefinição.
 
{{Graphical timeline
 
|title=Example Timeline
|align=right
 
|plot-colour=#bbeebb
 
|from=-550
|to=-500
|scale-increment=10
 
|width=10
|height=250
|height-unit=px
 
|legend1=[[Phanerozoic]]
 
|bar1-from=-542
|bar1-left=0
|bar1-right=0.1
 
|legend2=[[Precambrian]]
 
|bar2-to=-542
|bar2-left=0
|bar2-right=0.2
 
 
|legend3=[[Infracambrian]]
|legend3-colour=#e0aacc
 
|bar3-to=-534
|bar3-left=0.1
|bar3-right=0.2
|bar3-colour=#e0aacc
 
|<!-- If this was bar 4 it would be overlapped by the Botomian bar -->
|bar14-from=-530
|bar14-to=-520
|bar14-left=0.95
|bar14-right=1.05
|bar14-colour=red
|legend14=Cambrian explosion
 
|<!--Epochs & stages-->
|bar5-text=[[Ediacaran]]
|bar5-to=-540
|bar5-left=0.2
|bar5-border-width=1
|bar5-colour=#cc9999
 
|bar6-text=[[Nemakit-Daldynian]]
|bar6-from=-542
|bar6-to=-534
|bar6-left=0.2
|bar6-border-width=0.1
|bar6-colour=#99cc99
 
|bar7-text=[[Tommotian]]
|bar7-from=-534
|bar7-to=-530
|bar7-left=0.1
|bar7-colour=#99cc99
|bar7-border-width=0.1
 
|bar8-from=-530.1
|bar8-to=-529.9
|bar8-left=0.2
|bar8-colour=black
 
|bar9-text=[[Atdabanian]]
|bar9-from=-530
|bar9-to=-524
|bar9-left=0.1
|bar9-right=0.95
|bar9-colour=#99cc99
 
|bar10-text=[[Botomian]]
|bar10-from=-524
|bar10-to=-518
|bar10-left=0.1
|bar10-colour=#99cc99
|bar10-border-width=0.1
 
|bar11-text=[[Toyonian]]
|bar11-from=-518
|bar11-to=-513
|bar11-left=0.1
|bar11-border-width=0.1
|bar11-colour=#99cc99
 
 
|note1=Base of the Cambrian
|note1-at=-542
|note1-colour=green
 
|note2=[[Middle Cambrian]]
|note2-nudge-left=8.5
|note2-nudge-down=0
|note2-at=-507
|note2-remove-arrow=yes
 
|caption=An approximate time-scale of events<br>at the base of the [[Cambrian]] [[Period (geology){{!}}Period]].
<br>Axis scale is in millions of years ago.
}}
<pre>{{Graphical timeline
 
|title=Example Timeline
|align=right
 
|plot-colour=#bbeebb
 
|from=-550
|to=-500
|scale-increment=10
 
|width=10
|height=250
|height-unit=px
 
|legend1=[[Phanerozoic]]
 
|bar1-from=-542
|bar1-left=0
|bar1-right=0.1
 
|legend2=[[Precambrian]]
 
|bar2-to=-542
|bar2-left=0
|bar2-right=0.2
 
 
|legend3=[[Infracambrian]]
|legend3-colour=#e0aacc
 
|bar3-to=-534
|bar3-left=0.1
|bar3-right=0.2
|bar3-colour=#e0aacc
 
|<!-- If this was bar 4 it would be overlapped by the Botomian bar -->
|bar14-from=-530
|bar14-to=-520
|bar14-left=0.95
|bar14-right=1.05
|bar14-colour=red
|legend14=Cambrian explosion
 
|<!--Epochs & stages-->
|bar5-text=[[Ediacaran]]
|bar5-to=-540
|bar5-left=0.2
|bar5-border-width=1
|bar5-border-colour= #996666
|bar5-colour=#cc9999
 
|bar6-text=[[Nemakit-Daldynian]]
|bar6-from=-542
|bar6-to=-534
|bar6-left=0.2
|bar6-border-width=0.1
|bar6-colour=#99cc99
 
|bar7-text=[[Tommotian]]
|bar7-from=-534
|bar7-to=-530
|bar7-left=0.1
|bar7-colour=#99cc99
|bar7-border-width=0.1
 
|bar8-from=-530.1
|bar8-to=-529.9
|bar8-left=0.2
|bar8-colour=black
 
|bar9-text=[[Atdabanian]]
|bar9-from=-530
|bar9-to=-524
|bar9-left=0.1
|bar9-right=0.95
|bar9-colour=#99cc99
 
|bar10-text=[[Botomian]]
|bar10-from=-524
|bar10-to=-518
|bar10-left=0.1
|bar10-colour=#99cc99
|bar10-border-width=0.1
 
|bar11-text=[[Toyonian]]
|bar11-from=-518
|bar11-to=-513
|bar11-left=0.1
|bar11-border-width=0.1
|bar11-colour=#99cc99
 
 
|note1=Base of the Cambrian
|note1-at=-542
|note1-colour=green
 
|note2=[[Middle Cambrian]]
|note2-nudge-left=8.5
|note2-nudge-down=0
|note2-at=-507
|note2-remove-arrow=yes
 
|caption=An approximate time-scale of events<br>at the base of the [[Cambrian]] [[Period (geology){{!}}Period]].
<br>Axis scale is in millions of years ago.
}}
</pre>
 
==Notas==
* <tt>{</tt><tt>{!}}</tt> tem de ser usado sempre que desejar que apareça um | (por exemplo na legenda).
* Se não especificar quando uma barra deve iniciar ou acabar, ela continuará até ao limite da caixa.
* O texto não deve ser demasiado longo na barra.
* A forma como o texto excessivo é tratado nas duas bordas difere em diferentes navegadores web - sai da caixa no Firefox mas é envolvido no Internet Explorer. Tente adicionar manualmente novas linhas quando tal é necessário em vez de confiar no que os navegadores conseguem fazer. Em alternativa, coloque uma nota sobre a barra - veja o parâmetro note2, que está colocado na esquerda sobre o fundo da caixa da linha temporal. <!-- Esta parte ficou terrivelmente traduzida mas hoje não consigo melhor :( The way that overflowing text wraps is also handled differently in the two borders - it pokes out of the right of the bar on Firefox, but is wrapped within it by IE. Try to manually enter newlines when required rather than relying on browsers to sort it out. Or position a note over the bar - check out note2, which is nudged left over the plot background.-->
 
==Ligações externas==
*[http://en.wikipedia.org/wiki/User:Verisimilus Contacto para sugestões/correcções no desenvolvimento desta predefinição]
<noinclude>[[Categoria:!Instruções de predefinições]]</noinclude>
 
{{stub}}
1 414

edições

Menu de navegação