Extension:DynamicPageList (Wikimedia)/pt-br

From MediaWiki.org
Jump to: navigation, search


Manual de Extensões do MediaWiki
Crystal Clear action run.png
DynamicPageList

Status: estável

Implementação Tag, Parser function
Descrição Mostra de uma lista com marcadores de itens mais recentes residentes em uma categoria ou uma união de várias categorias.
Autor(es) n:en:User:IlyaHaykinson and n:en:User:Amgine
Licença GPL
Download
Exemplo http://en.wikinews.org
Tags
<DynamicPageList>
Hooks usados
ParserFirstCallInit

Traduza a extensão DynamicPageList (Wikimedia), se estiver disponível no translatewiki.net

Verifique a matriz de uso e versão; métrica de código
Bugs: listar abertos listar todos relatório

DynamicPageList é uma extensão do MediaWiki desenvolvido para o Wikinews. Ele está instalado em todas as línguas do Wikinews (veja n:Wikinews:DynamicPageList) do Meta e da Wikiversidade e pode ser instalado em qualquer wiki. Permite que os usuários da wiki criem uma lista de páginas que estão listadas em um conjunto de categorias. Veja m:Help:DPL para obter informações gerais.

Esta extensão foi anteriormente conhecida como DynamicPageList/old e mais tarde Intersection. Você também pode estar interessado em DynamicPageList (third-party), que tem mais recursos.

DynamicPageList geralmente trabalha com versões mais velhas (MediaWiki 1.5 e superiores) se você selecionar a versão para 1.13.x em Special:ExtensionDistributor/intersection.

Instalação[edit | edit source]

Baixe o snapshot e coloque na pasta extensions/intersection da sua wiki. Em seguidea, coloque include("$IP/extensions/intersection/DynamicPageList.php"); no seu arquivo LocalSettings.php.

Uso[edit | edit source]

DynamicPageList pode ser usado com a sintaxe XML, como no modo de edição wiki. Os parâmetros de controle para as páginas da lista, em ordem e modo de exibição. Consulte as seguintes seções para obter informações sobre cada parâmetro. Por exemplo, os seguintes são os mais velhos de cinco páginas sobre este wiki que mudaram recentemente para MediaWiki.org.

<DynamicPageList>
category             = Páginas transferidas recentementes de Meta
count                = 5
order                = ascending
addfirstcategorydate = true
</DynamicPageList>

Um exemplo de um código DynamicPageList realmente complexo:

<DynamicPageList>
category=exemplo
count=20
namespace=ficheiro
addfirstcategorydate=ymd
imagewidth=70
galleryshowfilesize=yes
galleryshowfilename=yes
imagesperrow=7
gallerycaption=Galleries!
ordermethod=sortkey
order=ascending
mode=gallery
offset=12
</DynamicPageList>

Lista de 12 a 34 páginas em espaço de ficheiros que também estão na categoria exemplo, formatá-los em uma galeria de imagens, com a data em que foram adicionados acategoria exemplo na legenda no ano formato de dia, mês e com as imagens que tenham uma largura de 70px.

Seleção de páginas[edit | edit source]

category[edit | edit source]

category lista as categorias para cruzar. DynamicPageList lista as páginas que são encontrados em cada uma das categorias listadas. Um número mínimo e máximo de entradas de lista é definido no código fonte da extensão. Você pode usar palavras mágicas <mowiki>December</nowiki> no nome da categoria.

A sintaxe é category = nome da categoria.

<DynamicPageList>
category = Demo
category = Demo 1
</DynamicPageList>

notcategory[edit | edit source]

notcategory restringe as listas de páginas que não estão em uma categoria particular. Você pode usar palavras mágicas como {{CURRENTMONTHNAME}} no nome da categoeria.

<DynamicPageList>
category    = Demo
notcategory = Demo 1
</DynamicPageList>

namespace[edit | edit source]

namespace restringe a lista de páginas especificadas acima, para aqueles que estão em um espaço nominal particular, especificado por nome ou número (veja a lista de namespaces padrões). Qualquer nome inválido é equivalente ao namespace artigo principal.


<DynamicPageList>
category  = Demo
namespace = Help
</DynamicPageList>

redirects[edit | edit source]

redirects determina se deve ou não incluir páginas de redirecionamento. O valor pode ser exclude (padrão, não lista redirecionamentos), include (lista os redirecionamentos), ou only (não lista as páginas que não são redirecionamentos).

<DynamicPageList>
category  = Demo
redirects = only
</DynamicPageList>

stablepages[edit | edit source]

stablepages determina se deve ou não incluir-se páginas estáveis (sinalizadas) ao usar a estensão FlaggedRevs. O valor pode ser exclude (não fazer a lista), include (lista estável e não-estável. Padrão), ou only (lista apenas as páginas estáveis). Requer a instalação da extensão Flaggedrevs para funcionar.

qualitypages[edit | edit source]

qualitypages determina se deve ou não incluir a qualidade (sinalizado no nível 'prestine') quando usando páginas da estensão FlaggedRevs. O valor pode ser exclude (não fazer a lista), include (lista de qualidade e não qualidade), ou only (somente a lista de páginas de qualidade).

Nota: o comportamento do qualitypages é alterado em versões anteriores. Em versões mais antigas, qualitypages=exclude automaticamente stablepages=only é definido. isso não acontece mais.

count[edit | edit source]

count restringe o número de resultados que são mostrados. Por padrão, as páginas adicionadas à categoria, mais recentemente, são mostradas (veja a ordem). Note que a extensão não está na lista de resultados mais do que o máximo definido no código-fonte de extensão.

<DynamicPageList>
category = Exemplo
count    = 2
</DynamicPageList>

offset[edit | edit source]

offset inicia a lista de algum outro lugar, então a primeira página da lista. Por exemplo, este pode ser utilizado com count para fazer layouts de várias colunas.

<DynamicPageList>
category = Exemplo
offset    = 2
</DynamicPageList>

Coluna exemplo

<table>
<tr><th colspan="3"> artigos recentes na [[:categoria:Exemplo]]</th></tr>
<tr><td>

<DynamicPageList>
category = Exemplo
count=5
</DynamicPageList>
</td>
<td>
<DynamicPageList>
category = Exemplo
offset    = 5
count= 5
</DynamicPageList>
</td>
<td>

<DynamicPageList>
category = Exemplo
offset    = 10
count=5
</DynamicPageList>
</td></tr></table>

Detalhes exibido[edit | edit source]

shownamespace[edit | edit source]

shownamespace exibe o espaço nominal no nome da página. O valor pode ser true (visualização padrão, mostra o nome: Ajuda:Conteúdos) ou false (não exibir o nome: Conteúdos).

<DynamicPageList>
category      = Exemplo
shownamespace = false
</DynamicPageList>

addfirstcategorydate[edit | edit source]

addfirstcategorydate mostra a data em que cada artigo foi adicionado à categoria. O valor pode ser true (mostra a data), false (padrão, não apresenta a data), ou um especificador de data (ymd, md, dm, dmy, mdy, e ISO 8601). Se muitas categorias são especificadas, ele usa a primeira categoria. Os nomes ligados a página são precedidos com a data formatada de acordo com suas preferências de exibição local de data do MediaWiki.

<DynamicPageList>
category             = Exemplo
addfirstcategorydate = true
</DynamicPageList>

mode[edit | edit source]

mode determina o formato da lista. O valor pode ser unordered (lista com marcadores) ordered (lista numerada), none (texto simples com quebras de linha), gallery (galeria de imagens, como &ltgallery>) inline (lista separados por vírgulas).

unordered:
<DynamicPageList>
category = Exemplo
mode     = unordered
</DynamicPageList>

ordered:
<DynamicPageList>
category = Exemplo
mode     = ordered
</DynamicPageList>

Texto simples:
<DynamicPageList>
category = Exemplo
mode     = none
</DynamicPageList>

inline (nota: isto não está já ativo em wikis wmf):
<DynamicPageList>
category = Exemplo
mode     = inline
</DynamicPageList>

mode=gallery[edit | edit source]

gallery é um mode especial, onde a saída é uma galeria de imagens. Ao usar este modo, você geralmente deseja restringir o espaço para o arquivo.

<DynamicPageList>
category = Exemplo
mode     = gallery
namespace= Ficheiro
</DynamicPageList>

mode gallery suporta também as opções imagewidth (a largura das imagens da galeria, você pode precisar também definir imageheight se usar isto), imageheight (como deve ser a altura das imagem) galleryshowfilesize (mostra o tamanho das imagens, como nas categorias de páginas), galleryshowfilename (mostra o nome do arquivo como nas categorias de páginas), imagesperrow (número de imagens por linha na galeria), gallerycaption (legenda na galeria).

Se addfirstcategorydate está em uso, a data é acrescentada a legenda da imagem.

Nota: gallerycaption no momento não pode aceitar ligações (mas pode aceitar as coisas como {{CURRENTMONTHNAME}}).

Um exemplo complexo de gallery pode ser:

<DynamicPageList>
count=20
namespace=Ficheiro
addfirstcategorydate=ymd
imagewidth=70
galleryshowfilesize=yes
galleryshowfilename=yes
imagesperrow=7
gallerycaption=Olhe para a minha galeria.
mode=gallery
</DynamicPageList>

nofollow[edit | edit source]

nofollow acresenta rel="nofollow" sobre as ligações. Isso impede que aranhas de chegarem até a página através do link do DynamicPageList. Em geral, isso é inútil, aranhas serão capazes de indexar a página de outras ligações, ou fazer nada para robots.txt/$wgDefaultRobotPolicy. Em geral, você não deve usar esta opção a menos que você saiba o que está fazendo, e ter uma boa razão.

<DynamicPageList>
category       = Exemplo
nofollow       = true
</DynamicPageList>

googlehack[edit | edit source]

Este é um hack para o Wikinotícias. Notícias do Google consideram apenas artigos com números que sejam notícias, isto acontece colocando ?dpl_id=<id of article> ao final das URLs na lista. Você não deve usar esta opção a menos que você tenha uma boa razão (no entanto, não vai doer nada). Isto substitui a opção showcurid que já não é suportado.

<DynamicPageList>
category       = Exemplo
googlehack       = true
</DynamicPageList>

Order[edit | edit source]

ordermethod[edit | edit source]

ordermethod determina a ordem e a data que vai mostrar. O valor pode ser categoryadd (padrão, classificar por data as páginas que foram classificadas para a categoria em primeiro lugar) ou lastedit (classifica as páginas pela data da última edição feita), length (pelo comprimento do artigo), created (data da criação do artigo), categorysortkey (essencialmente alfabética. Ordenar pela chave de classificação da primeira categoria. Sortkey é um apelido), popularity (pelo número de acessos).

Nota-se que realmente lastedit classifica pela última vez que a página foi editada. Em alguns casos, isso não é equivalente à última edição (por exemplo, o que inclui alterações de permissão, criação ou supressão de páginas com links, e alteração constante de predefinições). popularit só é permitido em wikis que têm $wgDisableCounters definido como false. Como tal, não funciona em wikis da Wikimedia. Se você não especificar uma categoria, alguns desses métodos não funcionarão especificadamente, categoryadd e categorysortkey retorna para created se não houver a cláusula category.

<DynamicPageList>
category             = Exemplo
addfirstcategorydate = true
ordermethod          = lastedit
</DynamicPageList>

Exemplo por ordem alfabética:

<DynamicPageList>
category             = Demo
ordermethod          = sortkey
</DynamicPageList>

order[edit | edit source]

order decide a direção da classificação. O valor pode ser descending (padrão, do mais recente para o mais antigo) ou ascending (do mais antigo ao mais recente).

<DynamicPageList>
category  = Demo
order     = ascending
</DynamicPageList>

Extensões derivadas[edit | edit source]

Versão 1.8.4 do DynamicPageList (third-party) é totalmente compatível com a extensão aqui descrita. Assim, o caminho está aberto para uma re-unificação dos caminhos de desenvolvimento diferentes. Não está claro se a reivindicação acima sobre DynamicPageList (third-party) ainda é verdade.


Língua: English  • Deutsch • 日本語 • português do Brasil