nezhelskoy/yii2-highlight

Yii2 highlight.js extension

Yii2 highlight.js extension

Installation

The preferred way to install this extension is through composer., _(*1)

Either run, _(*2)

php composer.phar require --prefer-dist nezhelskoy/yii2-highlight "*"

Or add, _(*3)

"nezhelskoy/yii2-highlight": "*"

to the require section of your composer.json file., _(*4)

Usage

In your view script register asset:, _(*5)

nezhelskoy\highlight\HighlightAsset::register($this);

And manage content, as described in original highlight.js documentation:, _(*6)

<pre><code class="html">...</code></pre>

You can override style in your config file, e.g. config/web.php:, _(*7)

    'components' => [
        ...
        'assetManager' => [
            'bundles' => [
                'nezhelskoy\highlight\HighlightAsset' => [
                    'css' => ['dist/styles/zenburn.css'],
                ],
            ]
        ],
        ...
    ],

Example of custom cofiguraton of selector or options properties, _(*8)

    'components' => [
        ...
        'assetManager' => [
            'bundles' => [
                'nezhelskoy\highlight\HighlightAsset' => [
                    'selector' => '.is-highlighted',
                    'options' => [
                        'classPrefix' => 'custom-',
                        'useBR' => true,
                    ],
                    'css' => ['dist/styles/zenburn.css'],
                ],
            ]
        ],
        ...
    ],

Using of custom build, located in /js/highlight, for example, _(*9)

    'components' => [
        ...
        'assetManager' => [
            'bundles' => [
                'nezhelskoy\highlight\HighlightAsset' => [
                    'sourcePath' => null,
                    'css' => ['/js/highlight/styles/zenburn.css'],
                    'js' => ['/js/highlight/highlight.pack.js'],
                ],
            ]
        ],
        ...
    ],

License

yii2-highlight is released under the BSD License. See LICENSE.md file for details., _(*10)

Links

The official site for the Highlight.js library is at https://highlightjs.org/., _(*11)