Manual:$wgLogos
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) |
Outras definições: Alfabético | Por função |
Detalhes
Atenção: | Do not simply overwrite the default logo installed within MediaWiki (/resources/assets/wiki.png ); this file will be overwritten when you upgrade the software. |
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.
- it should be a square and should be nominally 50 × 50 pixels if SVG, or 100 × 100 pixels if raster in order to support HiDPI. SVG, entretanto, é recomendado. O suporte atual para esta chave é limitado a Skin:Vector , Skin:Timeless , Skin:Refreshed , Skin:Citizen , $2 e $3, 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.
- it should be 135px wide by up to ~155px tall. 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.
- it should 202px wide, matching the aspect ratio of the 1×. (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.
- it should be 270px wide, matching the aspect ratio of the 1×. (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.
- it replaces the need for a 1x, 1.5x, and 2x version, but should follow the same nominal size guidelines, fitting within 135px wide and 155px tall when resized to 135px wide. 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:
- wordmark
- it should be a landscape logo, with maximum set width or height, as these are specified under the
width
andheight
keys. The width shouldn't exceed 124 and the height shouldn't exceed 32px. Normalmente, esta é a versão gráfica de $wgSitename. Isso é usado Skin:Vector (1,36), Skin:Timeless , Skin:Minerva
- tagline
- * O mesmo é verdadeiro para o tagline, que normalmente corresponde à parte que não é do nome do site de MediaWiki:Tagline. The combined height of the tagline and wordmark should not exceed 50px.
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.
Example images
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,
],
];
Simple example
$wgLogos = [
'icon' => "$wgScriptPath/lol.png", // path to icon, the primary logo for Vector
'1x' => "$wgScriptPath/myCustomLogo.png", // path to 1x version
'2x' => "$wgResourceBasePath/hiResLogo.png", // path to 2x version
];
Example paths
$wgLogos = [
'1x' => "/lol.png", // relative path to file in logo folder, 1x version
'1.5x' => "https://mywiki.org/w/resources/assets/lol.png", // fully qualified URL path to 1.5x version
'2x' => "/lol.png", // relative path to 2x version, which always starts with a slash
// 'svg' => "", // no svg (deprecated by MW)
'icon' => "lol.png", // Limited support, either 50x50 svg or 100x100 png
'wordmark' => [
'src' => "/wordmark_sitename.png", // 135px wide image of sitename text, limited support
'width' => 135,
'height' => 20,
],
'tagline' => [
'src' => "/tagline_subtitle.png", // 135px image to tagline text without sitename
'width' => 135,
'height' => 15,
],
];
Adding logos for language variants
The functionality to override logos for different language variants was introduced in version 1.36.0 (Gerrit change 627939, git #8cd2e133). See T261153.
When defining variants, any language key can be used, for example it is possible to provide a German variant of an English logo.
This was extended to apply to all logo keys in 1.39.0.
$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,
],
'variants' => [
'variant-code' => [
'1x' => "path/to/language_variant_1x_version.png", // path to 1x version in language variant
'1.5x' => "path/to/language_variant_1.5x_version.png", // path to 1.5x version in language variant
'2x' => "path/to/language_variant_2x_version.png", // path to 2x version in language variant
'svg' => "path/to/language_variant_svg_version.svg", // path to svg version in language variant
'icon' => "path/to/language_variant_icon.png", // A version of the logo without wordmark and tagline in language variant
'wordmark' => [
'src' => "path/to/language_variant_wordmark_version.png", // path to wordmark version in language variant
'1x' => "path/to/language_variant_wordmark_version.svg", // optional if you want to support browsers with SVG support with an SVG logo in language variant.
'width' => 135,
'height' => 20,
],
],
],
];
Dependendo das configurações do servidor, as informações sobre qual imagem usar podem ser armazenadas em cache dentro de um cache do servidor. Além disso, as imagens podem ser armazenadas em cache dentro do navegador da web por um longo tempo para que você não veja imediatamente o novo logotipo, se você alterou o arquivo de imagem correspondente. Nesse caso, pode ser necessário esvaziar especialmente os caches e recarregar a URL da imagem no navegador da Web para que o navegador baixe a versão atual do servidor. |
Ver também
- Como eu mudo o logotipo?
- $wgLogo (MediaWiki < 1.35.0)
- $wgLogoHD (MediaWiki < 1.35.0)
- $wgFavicon
- $wgAppleTouchIcon