Central da Comunidade
Advertisement

Predefinições são páginas desenhadas para serem incluídas em outras páginas. Elas são encontradas no namespace e usualmente mostram materiais que precisam ser mostradas em múltiplas páginas ao mesmo tempo. Predefinições são ferramentas vitais para as wikis funcionarem de forma eficiente.

Existem muitos tipos de predefinição diferentes que preenchem diferentes propósitos. Predefinições como infoboxes ou citações promovem um estilo uniforme a wiki, enquanto outras são usadas para estruturar uma única página, tal como a página principal.

Páginas de predefinições são criadas e modificadas usando o editor de fonte. A maioria das predefinições podem ser adicionadas em páginas usando qualquer interface de editor, mas predefinições complicadas podem ser mais facilmente trabalhadas no editor de fonte. Editando uma predefinição transcluída irá atualizar o modo como ela aparece em todas as páginas onde a predefinição é transcluída.

Encontrando e usando predefinições

Um usuário inserindo uma predefinição, ao clicar no dropdown "Insert", então encontrando "templates"

Insira uma predefinição com o Editor visual usando esse dropdown.

Novas comunidades do Fandom possuem uma série de predefinições prontas para serem usadas. Você pode ver a lista completa de predefinições de qualquer comunidade ao ir para o Special:AllPages e selecionar a opção "Template" do menu dropdown namespace.

Uma vez que você tem conhecimento das predefinições que tem para trabalhar, você pode começar a pensar em como usá-las em sua forma mais básica. As instruções são um pouco diferentes dependendo da interface do editor:

  • No Editor visual, clique na palavra em negrito "INSERIR" encontrada no meio da parte superior da página e clique em "Templates" na lista dropdown. Você também pode digitar "{{" na página em si. Na caixa de diálogo que aparecerá, procure pelo nome da predefinição que você deseja incluir.
  • No editor de fonte, simplesmente digite {{NomePredefinição}} substituindo o "NomePredefinição" pelo nome da predefinição que deseja usar.

Criando uma predefinição básica

Predefinições podem ser poderosas, mas algumas predefinições podem ser complicadas. Às vezes ajuda ao começar criando o tipo mais simples possível de predefinição.

  • Em sua comunidade, navegue para Predefinição:Exemplo usando a barra de endereço do seu navegador. Na Central da Comunidade, esse seria https://comunidade.fandom.com/wiki/Predefini%C3%A7%C3%A3o:Exemplo.
  • Clique no botão "Criar Fonte" no canto superior direito da página. Isso irá abrir o editor de fonte.
  • Um pop-up irá aparecer pedindo que você escolha o tipo de predefinição. Selecione a opção que melhor descreve a predefinição que você quer fazer, ou selecione "Unknown" se não tiver certeza, e então clique no botão "Salvar" no canto superior direito.
  • Digite algumas palavras ou uma sentença no editor. Exemplo: Esse é um exemplo de texto de predefinição. Para propósitos de demonstração.
  • Clique no botão "Salvar" no canto superior direito. Você acaba de criar uma predefinição!
  • Vá para o seu perfil de usuário ou outra página de testes em sua comunidade.
  • Siga os passos acima para inserir a predefinição dependendo do seu editor de preferência.

A página que você criar deve mostrar o seguinte:

Esse é um exemplo de texto de predefinição. Para propósitos de demonstração.

Parabéns! Você acaba de criar e usar uma predefinição! Agora você poderá mudar o conteúdo de sua predefinição e adicioná-la a mais páginas para torná-la mais útil em sua comunidade.

Para um guia completo sobre criar e usar predefinições, visite Help:Templates on MediaWiki para aprender mais.

Uso avançado

Parâmetros de predefinição

Uma imagem de um usuário selecionando parâmetros no Editor visual, em uma predefinição chamada "Album". Os parâmetros da predefinição contém "title, image, imagecaption", e um botão dizendo "Add more fields"

Selecionando parâmetros na ferramenta de predefinição no Editor visual

Muitas predefinições apresentam parâmetros. Pense nelas como variáveis. Diferentes páginas podem usar a mesma predefinição com valores diferentes para cada parâmetro. Dependendo da predefinição, isso pode alterar o texto da predefinição ou a forma como a predefinição é vista.

Vamos pegar a Template:Wikipedia como exemplo. Essa predefinição é projetada para páginas que usam conteúdo de uma página da Wikipedia; ela cria uma caixa com um link para a página da Wikipedia. Adicionando apenas {{Wikipedia}} assume-se que a página na Wikipedia tem exatamente o mesmo título que a página onde a predefinição está sendo usada. No entanto, se as duas páginas possuírem títulos diferentes, nós podemos usar um parâmetro para alterar o link. Adicionando {{Wikipedia|Microsoft}} irá assegurar que o link apontará para a página "Microsoft" da Wikipédia. O Editor visual fornece opções para definir parâmetros quando se adiciona uma predefinição ou se clica nela no editor.

Para aprender mais, veja Ajuda:Parâmetros de predefinição.

Substituindo predefinições

Substituir uma predefinição é como usar um cortador de biscoitos.

Adicionando uma predefinição a uma página pelo Editor visual ou ao digitar {{TemplateName}} irá sempre mostrar a revisão mais recente da predefinição naquela página. Esse processo é chamado de transclusão.

Uma forma diferente de usar uma predefinição é substituir o seu conteúdo dentro da página. Substituição de predefinição somente pode ser feita no editor de fonte ao mudar o código para {{subst:TemplateName}}. Uma vez que a página é salva, o link para a predefinição é mudado pela saída da predefinição.

Editar a predefinição não irá atualizar o conteúdo que foi substituído dentro da página. Pense na substituição como se fosse um cortador de biscoitos: se você usar um cortador de biscoitos para fazer alguns biscoitos e então mudar o formato do cortador, os biscoitos que você já fez não mudarão a sua forma.

Para saber mais, veja Ajuda:Substituindo predefinições.

Documentação

Suponha que você quer usar uma predefinição. Você tenta usar uma predefinição padrão, tal como {{Notice}}. No entanto, você não sabe como usar a predefinição e não deseja olhar o código da predefinição.

Essa é a parte que entra a documentação. Muitas predefinições complexas às vezes possuem uma seção de documentação, adicionada usando {{documentation}}. A documentação de uma predefinição é útil para fornecer instruções de como usar a predefinição, os seus parâmetros e também os exemplos da predefinição. Ela também pode ter mw:Help:TemplateData para auxiliar quando utilizando o Editor visual.

Você pode facilmente adicionar a documentação em predefinições que não tenham uma, caso você saiba como a predefinição é usada.

Para saber mais, visite Ajuda:Documentação de predefinição.

Predefinições baseadas em Lua

A maioria das predefinições básicas são projetadas usando wikitexto, o mesmo código usado nas páginas. No entanto, as predefinições avançadas de wikitexto podem parecer muito complicadas para ler e diminuir a velocidade das páginas em que são usadas. Nesses casos, Lua é uma alternativa. Embora a codificação em Lua possa parecer assustadora no início, os modelos baseados em Lua têm um desempenho mais rápido do que suas contrapartes de wikitexto e podem ser mais fáceis de ler e entender. O Fandom Developers Wiki mantém uma lista de Global Lua Modules projetados para substituir ou aprimorar predefinições comuns wikitexto; alguns desses módulos globais também estão disponíveis em novas comunidades.

Para saber mais, visite Ajuda:Lua.

Copiando e atualizando predefinições

Colaboradores em todo o Fandom fizeram todos os tipos diferentes de predefinições. Muitas vezes, é mais simples copiar uma predefinição existente e modificá-la para suas necessidades, em vez de criar uma do zero. Na maioria dos casos, você pode copiar predefinições de outras wikis do Fandom com base na licença compartilhada CC-BY-SA License. Dar crédito à comunidade da qual você copiou a predefinição é vital.

É recomendado exportar e importar predefinições, pois mantém o histórico de edições que é vital para a licença CC-BY-SA requisitada pelo FANDOM (apesar de que é necessário ter os direitos de administrador).

Se não puder importar páginas, uma alternativa é copiar a predefinição. Aqui estão alguns passos básicos para copiar a maioria das predefinições:

  1. Encontre a predefinição que quer copiar.
  2. Clique no botão "Editar", selecione todo o wikitexto e copie.
  3. Crie uma nova página de predefinição em sua comunidade.
  4. Cole o wikitexto que você copiou, adicione um resumo de edição no qual credita a wiki onde você obteve a predefinição, então clique no botão "Salvar".

Mais informações podem ser encontradas nessa página da Templates Wiki.

Onde encontrar mais predefinições

  • Templates Wiki possui muitas predefinições úteis desenhadas para uso em outras wikis (Predefinições recomendadas para copiar).
  • Dev Wiki possui um repositório do Global Lua Modules que pode ser usada em qualquer wiki do Fandom. Veja a documentação de cada módulo sobre como criar a predefinição apropriada para a sua wiki e conecte-a com o código Lua. Algumas melhorias de CSS ou JavaScript na Dev Wiki também tem predefinições relacionadas.
  • Central da Comunidade tem muitas predefinições, apesar de que muitas delas não são úteis para outras wikis. Algumas delas servem como predefinições globais e podem ser usadas por qualquer wiki sem precisar copiar - veja Ajuda:Predefinições compartilhadas.
  • Wikipedia ou MediaWiki.org, se bem que você precisará ler a guia sobre copiar as predefinições. Credite-os usando {{wikipedia}} ou especificando a origem apropriada.
  • Outras wikis relacionadas com o tópico. Por exemplo, se você está em uma wiki sobre TV, veja outras wikis sobre TV que você admira, particularmente aquelas que tenham um tópico similar.
  • Fandom UCP Starter Pages. É daqui de onde vem a página principal e predefinições iniciais quando você cria uma nova wiki hoje. Às vezes as predefinições ali contidas podem ajudar wikis mais antigas ou servir de base para desenvolver uma outra predefinição.

Veja mais

Mais ajuda e feedback

Advertisement