Manual:Configuración de apariencias
Esta página explica a los administradores cómo configurar las apariencias de un wiki.
Esta documentación aplica a MediaWiki 1.31+.
Para utilizar apariencias, consulta Ayuda:Apariencias para obtener información general sobre las apariencias.
Para los desarrolladores que quieran crear nuevas apariencias o editar apariencias existentes, consulten Manual:Cómo hacer una apariencia (skin) de MediaWiki para obtener información técnica.
Descargar apariencias
La descarga del archivo tarball de MediaWiki incluye varias apariencias preinstaladas. Consulta Extensiones y apariencias incluidas#Apariencias para ver la lista.
Sin embargo, si has descargado MediaWiki desde Git, o si quieres instalar apariencias adicionales, tendrás que descargar por separado el código para esa apariencia o apariencias.
Muchas apariencias de MediaWiki se encuentran en el repositorio Git de Wikimedia (consulta el listado completo del repositorio de apariencias). Puedes descargar los archivos tarballs de las apariencias desde el distribuidor de apariencias.
Para descargar una de las apariencias de este grupo mediante Git, debes hacer una llamada como la siguiente:
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/[nombre de apariencia]
Ej.: para obtener la apariencia predeterminada Vector, deberías ejecutar lo siguiente desde el subdirectorio skins/
de la carpeta de instalación de tu MediaWiki:
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector
Selecciona la versión adecuada de la apariencia. Cámbiate al nuevo directorio y ejecuta:
git checkout REL1_44
(reemplaza REL1_44
con otra rama de lanzamiento o etiqueta)
Activar apariencias
Para cualquier apariencia en tu directorio /skins
que desees usar, debes habilitarla en tu archivo LocalSettings.php
.
Por ejemplo, para activar Vector, añade lo siguiente.
Si tienes varias apariencias, cada una debe habilitarse con una declaración por separado:
wfLoadSkin( 'Vector' );
(Esto es equivalente a habilitar una extensión, sólo que en un directorio diferente.)
Puede que se requieran pasos adicionales según la apariencia elegida. Las instrucciones detalladas de instalación están disponibles en la página de cada apariencia en mediawiki.org; por ejemplo, para Vector consulta Apariencia:Vector#Instalación. Las instrucciones para el resto de apariencias son análogas.
Configurar la apariencia predeterminada para un wiki
Debe establecerse una apariencia por defecto para los nuevos usuarios de un wiki configurando la variable $wgDefaultSkin
en LocalSettings.php
con el nombre de la apariencia en minúsculas especificado en el archivo de la apariencia. Los usuarios todavía pueden cambiar su apariencia dirigiéndose a su página de preferencias, a menos que desinstales o suprimas todas las demás apariencias, o desactives la preferencia por completo (ver más abajo). Por ejemplo:
$wgDefaultSkin = 'vector';
Al cambiar este valor en una wiki existente, se cambiará automáticamente la configuración de todos los usuarios que hayan estado usando la apariencia predeterminada anterior.
Existe un script de mantenimiento para cambiar las preferencias de los usuarios (userOptions.php
), pero lo más probable es que no necesites utilizarlo.
Si no se cambia este valor, Vector será la apariencia predeterminada.
Desinstalar apariencias
Para desinstalar una apariencia, quita la línea wfLoadSkin
de tu archivo LocalSettings.php
.
Posteriormente, puedes eliminar los archivos de la apariencia del directorio skins/
.
Si algunos usuarios estaban usando la apariencia que acabas de desinstalar, MediaWiki los cambiará automáticamente a la apariencia predeterminada de la wiki.
Suprimir apariencias sin desinstalarlas
El administrador puede limitar las apariencias que se ofrecen en todo el sitio en las preferencias del usuario, listando las apariencias a suprimir en el array $wgSkipSkins
. Esto podría ser útil si quieres probar una nueva apariencia sin que los usuarios la vean. Para hacer esto, añade algo como lo siguiente en LocalSettings.php
:
// To remove various skins from the User Preferences choices
$wgSkipSkins = [ "monobook", "timeless" ];
Se puede previsualizar la apariencia usando el parámetro URL useskin
.
Modificaciones de CSS para todo el sitio
MediaWiki allows administrators to specify site-wide CSS rules to be added to every page rendered.
These rules can be added by editing the page MediaWiki:Common.css on your wiki, if $wgUseSiteCss
is set to true.
In addition to a global stylesheet, one can also specify CSS rules to be used only in certain skins (see Manual:Interfaz/Hojas de estilos ).
Modificaciones de CSS del usuario
Users can also specify their own CSS rules by creating the page "User:Username/common.css".
The CSS on this page is then applied to whatever skin the user is using.
If the website is changed to a different default skin, the user's custom CSS will continue to work just as before.
This feature can be enabled by setting $wgAllowUserCss
to true in LocalSettings.php
.
A user can also apply CSS to a specific skin by creating the page "User:Username/skinname.css".
If a user uses the MonoBook skin for example, they would edit the page Special:MyPage/monobook.css.
Desactivar la posibilidad de elegir apariencias en las preferencias del usuario
Versión de MediaWiki: | ≥ 1.16 |
El administrador del sistema puede eliminar por completo la opción "Apariencia" para que no aparezca en las Preferencias del Usuario. Esto tiene sentido si tu sitio web utilizará una apariencia personalizada y no se vería bien con ninguna otra apariencia.
Para hacerlo, añade una nueva línea a LocalSettings.php que contenga el siguiente código. Esto quitará la opción "Apariencia" de las preferencias y la posibilidad de usa el parámetro useskin
en la URL.
$wgHiddenPrefs[] = 'skin';