Manual:Skin configuration/es
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 crear una apariencia 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 permite a los administradores especificar reglas CSS para todo el sitio que se añadirán a cada página renderizada.
Estas reglas se pueden añadir editando la página MediaWiki:Common.css en tu wiki, si $wgUseSiteCss está configurado como true.
Además de una hoja de estilos global, también se pueden especificar reglas CSS para ser usadas solo en ciertas apariencias (consulta Manual:Interfaz/Hojas de estilos).
Modificaciones de CSS del usuario
Los usuarios también pueden especificar sus propias reglas CSS creando la página "User:NombreDeUsuario/common.css".
El CSS de esta página se aplica a cualquier apariencia que el usuario esté utilizando.
Si el sitio web cambia a una apariencia predeterminada diferente, el CSS personalizado del usuario seguirá funcionando exactamente igual que antes.
Esta función se puede habilitar configurando $wgAllowUserCss como true en LocalSettings.php.
Un usuario también puede aplicar CSS a una apariencia específica creando la página "User:NombreDeUsuario/nombreDeApariencia.css".
Por ejemplo, si un usuario utiliza la apariencia MonoBook, editaría la página 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 usar el parámetro useskin en la URL.
$wgHiddenPrefs[] = 'skin';