Ajuda:Editando/Guia de DPL

De RuneScape Wiki
Ir para: navegação, pesquisa
Este artigo está em construção
Adicionando conteúdo aos poucos
As informações contidas aqui podem não ser precisas ou completas. Ajude-nos fazendo ele crescer!


Código-fonte.svg
Este guia foi escrito para edições que usam Editor Código-fonte
Se você ainda não mudou para editor código-fonte você pode descobrir como aqui.

DynamicPageList3, geralmente simplificada para DPL3 ou apenas DPL, é uma ferramenta poderosa para gerar listas de páginas com base em uma consulta. Ela também pode gerar os dados de várias maneiras, a mais básica delas sendo uma lista de marcadores, adequada para se copiar e colar em uma lista AWB.

A principal desvantagem da DPL é que ela pode aumentar significativamente o tempo de carregamento de uma página. Em geral, deve ser evitada de alguma forma para uma página geral do espaço nominal principal.

Esta página é apenas uma tradução (a página original pode ser visitada ao clicar aqui) da releitura do manual feita pelo usuário Gaz Lloyd, que já possui grande experiência com a ferramenta. Apenas os comandos básicos e úteis foram descritos no guia, com alguns exemplos trabalhados. Para maiores detalhes, veja o manual de referência pricipal. Assume-se que quem está lendo esse guia entenda sobre wikitexto razoavelmente bem.

Sintaxe neste guia[editar código-fonte]

Para maior clareza, em todo este guia é utilizado a formatação de código ao se referir a parâmetros, que são obrigatoriamente utilizados em inglês.

Em respeito a DPL, o 'parâmetro' é uma parte inteira de uma consulta, com o nome do parâmetro à esquerda do =, e o valor do parâmtro à direita. Geralmente, se refere ao valor do parâmetro apenas como 'valor', a menos que precise ser específico.

No decorrer do artigo, os operadores lógicos serão destacados em letras maiúsculas - AND OR NOT XOR etc.

Consultas DPL de exemplo usarão o seguinte formato e estilo:

Explicação curta da consulta (com links para categorias relevantes etc.)
chamada da DPL em texto pré-formatado
Resultado da chamada da DPL

Básico[editar código-fonte]

Explicação[editar código-fonte]

DPL é efetivamente uma ferramenta de consulta de banco de dados em nível de editor. Você cria uma consulta, que a extensão DPL então interpreta e obtém as páginas do banco de dados e formata os resultados conforme necessário.

Isso faz com que pareça muito mais complexo do que realmente é.

Quer uma lista de páginas em uma categoria em ordem alfabética reversa? Certo.
Quer ver quais páginas estão em uma determinada categoria que também usam uma predefinição específica? Beleza.
Quer páginas em que o título corresponda a uma expressão regular? Feito.
Quer gerar um banco de dados dinâmico de equipamentos com filtros personalizados? Por que não?.
Páginas por data de criação? Páginas pela última edição? etc etc etc

Chamada[editar código-fonte]

DPL pode ser chamada de duas maneiras. Na maioria das vezes, não há diferença entre os dois métodos, mas algumas coisas mais complexas resultam em uma variação entre os dois.

Tags de extensão

O primeiro método usa tags de extensão:

<dpl>
parâmetro1 = valor1
parâmetro2 = valor2
...
</dpl>

As tags de extensão possuem cada parâmetro em uma nova linha.

As funções parser (e outras como o wikitexto) na consulta não são avaliadas nas tags de extensão. Se precisar usá-las, você deve usar a outra chamada. Na maioria dos parâmetros, os caracteres de escape não são obrigatórios, mas funcionarão bem (embora você precise usar um escape de nova linha).

Em geral, foi usado esse método.

Função parser

O método de função parser é chamado como qualquer outra função parser:

{{#dpl:
|parâmetro1 = valor1
|parâmetro2 = valor2
...
}}

A sintaxe da função parser requer uma barra vertical para separar cada parâmetro. Eles não precisam estar em uma nova linha, mas convencionalmente estão para maior clareza. (O primeiro parâmetro não precisa de um tubo, mas geralmente se inclui um para maior clareza.)

Os caracteres de escape geralmente são necessários para parâmetros na chamada da função parser. Funções parser de uso geral e wikitexto também serão avaliados antes da consulta, portanto, este é o método necessário para predefinições, aninhamento e filtragem complexa.

Caracteres de escape[editar código-fonte]

Como mencionado acima, a DPL inclui vários caracteres de escape que são frequentemente necessários. Eles serão mencionados quando utilizados abaixo.

Caractere MediaWiki Escape em DPL Alt code Utilização
< « Alt+174 Chamar outra extensão dentro de um parâmetro de saída (veja #include).
> » Alt+175
{{ ²{ Alt+253 depois { Chamar uma predefinição/parser dentro de um parâmetro de saída (veja #include).
}} } depois Alt+253
| ¦ Alt+0166 Utilizada em predefinições, ou quando | é utilizado como um caractere 'ou' nos parâmetros.
nova linha \n \ n Insere uma nova linha para que as coisas que precisam começar em uma linha (como *, #, tabelas, etc.) funcionem corretamente.
Alt + 0182

Consultas simples[editar código-fonte]

Em primeiro lugar, algumas consultas simples. Esses tipos de consultas são apenas interseções de várias listas (categorias, o que linka aqui, etc.), produzidos como uma lista.

Inicialmente, para economizar tempo de processamento, se utilizará o parâmetro count para todas as consultas. Os parâmetros de contagem limitam o resultado máximo de uma consulta ao valor fornecido - consulte #Limitando o tamanho do conjunto de resultados para obter mais detalhes. -->

Filtros básicos[editar código-fonte]

Category[editar código-fonte]

Para listar páginas presentes dentro de uma categoria, você utiliza o parâmetro category. Sem uma ordem especificada (consulte a seção posterior), as páginas são listadas em ordem alfabética do título da página (PAGENAME, sem o espaço nominal, como Usuário: ou Arquivo:).

Páginas na Categoria:Objetos
<dpl>
category = Objetos
count = 5
</dpl>
Combinação - AND

Categorias podem ser combinadas de dois modos - OR (as páginas estão em pelo menos uma das categorias) e AND (as páginas estão em todas as categorias). Todos os parâmetros para uma chamada DPL são implicitamente tratados como AND, para que você possa selecionar facilmente as páginas que estão em duas ou mais categorias:

Páginas presentes em
<dpl>
category = Objetos
category = Objetos desmontáveis
category = Objetos negociáveis
count = 5
</dpl>

Alternativamente, você pode utilizar um parâmetro e inserir categorias juntas usando um ampersand &.

Páginas presentes em
<dpl>
category = Objetos&Objetos desmontáveis&Objetos negociáveis
count = 5
</dpl>
Combinação - OR

Categorias só podem ser configuradas com OR juntas em um único parâmetro. Isso funciona do mesmo modo que o segundo método AND acima, mas o caractere para se fazer isso é uma barra vertical | - embora isso precise ser escapado com ¦ na sintáxe da função parser (é sugerido que se faça isso na sintaxe da tag também). Não existe uma função XOR (simples).

Páginas em qualquer uma das
<dpl>
category = Objetos desmontáveis¦Equipamento
count = 5
</dpl>