Ayuda:Incluyendo JavaScript y CSS adicional

Esta página de ayuda te explicará las formas recomendadas para incluir CSS y JavaScript adicional en tu comunidad.

ImportJS

MediaWiki:ImportJS proporciona una interfaz para la inclusión de artículos que contienen scripts - tanto local como desde Dev Wiki - en una comunidad.

Para importar archivos JavaScript de otras wikis o páginas web, el wiki debe tener el JS comunitario activado; los administradores pueden solicitar esto contactando al staff de Fandom en Special:Contactar.

Uso

MediaWiki:ImportJS proporciona un artículo de texto plano en el que especificar los nombres de los artículos de JavaScript. Los archivos locales deberán estar en el espacio de nombres de MediaWiki. Las importaciones de Dev Wiki también necesitarán estar en el espacio de nombres de MediaWiki para funcionar. Al indicar los archivos a importar, no es necesario incluir el espacio de nombres de MediaWiki. Ejemplo: 

// Archivo JS local
Cat.js

// Script de Dev Wiki
dev:UploadMultipleFiles.js


Light bulb icon

Proceso de revisión de JavaScript: La característica ImportJS evita la necesidad del proceso de revisión de JavaScript, permitiendo la adición o eliminación inmediata de los importes de JavaScript de una comunidad.

La funcionalidad es similar al método existente importArticles, que puede importar artículos de comunidades externas, agrupar varios artículos en una sola, "minificarlos" y funcionar como una única solicitud. Esto reduce tanto el tamaño del archivo como el tráfico de Internet con eficacia, haciendo que una comunidad con un gran número de archivos adicionales cargue mucho más rápido. ImportJS afecta a todas las pieles tal como Common.js.

Orden de carga

Al usar ImportJS, las páginas que contenga se cargarán las últimas. El orden de carga completa es:

  1. Common.js
  2. Fandomdesktop.js
  3. Scripts importados desde Common.js
  4. Scripts importados desde Fandomdesktop.js
  5. ImportJS

Importaciones CSS

ImportArticles

En lugar del método anterior, importArticles solamente se tratará aquí en lo que respecta a las importaciones CSS. Para las importaciones JS, consulta esta página.

Todavía se puede utilizar importArticles para importar estilos CSS. No obstante, estarán sujetos a la revisión que se hace para JS, ya que se tiene que hacer a través de JavaScript.

Ejemplo

Importación de un archivo CSS local a través importArticles: 

importArticles({
    type: "style",
    article: "MediaWiki:Local.css"
});

Método @import

Usando la etiqueta @import se pueden importar estilos desde cualquier archivo CSS almacenado en un wiki o en otros sitios web. La sintaxis es la siguiente: 

@import "ruta_al_archivo_a_importar.css"

Para el ejemplo anterior, para importar Local.css en Wikia.css, coloca esto en la parte superior de su archivo Wikia.css (dado el orden de carga y las diferencias con la carga del Common.css, puede ser necesario agregar las importaciones a tu archivo Common.css para funcionar correctamente): 

@import "/load.php?articles=MediaWiki:Local.css&only=styles&mode=articles";

Una forma alternativa, que hará más fácil detectar los archivos cargados en la pestaña "Red" del "Desarrollador Web" de Firefox es utilizar: 

@import url("/MediaWiki:Local.css?ctype=text/css&action=raw");

Puedes leer más sobre este método aquí.

Más información

Ayuda y comentarios