Extensión:CSS

MediaWiki extensions manual

CSS Release status: stable
Implementation	Parser function
Description	Proporciona una función de analizador para agregar archivos CSS, artículos o reglas en línea a los artículos.
Author(s)	Aran Dunkley Rusty Burchfield
Latest version	3.5.0
MediaWiki	>= 1.40.0
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (GitHub) Gerrit code review Git commit log Download source tarball
Example	organicdesign.nz
Parameters $wgCSSPath $wgCSSIdentifier
Hooks used ParserFirstCallInit RawPageViewBeforeOutput
Translate the CSS extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

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 usted tiene un artículo CSS llamado "MyStyles.css", que son los estilos que se pretenden usar con el artículo "MyFancyUserPage", deberá 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. Tenga 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

• Descargue y extraiga los archivos en el directorio «CSS» dentro del directorio extensions/ existente.
  Developers and code contributors should install the extension from Git instead, using:

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

• Cuando instale desde git, ejecute Composer para instalar dependencias PHP, emitiendo composer install --no-dev en el directorio de extensión. (vea T173141 para complicaciones potenciales)
• Añada el siguiente código a su $LocalSettings (preferiblemente al final):

  wfLoadExtension( 'CSS' );
  

• Configurar como sea necesario.
• Hecho – Navegue a Special:Version en su wiki para verificar que la apariencia se haya instalado correctamente.

Configuración

Opcionalmente, puede establecer la URL base para archivos externos.

$wgCSSPath = false;  # Por defecto, relativo a $wgScriptPath
$wgCSSPath = '';  # Relativo a la raíz de su 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

Usar la función del analizador para usar el CSS desde otra página no funciona para cambiar el color o fondo de la página, si embargo, usar la función del analizador en una sola página por sí mismo permite cambiar el fondo. 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.

Vea también

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