Ajuda:Linha do tempo: mudanças entre as edições

Sem resumo de edição
Linha 138: Linha 138:
</itimeline></nowiki></pre>
</itimeline></nowiki></pre>


Datas e horários
==== 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:
Todas as datas e horas especificadas em uma tag <nowiki><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:</nowiki>


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.
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.
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 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'.
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 [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.
Quando fornecido, os horários devem ser especificados como uma hora de dois dígitos (00 a 23 <ref group="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.</ref>), 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].
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:
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-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-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-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)
* 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:
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 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 da semana
Datas ordinais
* Datas ordinais
Frações decimais para horas, minutos ou segundos.
* 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)
* Designador de fuso horário opcional (o designador de fuso horário deve ser especificado se for fornecido um horário)
Durações
* 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.
* 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
* Intervalos de repetição
Representações truncadas
* Representações truncadas
Escalas de tempo para representar calendários não gregorianos
* Escalas de tempo para representar calendários não gregorianos
Parâmetros [ editar ]
 
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âmetros ====
Os seguintes parâmetros podem ser especificados na tag <nowiki><itimeline>. Todos os parâmetros são opcionais e diferenciam maiúsculas de minúsculas e, se não especificados, o padrão é usado.</nowiki>
{| class="wikitable sortable"
!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:
 
* ca: catalão (alias: ca_ES)
* pt: inglês (alias: en_US, en_UK)
* nl: holandês (alias: nl_NL, nl_BE)
* fi: finlandês (alias: fi_FI)
* fr: francês (alias: fr_FR, fr_BE, fr_CA)
* de: alemão (alias: de_DE, de_CH)
* da: dinamarquês (alias: da_DK)
* ru: russo (alias: ru_RU)
* es: espanhol (alias: es_ES)
* tr: turco (alias: tr_TR)
|-
|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 <nowiki><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:</nowiki>
 
; <datahora>|<texto do evento>
: ''Exemplo:<code>2014-07-25T13:00:00Z|Phase 1</code>''
: Este formato define um evento fornecendo a hora do evento e algum texto descrevendo o evento.
 
; <datahora>/<datahora>|<texto do evento>
: ''Exemplo:<code>2014-07-25T08:00:00Z/2014-08-00:00:00+02:00|Project 1</code>''
: 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:<code>2014-07-25T13:00:00Z|last phase|Deploy</code>''
: 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:<code>2014-07-25T08:00:00Z/2014-08-00:00:00+02:00|first phase|Be agile</code>''
: 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.
{| class="wikitable"
|
|Se você definir um grupo para ''qualquer um'' dos eventos definidos para uma determinada <nowiki><itimeline>, você </nowiki>'''DEVE''' especificar grupos para todos os outros eventos nessa <nowiki><itimeline> Se você não fizer isso, os eventos sem um grupo não serão exibidos!</nowiki>
|}
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 <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 [ editar ] ==
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.
 
== Notas ==
<references group=Notas />


== Referências ==
== Referências ==
<references />


* https://www.mediawiki.org/wiki/Extension:InteractiveTimeline


[[Categoria:Testes]]
[[Categoria:Testes]]


__NOTOC__
__NOTOC__