Predefinição:Graphical timeline
De Wikibooks
Documentação da predefinição
Tabela de conteúdo |
[editar] Uso
[editar] A forma mais simples
Escreva {{include timeline}} no módulo, clique em "mostrar previsão" e siga o link gerado. Ser-lhe-á apresentado uma predefinição pronta-a-usar; regressando ao módulo, a predefinição {{include timeline}} apresentará a sua linha temporal.
[editar] 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.
[editar] Porquê usar esta predefinição?
Esta predefinição é uma alternativa a m:EasyTimeline, que usa uma sintaxe <template>. 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.
[editar] Usando a predefinição
[editar] 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 {{Include timeline}} numa página separada, automaticamente incluída no texto final.
[editar] Início
Você pode incluir |help=on na predefinição para que esta produza alguns links rápidos.
Ao iniciar, você poderá querer utilizar {{Graphical timeline|help=on}} de modo a gerar uma predefinição pronta a preencher; em alternativa, escreva {{subst:Graphical timeline/blank}} 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).
[editar] O que significam os números
Os valores numéricos encontram-se, por omissão em unidades 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 |bar1-left=0 |bar1-right=0.5 |bar2-left=0.666 |bar3-left=0.5 |bar3-right=0.666 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.
[editar] 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 solid, dotted, dashed, double, groove, ridge, inset ou outset. 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.
[editar] 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.
[editar] Considerações
[editar] 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.
[editar] Cores
Se você definir cores usando valores html (com o aspecto #e0b539). 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 33 - por exemplo, #ff99cc ou #03C - assegurará compatibilidade máxima.
[editar] 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 Verisimilus na Wikipédia anglófona.
[editar] Facilidade de edição
Se criar uma linha temporal numa subpágina, use o parâmetro | link-to= . Especifique o nome da página (por exemplo Predefinição:A minha linha temporal); aparecem então links para "editar" e para o "histórico" da página.
[editar] Um exemplo
O código mostrado à esquerda produz o resultado à direita. Este exemplo mostra algumas das limitações da predefinição.
|v@= |c=scalemarkers |pv=loop |prefix= |postfix= |s= |pc1=from=-550 |pc2=to=-500 |pc3=height=250 |pc4=unit=px |pc5=increment=10|
1=0|2=1|3=2|4=3|5=4|6=5|7=6|8=7|9=8|10=9|11=10|12=11|13=12|14=13|15=14|16=15|17=16|18=17|19=18|20=19|21=20|22=21|23=22|24=23|25=24|26=25|27=26|28=27|29=28|30=29|31=30
|32=@|33=@|34=@|35=@|36=@|37=@|38=@|39=@|40=@|41=@|42=@|43=@|44=@|45=@|46=@|47=@|48=@|49=@|50=@|51=@|52=@|53=@|54=@|55=@|56=@|57=@|58=@|59=@|60=@|61=@|62=@|63=@|64=@|65=@|66=@|67=@|68=@|69=@|70=@|71=@|72=@|73=@|74=@|75=@|76=@|77=@|78=@|79=@|80=@|81=@|82=@|83=@|84=@|85=@|86=@|87=@|88=@|89=@|90=@|91=@|92=@|93=@|94=@|95=@|96=@|97=@|98=@|99=@|100=@|101=@|102=@|103=@|104=@|105=@|106=@|107=@|108=@|109=@|110=@|111=@|112=@|113=@|114=@|115=@|116=@|117=@|118=@|119=@|120=@|121=@|122=@|123=@|124=@|125=@|126=@|127=@|128=@}}
{{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.
}}
[editar] Notas
- {{!}} 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.
