Wikipédia

Ajuda:Guia de edição/Como criar predefinições: diferenças entre revisões

Explorar interativamente o histórico
← Ver a alteração anteriorVer a alteração posterior →
Conteúdo apagado Conteúdo adicionado
VisualTexto wiki
ArthurBot (discussão | contribs)
Robôs
218 726 edições
m Bot: Adicionando: simple:Help:Template
Lépton (discussão | contribs)
16 468 edições
atualização
Linha 2:
As '''predefinições''' são páginas que normalmente se encontram no [[Wikipedia:Domínio|domínio]] predefinição, ou seja, o título da página da predefinição começa com ''Predefinição:'' seguida do nome da predefinição. Por exemplo, [[Predefinição:Esboço]] que para ser mostrada noutra página se usa <nowiki>{{esboço}}</nowiki> e ao salvar, a predefinição será mostrada nessa página.
 
Notar no entanto que páginas de outros domínios podem ser utilizadas como predefinições. Nesses casos é necessário referir o domínio (ao contrário das predefinições). São exemplo disso as ''[[Wikipedia:Userbox|Userboxes]]'', que a comunidade decidiu não colocar no domínio predefinição. Para se usar a ''userbox'' [[Wikipedia:Userbox/Sono]], por exemplo, é necessário digitar na página <nowiki>{{Wikipedia:Userbox/Sono}}</nowiki>. Caso essa ''userbox'' estivesse no domínio predefinição teria o nome "Predefinição:Userbox/Sono" e poderia ser utilizada apenas com <nowiki>{{Userbox/Sono}}</nowiki>. Regra geral, apenas devem ser colocadas no domínio predefinição, aquelas predefinições que são para ser utilizadas no domínio principal (artigos enciclopédicos).
 
Se pretende criar uma predefinição e não tem muitos conhecimentos sobre a edição de páginas na Wikipédia, o uso de [[Ajuda:Guia de edição/Usar tabelas|tabelas]] e alguns recursos avançados é recomendável que faça um pedido para criarem a predefinição em [[Wikipedia:Predefinições pedidas]] ou então pode tomar como exemplo uma predefinição já existente que seja semelhante à que quer criar e adaptá-la. As predefinições são de certa forma, no que respeita à edição de páginas, o recurso mais difícil de compreender e dominar da Wikipédia.
Linha 8:
Também é possível mostrar páginas completas, como se tratassem de predefinições, em outras páginas. Por exemplo, para mostrar as [[Especial:Recentchanges|mudanças recentes]] numa página (sem o cabeçalho), basta colocar o código <nowiki>{{Especial:Recentchanges}}</nowiki> nessa página. Para mostrar esta página que está a visualizar em outra, basta colocar o código <nowiki>{{Ajuda:Guia de edição/Como criar predefinições}}</nowiki>. Notar que estes métodos devem ser utilizados em casos especiais, e regra geral não devem ser aplicados em artigos da Wikipédia.
 
== Tipos de predefinições ==
=== Quanto à manipulação da informação ===
Quanto à funcionalidade, as predefinições podem ser classificadas por predefinições estáticas ou predefinições dinâmicas.
 
* '''Predefinições estáticas''' são aquelas que apresentam a mesma informação em todas as páginas em que é utilizada, ou pelo menos, não tem qualquer campo, opção ou parâmetros personalizáveis ao utilizá-la. Este tipo de predefinições são as mais simples de criar e utilizar. Alguns exemplos de predefinições estáticas: [[Predefinição:História da Arte]], [[Predefinição:Metallica]], [[Predefinição:Jogos Olímpicos]] e [[Predefinição:Tabela Periódica]].
 
* '''Predefinições dinâmicas''' são predefinições um pouco mais complexas que permitem introduzir dados personalizados ao utilizá-las em determinadas páginas. Normalmente este tipo de predefinições são como "modelos" que se podem preencher, de forma semelhante a "formulários" que têm definidos os campos de preenchimento, localização e aparência visual dos mesmos. Ao utilizar essas predefinições numa determinada página, devem ser introduzidos os dados personalizados dessa página. Dessa forma, as páginas que utilizem essas predefinições têm os dados organizados segundo uma determinada estrutura e apresentação. É um exemplo disso a [[Predefinição:Info país/País]] que se utiliza nos artigos da Wikipédia relativos a países, como em [[Portugal]] e [[Brasil]]. Outro exemplo, a [[Predefinição:Info biografia/Biografia]] é utilizada em artigos sobre pessoas, como em [[Albert Einstein]] e [[Leonardo da Vinci]].
 
Alguns tipos de predefinições dinâmicas utilizam outros recursos avançados e não têm necessariamente parâmetros opcionais. Por exemplo, a [[Predefinição:Arquivo histórico]] que deve ser aplicada apenas em páginas inactivas, normalmente do domínio Wikipedia, e nunca no domínio principal (artigos enciclopédicos) detecta se a predefinição foi aplicada numa página do domínio principal e coloca-a na [[:Categoria:!Páginas com predefinições indevidas]]. Outro exemplo, a [[Predefinição:Discussão]] que é utilizada nas secções da esplanada e os diversos cafés existentes, mostra informações diferentes consoante a página em que é mostrada.
 
 
{| width="100%" border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size:92%"
Linha 72 ⟶ 71:
|}
|}
 
Nestes exemplos apresentados, a predefinição estática de Albert Einstein provavelmente só seria utilizada na página de [[Albert Einstein]]. O segundo exemplo pode ser adaptado para ser aplicado em muitas páginas, pois o conteúdo pode ser preenchido com os dados específicos da pessoa titular da página.
 
=== Quanto à sua função ===
As predefinições caracterizam-se também em diferentes tipos consoante a sua função:
*'''Infocaixas''' (ou caixas de informação, do inglês ''Infoboxes'') - localizam-se normalmente no início das páginas do lado direito, apresentando determinadas informações essenciais de forma resumida. Exemplos de caixas de informação: [[Predefinição:Info/Elemento Químico]], [[Predefinição:Cinema/Ficha Técnica]] e [[Predefinição:Info biografia]].
 
* '''caixas de navegaçãoInfocaixas''' - auxiliam o leitor a navegar entre artigos do mesmo tema. Notar também que normalmente os artigos estão numa determinada categoria e se pode navegar entre categorias mas ao contrários destas, as(ou caixas de navegaçãoinformação, apresentamdo deinglês forma''Infoboxes'') resumida e prática outros artigos sobre o mesmo tema ou até divididos por subtemas. As caixas de navegação- encontramlocalizam-se normalmente no finalinício das páginas e por vezes no início da página do lado direito, casoapresentando nãodeterminadas hajainformações uma caixaessenciais de informaçãoforma ''(infobox)'' nesse localresumida. Exemplos de caixas de navegaçãoinformação: [[Predefinição:MesesInfo/Elemento Químico]], [[Predefinição:Páginas por característicasInfo/Filme]] [[Predefinição:Peqind]]e [[Predefinição:ÁfricaInfo/Biografia]].
 
* '''caixaCaixas de avisos ou indicações relevantesnavegação''' - destacamauxiliam determinadao mensagemleitor aosa leitoresnavegar eentre editoresartigos do mesmo tema. QuandoNotar aplicadostambém que normalmente emos artigos enciclopédicosestão numa determinada categoria e se pode navegar entre categorias mas ao contrários destas, normalmenteas essescaixas avisosde sãonavegação temporáriosapresentam de forma resumida e prática outros artigos sobre o mesmo tema ou até divididos por subtemas. LocalizamAs caixas de navegação encontram-se nanormalmente no maioriafinal das páginas e por vezes no início de umada página oudo delado umadireito secçãocaso danão página.haja Exemplosuma de caixascaixa de avisos:informação [[Predefinição:Parcial]]''(infobox)'' e [[Predefinição:Mánesse tradução]]local. Exemplos de caixas de informaçãonavegação: [[Predefinição:ReciclagemMeses]], [[Predefinição:EsboçoPáginas por características]] e[[Predefinição:Peqind]] [[Predefinição:FusãoÁfrica]].
 
* '''Caixa de avisos ou indicações relevantes''' - destacam determinada mensagem aos leitores e editores. Quando aplicados em artigos enciclopédicos, normalmente esses avisos são temporários. Localizam-se na maioria das vezes no início de uma página ou de uma secção da página. Exemplos de caixas de avisos: [[Predefinição:Parcial]] e [[Predefinição:Má tradução]]. Exemplos de caixas de informação: [[Predefinição:Reciclagem]], [[Predefinição:Esboço]] e [[Predefinição:Fusão]].
*'''indicações breves''' - indicam de forma breve que existe determinado recurso, por exemplo, um portal sobre um tema. Exemplos: [[Predefinição:Commons]] e [[Predefinição:Portal]].
 
* '''formatação deIndicações elementosbreves''' - auxiliamindicam nade normalizaçãoforma debreve terminadaque informação.existe Exemplosdeterminado derecurso, formataçãopor deexemplo, elementos:um [[Predefinição:Careceportal desobre fontes]]um tema. Exemplos: [[Predefinição:Citar webCommons]] e [[Predefinição:Ligações externasPortal]].
 
* '''predefiniçõesFormatação parade predefiniçõeselementos''' - algumasauxiliam predefiniçõesna destinam-senormalização ade seremterminada utilizadasinformação. emExemplos outrasde predefinições,formatação comode aelementos: [[Predefinição:!]]Carece parade contornar problemas técnicos, ou afontes]] [[Predefinição:esotéricoCitar web]] (quee também pode[[Predefinição:Ligações ser considerada uma caixa de aviso)externas]].
 
* '''Predefinições para predefinições''' - algumas predefinições destinam-se a serem utilizadas em outras predefinições, como a [[Predefinição:!]] para contornar problemas técnicos, ou a [[Predefinição:Esotérico]] (que também pode ser considerada uma caixa de aviso).
*'''páginas ou secções de outras páginas''' - são utilizadas para simplificar páginas complexas ou para permitir a inclusão de uma secção em várias páginas, como a [[Predefinição:Projetos correlatos]] que é mostrada na [[Página principal]] e pode ser utilizada em outras páginas. No caso da [[Predefinição:Projetos correlatos]] é por vezes colocada nas páginas de usuários.▼
 
▲* '''páginasPáginas ou secções de outras páginas''' - são utilizadas para simplificar páginas complexas ou para permitir a inclusão de uma secção em várias páginas, como a [[Predefinição:Projetos correlatos]] que é mostrada na [[Página principal]] e pode ser utilizada em outras páginas. No caso da [[Predefinição:Projetos correlatos]] é por vezes colocada nas páginas de usuários.
*'''marcações invisíveis''' - servem normalmente apenas para colocar o artigo em que a predefinição é usada numa determinada categoria ou para incluir esse artigo nos afluentes da predefinição. Este tipo de predefinições permite facilitar a classificação na manutenção de determinados artigos. Exemplos: [[Predefinição:Seminterwiki]] e [[Predefinição:Semfichatécnica]]. Apesar destas predefinições poderem ser substituídas por uma categoria, permite no entanto filtrar por [[Wikipedia:Domínio|domínio]] as páginas que usem a predefinição. Por exemplo, [http://pt.wikipedia.org/w/index.php?offset=&limit=100&target=Predefini%C3%A7%C3%A3o%3ASeminterwiki&title=Especial%3AWhatlinkshere&namespace=4 esta lista] mostra onde é utilizada a predefinição no domínio Wikipedia.▼
 
▲* '''marcaçõesMarcações invisíveis''' - servem normalmente apenas para colocar o artigo em que a predefinição é usada numa determinada categoria ou para incluir esse artigo nos afluentes da predefinição. Este tipo de predefinições permite facilitar a classificação na manutenção de determinados artigos. Exemplos: [[Predefinição:Seminterwiki]] e [[Predefinição:Semfichatécnica]]. Apesar destas predefinições poderem ser substituídas por uma categoria, permite no entanto filtrar por [[Wikipedia:Domínio|domínio]] as páginas que usem a predefinição. Por exemplo, [http://pt.wikipedia.org/w/index.php?offset=&limit=100&target=Predefini%C3%A7%C3%A3o%3ASeminterwiki&title=Especial%3AWhatlinkshere&namespace=4 esta lista] mostra onde é utilizada a predefinição no domínio Wikipedia.
==Criar uma predefinição==▼
 
▲== Criar uma predefinição ==
Para criar uma predefinição para ser utilizada em artigos enciclopédicos, o título deve ser <code>Predefinição:''nome da predefinição''</code> no qual deve substituir <code>''nome da predefinição''</code> pelo nome que quer atribuir à predefinição. Note que, tal como qualquer página da Wikipédia, não pode haver duas predefinições com o mesmo nome. Para criar uma predefinição também pode usar o campo seguinte, escrevendo o nome da predefinição a seguir ao texto "Predefinição:" (não o retire, caso contrário irá criar uma página no domínio principal como um artigo enciclopédico e não uma predefinição)
 
Linha 104 ⟶ 105:
Ao criar a predefinição deve escolher um nome suscito mas descritivo, ou seja, se quiser criar uma predefinição sobre obras de Albert Einstein, não deve criar uma predefinição com o nome ''Predefinição:AE''. Se for ''Predefinição:Albert Einstein'' é aceitável, sendo preferível um nome mais descritivo como ''Predefinição:Albert Einstein (obras)'' ou ''Predefinição:Obras de Albert Einstein'' por exemplo. O nome da predefinição é bastante importante por várias razões, assumindo bastante importância no código que é mostrado nas páginas onde é utilizada. Alguém que não conheça essa predefinição pode ter dificuldades em perceber o que significa o código <nowiki>{{AE}}</nowiki> ao contrário de <nowiki>{{Albert Einstein (obras)}}</nowiki> ou <nowiki>{{Obras de Albert Einstein}}</nowiki>.
 
=== Criar uma predefinição estática ===
As predefinições estáticas são as mais fáceis de criar e devem ser utilizadas nos casos em que se quer mostrar as mesma informação em todas as páginas. A melhor forma de criar uma é usar uma predefinição já existente e adaptá-la. Por exemplo, caso a predefinição [[Predefinição:Guns N' Roses]] não existisse na Wikipédia, podia-se copiar o conteúdo da [[Predefinição:Green Day]], adaptando o texto e eventualmente o código da predefinição.
 
=== Criar uma predefinição dinâmica ===
Para criar uma predefinição dinâmica, salvo algumas excepções, é necessário definir os campos opcionais necessários. No entanto, tal como qualquer página da Wikipédia, pode-se adicionar ou retirar esses campos mais tarde ou até mesmo corrigir eventuais falhas na predefinição que se venham a descobrir.
 
A parte principal das predefinições dinâmicas são os parâmetros ou campos para introdução de dados ao usar a predefinição em artigos. Ao criar a predefinição, os parâmetros devem ser colocados entre 3 chavetas de cada lado: <nowiki>{{{nome do parâmetro}}}</nowiki>, caso contrário, se colocar apenas entre 2 chavetas será interpretada como usar a predefinição com esse nome. O nome dos campos deve ser sucinto mas suficientemente descritivo. Existem algumas restrições quanto ao nome dos parâmetros: não pode conter o símbolo '''<nowiki>|</nowiki>''' por exemplo.{{carece de fontes|data=Dezembro de 2008}}
 
==== Usar uma predefinição dinâmica ====
Dependendo da quantidade de parâmetros da predefinição, pode-se colocar o código da predefinição dinâmica de várias formas nos artigos:
 
{| class="wikitable" style="font-size:92%" width="100%"
!Código
Linha 142 ⟶ 144:
|'''Utilização recomendada no caso da predefinição ter muitos campos para preencher''', pois facilita a organização e a legibilidade dos mesmos.
|}
 
Os exemplos apresentados nesta tabela são todos válidos e funcionais apresentando apenas diferentes modos de apresentação ao editar as páginas onde a predefinição é utilizada.
 
== Interwikis e categorias ==
Os interwikis e categorias da própria predefinição devem ser colocados dentro de
<n<nowiki>oinclude></noinclud</nowiki>e> no final do código da predefinição. Por exemplo:
 
<pre>
(código da predefinição)
Linha 157 ⟶ 161:
</noinclude>
</pre>
 
Se não o fizer, as categorias e interwikis aparecerão em todos os artigos em que a predefinição for utilizada. Esta marcação especial significa de forma literal "não incluir" quando a predefinição for utilizada em outras páginas.
 
== Substituição ==
Em certos casos, em vez de utilizar uma predefinição como <nowiki>{{nome da predefinição}}</nowiki> deve-se usar <nowiki>{{subst:nome da predefinição}}</nowiki>. Ao fazê-lo, o código da predefinição será gravado na página e a predefinição não terá essa página como afluente. Note que se depois a predefinição for alterada, essa página onde foi usada a substituição não será actualizada. Devido a esse factor, este recurso só deve ser utilizado em certos casos especiais. Normalmente apenas se aplica a substituição em avisos a usuários, e apenas no domínio "Usuário Discussão:". Regra geral, para avisos em páginas enciclopédicas nunca se deve substituir o código da predefinição. Existem sertas excepções, em predefinições que adicionam a data, e que na verdade só são parcialmente substituídas porque se substitui uma predefinição que utiliza o código de outras predefinição. Ver por exemplo a [[Predefinição:VDA3VDA]] que se substituir e utiliza a [[Predefinição:Copyright2VDA2]]. Neste caso ao substituir o código, apenas se está a fazer na [[Predefinição:VDA3VDA]] e não na [[Predefinição:Copyright2VDA2]].
 
== Considerações a ter ==▼
* '''Ao alterar uma predefinição''' tenha em conta que pode estar a ser utilizada em centenas ou milhares de páginas. Pode averiguar em que páginas é utilizada clicando em "artigos afluentes" do lado esquerdo em "ferramentas" ao visualizar a predefinição. Se não tem a certeza se determinada alteração funciona, recomenda-se copiar o código da predefinição para a [[Wikipedia:Página de testes]] ou uma página de testes localizada na sua conta de usuário. Caso altere a predefinição, deve utilizar o botão "mostrar previsão" e fazer o mínimo de edições seguidas. Cada alteração que se faça em predefinições obriga os servidores da Fundação Wikimedia a actualizar a ''[[cache]]'' de todas as páginas em que a predefinição é utilizada ao contrário de uma página "normal" em que só é preciso actualizar a ''cache'' dessa página.▼
* '''Se alterar o nome de um campo de uma predefinição''' existente que seja dinâmica, é necessário alterar o nome desse campo em todas as páginas onde a predefinição é utilizada (artigos afluentes).▼
* '''Caixas de informação''', '''''infoboxes''''' e '''caixas de navegação''' (que se situem no início do artigo do lado direito) - regra geral, a largura destas predefinições não deve ser superior a 300 pixels. A largura ideal situa-se entre 200 e 250 pixels.▼
* '''Caixas de navegação''' (que se situem no final das páginas) - devem ocupar a largura total.▼
* '''Caixa de avisos ou indicações relevantes''' - ocupam cerca de 80% da largura total. Por uma questão de uniformização, este tipo de predefinições devem utilizar como base a [[Predefinição:Ambox]] (caso sejam avisos para o domínio principal). Para criar novos avisos por favor consultar a documentação dessa predefinição ou das predefinições da seguinte lista, conforme o domínio a que o aviso se aplica:▼
 
▲==Considerações a ter==
▲*'''Ao alterar uma predefinição''' tenha em conta que pode estar a ser utilizada em centenas ou milhares de páginas. Pode averiguar em que páginas é utilizada clicando em "artigos afluentes" do lado esquerdo em "ferramentas" ao visualizar a predefinição. Se não tem a certeza se determinada alteração funciona, recomenda-se copiar o código da predefinição para a [[Wikipedia:Página de testes]] ou uma página de testes localizada na sua conta de usuário. Caso altere a predefinição, deve utilizar o botão "mostrar previsão" e fazer o mínimo de edições seguidas. Cada alteração que se faça em predefinições obriga os servidores da Fundação Wikimedia a actualizar a ''[[cache]]'' de todas as páginas em que a predefinição é utilizada ao contrário de uma página "normal" em que só é preciso actualizar a ''cache'' dessa página.
▲*'''Se alterar o nome de um campo de uma predefinição''' existente que seja dinâmica, é necessário alterar o nome desse campo em todas as páginas onde a predefinição é utilizada (artigos afluentes).
▲*'''Caixas de informação''', '''''infoboxes''''' e '''caixas de navegação''' (que se situem no início do artigo do lado direito) - regra geral, a largura destas predefinições não deve ser superior a 300 pixels. A largura ideal situa-se entre 200 e 250 pixels.
▲*'''Caixas de navegação''' (que se situem no final das páginas) - devem ocupar a largura total.
▲*'''Caixa de avisos ou indicações relevantes''' - ocupam cerca de 80% da largura total. Por uma questão de uniformização, este tipo de predefinições devem utilizar como base a [[Predefinição:Ambox]] (caso sejam avisos para o domínio principal). Para criar novos avisos por favor consultar a documentação dessa predefinição ou das predefinições da seguinte lista, conforme o domínio a que o aviso se aplica:
{{Predefs mbox ver também}}
 
Linha 204 ⟶ 210:
----------------------------------------------------------------->
 
== {{verVer também}} ==
* [[Ajuda:Guia Prático/Predefinições]] - guia resumido sobre predefinições
* [[Wikipedia:Predefinições]]
* [[Wikipedia:Lista de predefinições]] - listas de predefinições catalogadas por temas que existem na Wikipédia lusófona.
* [[Ajuda:ParserFunctions]] - códigos avançados para utilizar em certas predefinições
* [[Ajuda:Palavras mágicas]] - códigos avançados para utilizar em certas predefinições ou páginas
* [[Ajuda:Guia Prático/Tabelas]] - guia resumido sobre tabelas
* [[Ajuda:Guia de edição/Usar tabelas]] - guia avançado de tabelas
 
[[als:Hilfe:Vorlage]]
Obtida de "https://pt.wikipedia.org/wiki/Ajuda:Guia_de_edição/Como_criar_predefinições"