Code Syntax Block

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?

The default color theme is A11y Dark optimized for accessibility. If you want to change the colorscheme, you can select from the plugin settings page a few different themes shipped with the plugin. You can also use a theme from the Prism themes repo or create your own.

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 usará si existe. Añade tu archivo personalizado en esa ubicación y será usado.

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?

Yes, on the plugin settings page in the dashboard you can set a default language when inserting a code block. You can still change if you wish to show code not using the default language.

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' );