FAQ

¿Qué lenguajes son compatibles?

El plugin Code Syntax Block usa el plugin de carga automática de Prism para ser compatible con todos los lenguajes compatibles con Prism. Mira en lista de lenguajes compatibles.

¿Cómo personalizar el esquema de color?

El tema de color por defecto es One Dark basado en el tema One Dark de Atom.Si quieres cambiar los colores, puedes descargar un tema nuevo desde el repositorio de temas de Prism o crear el tuyo.

El tema de color es un único archivo CSS, hay un par de formas de personalizarlo:

1. El plugin comprobará en el tema actual el archivo: assets/prism/prism.css y lo utilizará si existe. Añade tu personalización a un archivo en esa localización, y se utilizará.

2. Si no te gusta la localización de este archivo, puedes usar el filtro mkaz_prism_css_path y especificar una ruta relativa al tema que usas.

3. Si prefieres especificar una URL completa, puedes usar el filtro mkaz_prism_css_url y especificar una URL completa a la hoja de estilos que usas.

Un ejemplo añadiendo un filtro para cambiar la URL, añade lo siguiente al archivo «functions.php» de tu tema

add_filter( 'mkaz_prism_css_url', function() {
    return 'https://raw.githubusercontent.com/PrismJS/prism-themes/master/themes/prism-hopscotch.css';
});

Nota: si usas la característica título/nombre de archivo y personalizas el CSS, necesitarás aplicar tu propio estilo coincidiendo con la clase `prism-titlename`.

¿Cómo personalizar la lista de lenguajes?

Usa el filtro mkaz_code_syntax_language_list para personalizar la lista de lenguajes mostrados en el editor. Por defecto, Code Syntax Block muestra una lista más corta de lenguajes populares, pero Prism es compatible con casi 200, mira la lista.

Usa este filtro para ampliar la compatibilidad con los lenguajes que necesitas. Además, puedes usar el filtro para acortar la lista a los lenguajes que sueles utilizar para que sea más fácil seleccionarlos.

Aquí tienes un ejemplo acortando la lista a un conjunto más pequeño:

add_filter( 'mkaz_code_syntax_language_list', function() {
    return array(
        "bash" => "Bash",
        "go" => "Go",
        "html" => "HTML",
        "javascript" => "JavaScript",
        "json" => "JSON",
        "markdown" => "Markdown",
        "php" => "PHP",
        "python" => "Python",
        "jsx" => "React JSX",
        "sass" => "Sass",
        "sql" => "SQL",
        "svg" => "SVG",
        "toml" => "TOML",
        "vim" => "vim",
        "xml" => "XML",
        "yaml" => "YAML",
    );
} );

¿Puedo establecer un lenguaje por defecto de forma que no tenga que seleccionarlo cada vez?

Sí, usa el filtro mkaz_code_syntax_default_lang para establecer un lenguaje por defecto al insertar un bloque de código. Siempre puedes cambiarlo si no deseas mostrar el código usando el lenguaje por defecto.

Este ejemplo establecerá JavaScript como el lenguaje por defecto:

add_filter( 'mkaz_code_syntax_default_lang', function() { return 'javascript'; });

Can I override the conditional loading, so assets always load?

Yes, use the filter mkaz_code_syntax_force_loading to force always loading assets, otherwise it users has_block to check.

Example:

add_filter( 'mkaz_code_syntax_force_loading', '__return_true' );