Manual:$wgLogos

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgLogos and the translation is 83% complete.
URLs de servidor e caminhos de arquivo: $wgLogos
O caminho da URL para vários logotipos da wiki.
Introduzido na versão:1.35.0 (Gerrit change 562588; git #8cd2e133)
Removido na versão:ainda em uso
Valores permitidos:(matriz de fatores e caminhos ou urls relativos)
Valor padrão:false (Nota: O valor padrão dessa variável depende de outras variáveis, tais como os valores definidos em Setup.php , after LocalSettings.php é executado)

Detalhes

Uma matriz com fatores e seus caminhos relativos associados ou caminhos de URL para as diferentes versões do logotipo da wiki. (ou seja, a imagem exibida no canto superior esquerdo da página na maioria das instalações do MediaWiki).

Variantes suportadas

  • A versão do ícone deve ser quadrada e nominalmente 50x50 píxeis se SVG, ou 100x100 píxeis se raster, a fim de oferecer suporte a HiDPI. SVG, entretanto, é recomendado. O suporte atual para esta chave é limitado a Skin:Vector , Skin:Timeless e Skin:Refreshed , mas isso é recomendado para todos as novas skins. Observe que outras capas normalmente requerem um ícone maior se suportarem isso, portanto, usar um SVG em vez disso é recomendado, pois será dimensionado corretamente em todos eles.
  • A versão 1x deve ter 135px de largura por até ~155px de altura. Isso ocorre porque as versões 1,5x e 2x assumem uma largura nominal de 135px e até 155px de altura cabem sem problemas em skins padrão. Isso suporta skins mais antigas e no futuro a longo prazo será preterido. Recomendamos que as skins suportem o `icon` preferido.
  • A versão 1.5x deve ter 202px de largura, combinando com a proporção do 1x. (até 232px de altura, para 155px de altura nominal). A chave será descontinuada no futuro e seu uso não é recomendado.
  • A versão 2x deve ter 270px de largura, correspondendo à proporção do 1x. (até 310px de altura, para 155px de altura nominal). A chave será descontinuada no futuro e seu uso não é recomendado.
  • A versão svg substitui a necessidade de uma versão 1x, 1.5x e 2x, mas deve seguir as mesmas diretrizes de tamanho nominal, cabendo em 135px de largura e 155px de altura quando redimensionada para 135px de largura. A chave será descontinuada no futuro e seu uso não é recomendado.

Existem também dois campos opcionais para recursos adicionais a serem exibidos ao lado do logotipo:

  • A marca nominativa deve ser um logotipo em paisagem, com largura ou altura máxima definida, pois são especificados nas teclas width e height. Normalmente, esta é a versão gráfica de $wgSitename. Isso é usado Skin:Vector (1,36), Skin:Timeless , Skin:Minerva
  • O mesmo é verdadeiro para o tagline, que normalmente corresponde à parte que não é do nome do site de MediaWiki:Tagline.

Todos os valores (exceto width e height) podem ser um URL totalmente qualificado ou um caminho relativo de DOCUMENT_ROOT. Se for um caminho relativo, ele deve começar com uma barra (um arquivo em DOCUMENT_ROOT é /file.png, não file.png). Em vez disso, a imagem será cortada de forma que apenas parte dela (o canto superior esquerdo para ser mais preciso) fique visível. Se este canto for completamente branco, pode parecer que a imagem não será exibida, embora de fato seja.


Exemplo

$wgLogos = [
	'1x' => "path/to/1x_version.png",		// path to 1x version
	'1.5x' => "path/to/1.5x_version.png",	// path to 1.5x version
	'2x' => "path/to/2x_version.png",		// path to 2x version
	'svg' => "path/to/svg_version.svg",		// path to svg version
	'icon' => "path/to/icon.png",			// A version of the logo without wordmark and tagline
	'wordmark' => [
		'src' => "path/to/wordmark_version.png",	// path to wordmark version
		'1x' => "path/to/wordmark_version.svg",		// optional if you want to support browsers with SVG support with an SVG logo.
		'width' => 135,
		'height' => 20,
	],
	'tagline' => [
		'src' => "path/to/tagline_version.png",		// path to tagline version
		'width' => 135,
		'height' => 15,
	],
];
Atenção! Atenção: Não simplesmente substitua o logotipo padrão instalado com o MediaWiki (/resources/assets/wiki.png). Este arquivo será substituído automaticamente quando você atualizar e suas alterações serão perdidas.

Ver também