Extensión:CSS

Manual de extensiones de MediaWiki

CSS Estado de la versión: estable
Implementación	Función del analizador
Descripción	Proporciona una función de analizador para agregar archivos CSS, artículos o reglas en línea a los artículos.
Autor(es)	Aran Dunkley Rusty Burchfield
Última versión	3.5.0
MediaWiki	>= 1.40.0
Licencia	Licencia Pública General de GNU 2.0 o posterior
Descargar	Descargar la extensión. Git [?]: Explorar el repositorio (GitHub) revisión de código historial de cambios Download source tarball
Ejemplo	organicdesign.nz
Parámetros $wgCSSPath $wgCSSIdentifier
Ganchos utilizados ParserFirstCallInit RawPageViewBeforeOutput
Traduce la extensión CSS si está disponible en translatewiki.net
Incidentes	Tareas abiertas · Reportar un error

La extensión CSS permite incluir hojas de estilo CSS en artículos específicos. El CSS puede estar en otro artículo, un archivo o pueden ser reglas definidas directamente en la función del analizador.

Uso

Por ejemplo, si tienes un artículo CSS llamado "MyStyles.css", que son los estilos que se pretenden usar con el artículo "MyFancyUserPage", deberás añadir la siguiente función del analizador al último,

{{#css:MyStyles.css}}

Si, por otro lado, "MyStyles.css" fuera un archivo en el directorio /wiki/skins, entonces se incluiría como se muestra a continuación. Ten en cuenta que el archivo debe ser una ruta absoluta con una barra diagonal inicial para distinguirlo del título de un artículo.

{{#css:/skins/MyStyles.css}}

Alternativamente, las reglas CSS pueden ser directamente incluidas dentro de la función del analizador (en línea) como en el siguiente ejemplo,

{{#css:
  body {
    background: yellow;
    color: red;
    font-size: 1.25rem;
  }
}}

Instalación

• Descarga y mueve la carpeta CSS extraída a tu directorio extensions/.
  Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CSS
  

• Cuando se efectúa la instalación desde Git, hay que ejecutar Composer para que se instalen las dependencias de PHP; para este efecto, ejecute composer install --no-dev en el directorio de la extensión. (ver T173141 para complicaciones potenciales)
• Añade el siguiente código en la parte final de tu archivo LocalSettings.php :

  wfLoadExtension( 'CSS' );
  

• Configurar como sea necesario.
• Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Configuración

Opcionalmente, puedes estableer la URL base para archivos externos.

$wgCSSPath = false;  # Por defecto, relativo a $wgScriptPath
$wgCSSPath = '';  # Relativo a la raíz de tu servidor
$wgCSSPath = 'https://example.org/stylesheets';  # Relativo a un sitio diferente

Tips

Problemas al cambiar el color o fondo de una página específica

Using the parser function to use the CSS from another page does not work to change the color or background of the page, however, using the parser function on a single page by itself does allow the background to be changed. Para superar este problema, es posible cargar el CSS vía transclusión, que no causa el problema de fallar al cargar el cambio al fono de la página.

Véase también

• Extension:NewPageCSS
• Extensión:TemplateStyles - una extensión similar que sanitiza el CSS y lo almancena en páginas diferentes.