Módulo:Mandatos/doc

Descrição

Módulo criado para gerar mais facilmente a linha do tempo de mandatos. Essa página foi inicialmente criada para gerar o Gráfico de burocratas, mas pode ser utilizada para descrever outros mandatos.

Para produzir o gráfico, é utilizada a Extensão EasyTimeline.

Uso

{{#invoke:Mandatos|linhadotempo
 | datainicio=
 | datafim=
 | prefixo_barra=

 ...

}}

datainicio

Data de início do gráfico, no formato dd/mm/yyyy.

datafim

Data de término do gráfico, no formato dd/mm/yyyy. Para que o limite do gráfico se ajuste automaticamente com o passar do tempo, pode-se utilizar variáveis como "31/05/2024" (data atual) ou "31/12/2024" (fim do ano atual).

prefixo_barra

A cada ano de sucessão, é gerada uma barra horizontal descrevendo o ano. Essa propriedade permite que um texto seja informado como prefixo a esse texto. Ex.: "Usuários eleitos em"

demais parâmetros

Esse módulo espera uma lista de parâmetros não nomeados onde cada um informa um conjunto de três valores separados por ponto-e-vírgula. Os parâmetros são os seguites:

1. data inicial do mandato, formato dd/mm/yyyy
2. data final do mandato, formato dd/mm/yyyy
3. nome do usuário

Para as datas, é possível informar ainda "today", para que a data se atualize automaticamente para a data atual; ou "end" para que a data seja sempre a última data do gráfico (mesma informada no parâmetro "datafim").

Exemplos

A título de exemplo, o código a seguir:

{{#invoke:Mandatos|linhadotempo
 | datainicio=01/01/2022
 | datafim=31/12/{{CURRENTYEAR}}
 | prefixo_barra=Usuários eleitos em
 | 01/01/2022 ; 19/03/2022 ; Usuário 1
 | 10/02/2022 ; 20/03/2024 ; Usuário 2
 | 06/06/2023 ; 21/10/2023 ; Usuário 3
 | 15/07/2023 ; end        ; Usuário 4
 | 20/01/2024 ; 22/03/2024 ; Usuário 5
 | 27/02/2024 ; today      ; Usuário 6
 | 03/05/2024 ; 01/11/2024 ; Usuário 7
}}

produz o gráfico:

Ver também

• Wikipédia:Gráfico de burocratas
• Extension:EasyTimeline no MediaWiki