Predefinição:Melhores do Wikilivros/doc

Esta é uma subpágina de documentação para Predefinição:Melhores do Wikilivros (Clique na ligação se você quer vê-la diretamente).
Ela contém informações sobre o uso, categorias e outros conteúdos que não são parte da predefinição propriamente dita.

Esta predefinição foi construída com base na predefinição Main Page featured books do projeto anglófono, e na seção "Os Melhores do Wikilivros", da versão da nossa página principal na ocasião em que a predefinição foi criada.

Uso editar

A utilização da predefinição é bastante simples. Basta adicioná-la à página principal usando {{Melhores do Wikilivros}}.

Funcionamento editar

A predefinição utiliza-se de comandos #switch para alternar de hora em hora os melhores trabalhos que são exibidos na página principal. A parte mais importante do código consiste em algo assim:

{{#switch: {{#expr:((24 * {{CURRENTDAY}} + {{CURRENTHOUR}}) mod NNN) + 1}}
   |   1   = {{Descrição/Trabalho 1}}
   |   2   = {{Descrição/Trabalho 2}}
   |   3   = {{Descrição/Trabalho 3}}

   .
   .
   .

   |  NNN  = {{Descrição/Trabalho NNN}}
}}

onde:

  • CURRENTDAY: vai de 1 a 31
  • CURRENTHOUR: vai de 0 a 23
  • 24*CURRENTDAY + CURRENTHOUR: vai de 24 até 767 (=24*31 + 23)
  • ((...) mod NNN) + 1: troca os números do intervalo [24,767] por um número do intervalo [1, NNN]

Atualização editar

O procedimento para atualizar a predefinição quando novos trabalhos são eleitos deve ser feito com cuidado, mas é bastante simples, e consiste das seguintes etapas:

  • Criar uma descrição para o trabalho, em uma subpágina da predefinição {{Descrição}};
  • Adicionar em uma nova linha no código da predefinição Melhores do Wikilivros, contendo o seguinte:
|  NNN  = {{Descrição/NomeDoTrabalho}}
Tomando o cuidado de colocar o trabalho na seção adequada (livro, capítulo ou módulo).
  • Atualizar o número de trabalhos naquela seção (indicado por NNN, neste texto). Tal número aparece em somente dois lugares:
  1. | NNN = {{Descrição/NomeDoTrabalho}} e
  2. {{#switch: {{#expr:((24 * {{CURRENTDAY}} + {{CURRENTHOUR}}) mod NNN) + 1}}


Veja também editar