Ajuda:Linha do tempo: mudanças entre as edições
Sem resumo de edição |
|||
| Linha 1: | Linha 1: | ||
'''Linha do tempo''' é um recurso gráfico que pode ser utilizado para apresentar eventos agrupados por período de tempo. Os eventos podem ser únicos ou agrupamentos de eventos. O recurso usa a extensão [[mediawikiwiki:Extension:InteractiveTimeline|InteractiveTimeline]]. | |||
=== Chacinas === | === Chacinas === | ||
Neste exemplo é apresentando apenas um tipo de evento - InteractiveTimeline (itimeline) | |||
<itimeline> | <itimeline> | ||
| Linha 17: | Linha 17: | ||
Veja como | Veja como é escrito o código desse exemplo: | ||
<pre> | <pre> | ||
<itimeline> | <itimeline> | ||
| Linha 60: | Linha 60: | ||
2014-07-25T13:15:00Z|[[File:Nuvola apps important.svg|16px]] Teste|[[Target 1/Rollback]] | 2014-07-25T13:15:00Z|[[File:Nuvola apps important.svg|16px]] Teste|[[Target 1/Rollback]] | ||
</itimeline> | </itimeline> | ||
== Uso == | == Uso == | ||
| Linha 315: | Linha 242: | ||
O corpo da tag <nowiki><itimeline> suporta transclusão e expansão de template, então você pode definir uma lista de eventos em outro lugar e transcluí-los no corpo da tag <itimeline>.</nowiki> | O corpo da tag <nowiki><itimeline> suporta transclusão e expansão de template, então você pode definir uma lista de eventos em outro lugar e transcluí-los no corpo da tag <itimeline>.</nowiki> | ||
== Demonstração == | === Demonstração === | ||
Uma demonstração do MediaWiki acessível ao público desta extensão não está disponível no momento. A [https://almende-github-io.translate.goog/chap-links-library/js/timeline/doc/?_x_tr_sch=http&_x_tr_sl=en&_x_tr_tl=pt&_x_tr_hl=en-US&_x_tr_pto=wapp#Example documentação da Timeline] contém vários exemplos dos recursos da biblioteca Timeline. | Uma demonstração do MediaWiki acessível ao público desta extensão não está disponível no momento. A [https://almende-github-io.translate.goog/chap-links-library/js/timeline/doc/?_x_tr_sch=http&_x_tr_sl=en&_x_tr_tl=pt&_x_tr_hl=en-US&_x_tr_pto=wapp#Example documentação da Timeline] contém vários exemplos dos recursos da biblioteca Timeline. | ||
Edição das 13h15min de 28 de junho de 2022
Linha do tempo é um recurso gráfico que pode ser utilizado para apresentar eventos agrupados por período de tempo. Os eventos podem ser únicos ou agrupamentos de eventos. O recurso usa a extensão InteractiveTimeline.
Chacinas
Neste exemplo é apresentando apenas um tipo de evento - InteractiveTimeline (itimeline)
Veja como é escrito o código desse exemplo:
<itimeline> <!-- Essas linhas definem eventos que acontecem em um determinado momento --> 2021-06-06T13:00:00Z|[[File:Image2.jpg|64px|link=Chacina do Jacarezinho]] [[Chacina do Jacarezinho|Chacina do Jacarezinho]] 2019-02-08T13:00:00Z|[[File:Image4.jpg|64px|link=Chacina do Fallet-Fogueteiro - 08 de fevereiro de 2019]] [[Chacina do Fallet-Fogueteiro - 08 de fevereiro de 2019|Chacina do Fallet-Fogueteiro]] 2003-04-16T13:00:00Z|[[Chacina do Borel|Chacina do Borel]] 1998-10-10T13:00:00Z|[[Chacina do Maracanã - 10 de outubro de 1998|Chacina do Maracanã]] 1993-07-23T13:00:00Z|[[Chacina da Candelária|Chacina da Candelária]] 1990-07-26T13:00:00Z|[[Chacina de Acari|Chacina de Acari]] </itimeline>
Chacinas - InteractiveTimeline (itimeline) em grupos
Apresentando vários grupos de eventos na mesma timeline.
Uso
Uma vez instalado, você pode colocar tags <itimeline>...</itimeline> nas páginas onde você deseja mostrar uma linha do tempo. Um grande número de parâmetros pode ser definido na tag <itimeline>, mas todos eles são opcionais. O conteúdo da tag deve ser uma série de eventos, com um evento definido por linha[1]. Por exemplo:
<itimeline height="512px" min="2014-06-01" max="2014-08-30"> <!-- Estas duas linhas definem eventos que acontecem em um tempo específico --> 2014-07-25T13:00:00Z|Design|[[Página 1|Página 1]] 2014-07-26T10:00:00Z|Design|[[Página 2|Página 2]] <!-- Esses três períodos foram definidos usando intervalos IS8601 com datas e horas de início e fim. --> 2014-07-25T08:00:00Z/2014-07-26T15:00:00Z|Implemento|[[Fase 1]] 2014-07-26T12:00:00Z/2014-07-27T15:00:00Z|Implemento|[[Fase 2]] 2014-07-25T08:00:00Z/2014-08-00:00:00+02:00|Implemento|Projeto 1 <!-- Disponível na v1.3: Suporte para agrupamentos. Estas três linhas definem grupos de eventos em um grupo de fase final. --> 2014-07-25T13:00:00Z|[[File:Nuvola apps important.svg|16px]] Coalface|[[Target 1/Deploy]] 2014-07-25T13:10:00Z|[[File:Nuvola apps important.svg|16px]] Coalface|[[Target 1/Panic]] 2014-07-25T13:15:00Z|[[File:Nuvola apps important.svg|16px]] Coalface|[[Target 1/Rollback]] </itimeline>
Datas e horários
Todas as datas e horas especificadas em uma tag <itimeline>, seja como valor fornecido para um parâmetro ou como parte de uma definição de evento, devem ser formatadas usando um perfil de ISO 8601 . As datas e horários aceitos pela InteractiveTimeline devem assumir a forma de uma data de calendário, opcionalmente seguida de uma hora:
As datas devem ser especificadas como um ano de quatro dígitos (o ano incluindo o século), seguido por um mês de dois dígitos (01 a 12), seguido por um dia de dois dígitos (01 a 31), com as seções opcionalmente separadas por hífens. A forma da data deve ser YYYY-MM-DDou YYYYMMDD, por exemplo: 2014-07-12ou 20140712.
Datas anteriores a 0000-01-01 não são suportadas no momento - estou trabalhando em um suporte confiável para elas.
Se uma hora não for especificada, o padrão de "00:00:00Z" (meia-noite UTC) será usado para a hora.
Se uma hora for especificada, ela deve ser separada da data por exatamente um espaço ' ' ou pelo caractere 'T'. Quando fornecido, os horários devem ser especificados como uma hora de dois dígitos (00 a 23 [Notas 1]), seguido por um minuto de dois dígitos (00 a 59), seguido por um segundo de dois dígitos (00 a 59), com os campos separados opcionalmente por dois pontos. O tempo deve ser da forma HH:MM:SSou HHMMSS. Os minutos e segundos são opcionais e, se não especificados, o padrão é "00". Frações decimais não são suportadas para os campos de hora. Os horários devem ser seguidos por um designador de fuso horário.
O designador de fuso horário deve ser "Z" para indicar que a hora está em UTC ou pode ser um deslocamento do UTC especificado como horas positivas ou negativas (e opcionalmente minutos) no formato ±[HH]:[MM] , ±[HH][MM], ou ±[HH].
Por exemplo, as seguintes datas e horas são válidas:
- 2014-07-12 17:10Z(17:10 UTC de 12 de julho de 2014)
- 2014-08-14(00:00 UTC de 14 de agosto de 2014)
- 2014-07-12T13:12:10-05:00(13:12:10 no horário de verão central em 12 de julho de 2014)
- 2014-08-14 08:24+02(08:24 no horário de verão da Europa Central em 14 de agosto de 2014)
As seguintes partes da ISO 8601 não são suportadas pelo InteractiveTimeline:
- Datas de 'precisão reduzida' (somente YYYY ano, ou YYYY-MM ano e mês); somente datas de calendário completas são suportadas.
- Datas da semana
- Datas ordinais
- Frações decimais para horas, minutos ou segundos.
- Designador de fuso horário opcional (o designador de fuso horário deve ser especificado se for fornecido um horário)
- Durações
- Os intervalos são suportados apenas parcialmente (consulte a sintaxe do evento <start>/<end> fornecida abaixo) - intervalos incluindo durações não são suportados.
- Intervalos de repetição
- Representações truncadas
- Escalas de tempo para representar calendários não gregorianos
Parâmetros
Os seguintes parâmetros podem ser especificados na tag <itimeline>. Todos os parâmetros são opcionais e diferenciam maiúsculas de minúsculas e, se não especificados, o padrão é usado.
| Parâmetro | Modelo | Predefinição | Descrição |
|---|---|---|---|
| fim | data hora | Nenhum | A data no final da exibição da linha do tempo quando a linha do tempo é exibida inicialmente. Se não for definido, a data e a hora do último evento na linha do tempo serão usadas. |
| altura | corda | auto | A altura da linha do tempo. Isso pode ser uma altura em qualquer unidade de tamanho CSS válida (px, em, %, etc) ou 'auto' para indicar que a altura deve ser calculada automaticamente. Quando a altura é definida como "auto", uma altura mínima pode ser especificada com a opção minheight. |
| localidade | corda | pt | Selecione a localidade a ser usada dentro da biblioteca CHAP Timeline. As localidades suportadas são:
|
| máximo | data hora | Nenhum | A data máxima que pode ser mostrada na linha do tempo. Se definido, não é possível mover a linha do tempo além deste ponto (não confundir com o parâmetro 'end' que controla a data de término da visualização inicial). O máximo em si é excluído. Se não for definido, nenhum máximo será aplicado. |
| min | data hora | Nenhum | A data mínima que pode ser mostrada na linha do tempo. Se definido, não é possível mover a linha do tempo antes deste ponto (não confunda com o 'início', que controla a data de início da visualização inicial). O mínimo está incluído. Se não for definido, nenhum mínimo será aplicado. |
| minheight | int | 0 | A altura mínima da linha do tempo em pixels quando 'altura' foi definida como "auto". |
| móvel | boleano | verdadeiro | Se for verdade, a linha do tempo é móvel. |
| pilha | boleano | verdadeiro | Se true, os eventos são empilhados uns sobre os outros para evitar eventos sobrepostos. |
| começar | data hora | Nenhum | A data no início da visualização da linha do tempo quando a linha do tempo é exibida inicialmente. Se não for definido, a data e a hora do primeiro evento na linha do tempo serão usadas. |
| showcurrenttime | boleano | verdadeiro | Se true, a linha do tempo mostra uma linha vertical vermelha exibindo a hora atual. |
| showmajorlabels | boleano | verdadeiro | Por padrão, a linha do tempo mostra os rótulos de data principais e secundários no eixo horizontal. Por exemplo, os rótulos menores mostram minutos e os rótulos principais mostram horas. Quando showmajorlabels for false, nenhum rótulo principal será exibido. |
| mostrar rótulos menores | boleano | verdadeiro | Por padrão, a linha do tempo mostra os rótulos de data principais e secundários no eixo horizontal. Por exemplo, os rótulos menores mostram minutos e os rótulos principais mostram horas. Quando showminorlabels é falso, nenhum rótulo secundário é mostrado. Quando showmajorlabels e showminorlabels forem falsos, nenhum eixo horizontal será visível. |
| largura | corda | 100% | A largura da linha do tempo. Isso pode ser qualquer unidade de tamanho CSS válida (px, em, %, etc). |
| com zoom | boleano | verdadeiro | Se true, a linha do tempo pode ser ampliada. |
| zoommax | int | 315360000000000 | Defina um intervalo máximo de zoom para o intervalo visível em milissegundos. Não será possível diminuir o zoom além desse máximo. O valor padrão é igual a cerca de 10.000 anos. |
| zoom | int | 10 | Defina um intervalo mínimo de zoom para o intervalo visível em milissegundos. Não será possível aumentar o zoom além desse mínimo. |
A documentação adicional para as opções de configuração suportadas pode ser encontrada na documentação da linha de tempo do vis.js. Observe que algumas das opções de configuração listadas nessa página não são suportadas por esta extensão, seja porque não fazem sentido incluí-las, por segurança, ou simplesmente porque ainda não as adicionei.
Sintaxe do evento
Dentro da tag <itimeline> você define a lista de eventos a serem exibidos na linha do tempo. Você deve incluir um evento por linha e os eventos não podem abranger várias linhas. Os eventos são definidos usando:
- <datahora>|<texto do evento>
- Exemplo:
2014-07-25T13:00:00Z|Phase 1 - Este formato define um evento fornecendo a hora do evento e algum texto descrevendo o evento.
- <datahora>/<datahora>|<texto do evento>
- Exemplo:
2014-07-25T08:00:00Z/2014-08-00:00:00+02:00|Project 1 - Este formato define um intervalo usando um intervalo IS8601. O primeiro datetime é a data e hora em que o intervalo começa, o segundo é a data e hora de término (inclusive).
- <datahora>|<nome do grupo>|<texto do evento>
- Exemplo:
2014-07-25T13:00:00Z|last phase|Deploy - Este formato define um evento em um grupo fornecendo a hora do evento, o nome do grupo no qual colocar o evento e algum texto descrevendo o evento.
- <datahora>/<datahora>|<nome do grupo>|<texto do evento>
- Exemplo:
2014-07-25T08:00:00Z/2014-08-00:00:00+02:00|first phase|Be agile - Este formato define um intervalo de eventos em um grupo. O primeiro datetime é a data e hora em que o intervalo começa, o segundo é a data e hora de término (inclusive), o nome do grupo determina em qual grupo o intervalo deve estar e o texto descreve o evento.
Os valores de 'datetime' devem ser fornecidos no formato discutido acima na seção Datas e horas . O 'nome do grupo' e o 'texto do evento' podem conter texto wiki, então você pode incluir imagens, links ou outra formatação. Observe que o texto wiki complexo deve ser evitado, ou você provavelmente fará com que a exibição da linha do tempo fique instável: não espere listas, tabelas ou qualquer coisa complicada para funcionar como esperado.
| Se você definir um grupo para qualquer um dos eventos definidos para uma determinada <itimeline>, você DEVE especificar grupos para todos os outros eventos nessa <itimeline> Se você não fizer isso, os eventos sem um grupo não serão exibidos! |
A ordem em que os eventos são definidos não é importante, e se a extensão não puder validar a definição de um evento, ela será ignorada.
O corpo da tag <itimeline> suporta transclusão e expansão de template, então você pode definir uma lista de eventos em outro lugar e transcluí-los no corpo da tag <itimeline>.
Demonstração
Uma demonstração do MediaWiki acessível ao público desta extensão não está disponível no momento. A documentação da Timeline contém vários exemplos dos recursos da biblioteca Timeline.
Notas
- ↑ A especificação ISO 8601 afirma que a hora pode estar no intervalo de 00 a 24, onde 00 é meia-noite no início do dia e 24 é meia-noite no final. No entanto, as implementações JavaScript Date.parse() em todos os navegadores que testei falham ao analisar strings de data com as horas definidas como 24 (porque JavaScript) e, por segurança, essa extensão evita isso.
Referências
- ↑ Tradução livre de https://www.mediawiki.org/wiki/Extension:InteractiveTimeline
