# Highlight.js Highlight.js â ÑÑо подÑвеÑÑик ÑинÑакÑиÑа, напиÑаннÑй на JavaScript. Ðн ÑабоÑÐ°ÐµÑ Ð¸ в бÑаÑзеÑе, и на ÑеÑвеÑе. Ðн ÑабоÑÐ°ÐµÑ Ñ Ð¿ÑакÑиÑеÑки лÑбой HTML ÑазмеÑкой, не завиÑÐ¸Ñ Ð¾Ñ ÐºÐ°ÐºÐ¸Ñ -либо ÑÑеймвоÑков и ÑÐ¼ÐµÐµÑ Ð°Ð²ÑомаÑиÑеÑки опÑеделÑÑÑ ÑзÑк. ## ÐаÑало ÑабоÑÑ ÐинимÑм, ÑÑо нÑжно ÑделаÑÑ Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ highlight.js на веб-ÑÑÑаниÑе â ÑÑо подклÑÑиÑÑ Ð±Ð¸Ð±Ð»Ð¸Ð¾ÑекÑ, CSS-ÑÑили и вÑзÑваÑÑ [`initHighlightingOnLoad`][1]: ```html <link rel="stylesheet" href="/path/to/styles/default.css"> <script src="/path/to/highlight.pack.js"></script> <script>hljs.initHighlightingOnLoad();</script> ``` ÐиблиоÑека найдÑÑ Ð¸ ÑаÑкÑаÑÐ¸Ñ ÐºÐ¾Ð´ внÑÑÑи Ñегов `<pre><code>`, попÑÑавÑиÑÑ Ð°Ð²ÑомаÑиÑеÑки опÑеделиÑÑ ÑзÑк. Ðогда авÑоопÑеделение не ÑÑабаÑÑваеÑ, можно Ñвно ÑказаÑÑ ÑзÑк в аÑÑибÑÑе class: ```html <pre><code class="html">...</code></pre> ``` СпиÑок поддеÑживаемÑÑ ÐºÐ»Ð°ÑÑов ÑзÑков доÑÑÑпен в [ÑпÑавоÑнике по клаÑÑам][8]. ÐлаÑÑ Ñакже можно пÑедваоиÑÑ Ð¿ÑеÑикÑами `language-` или `lang-`. ЧÑÐ¾Ð±Ñ Ð¾ÑклÑÑиÑÑ Ð¿Ð¾Ð´ÑвеÑÐºÑ Ð´Ð»Ñ ÐºÐ°ÐºÐ¾Ð³Ð¾-Ñо блока, иÑполÑзÑйÑе клаÑÑ `nohighlight`: ```html <pre><code class="nohighlight">...</code></pre> ``` ## ÐниÑиализаÑÐ¸Ñ Ð²ÑÑÑнÑÑ Ð§ÑÐ¾Ð±Ñ Ð¸Ð¼ÐµÑÑ ÑÑÑÑ Ð±Ð¾Ð»ÑÑе конÑÑÐ¾Ð»Ñ Ð·Ð° иниÑиализаÑией подÑвеÑки, Ð²Ñ Ð¼Ð¾Ð¶ÐµÑе иÑполÑзоваÑÑ ÑÑнкÑии [`highlightBlock`][2] и [`configure`][3]. Таким обÑазом можно ÑпÑавлÑÑÑ Ñем, *ÑÑо* подÑвеÑиваÑÑ Ð¸ *когда*. ÐÐ¾Ñ Ð¿ÑÐ¸Ð¼ÐµÑ Ð¸Ð½Ð¸ÑиализаÑиÑ, ÑквиваленÑной вÑÐ·Ð¾Ð²Ñ [`initHighlightingOnLoad`][1], но Ñ Ð¸ÑполÑзованием jQuery: ```javascript $(document).ready(function() { $('pre code').each(function(i, block) { hljs.highlightBlock(block); }); }); ``` ÐÑ Ð¼Ð¾Ð¶ÐµÑе иÑполÑзоваÑÑ Ð»ÑбÑе Ñеги ÑазмеÑки вмеÑÑо `<pre><code>`. ÐÑли иÑполÑзÑеÑе конÑейнеÑ, не ÑÐ¾Ñ ÑанÑÑÑий пеÑÐµÐ²Ð¾Ð´Ñ ÑÑÑок, вам нÑжно ÑказаÑÑ highlight.js иÑполÑзоваÑÑ Ð´Ð»Ñ Ð½Ð¸Ñ Ñег `<br>`: ```javascript hljs.configure({useBR: true}); $('div.code').each(function(i, block) { hljs.highlightBlock(block); }); ``` ÐÑÑгие опÑии можно найÑи в докÑменÑаÑии ÑÑнкÑии [`configure`][3]. ## УÑÑановка библиоÑеки Highlight.js можно иÑполÑзоваÑÑ Ð² бÑаÑзеÑе пÑÑмо Ñ CDN Ñ Ð¾ÑÑинга или ÑкаÑаÑÑ Ð¸Ð½Ð´Ð¸Ð²Ð¸Ð´ÑалÑнÑÑ ÑбоÑкÑ, а Ñакже ÑÑÑановив модÑÐ»Ñ Ð½Ð° ÑеÑвеÑе. Ðа [ÑÑÑаниÑа загÑÑзки][4] подÑобно опиÑÐ°Ð½Ñ Ð²Ñе ваÑианÑÑ. ÐбÑаÑиÑе внимание, ÑÑо библиоÑека не пÑедназнаÑена Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð² виде иÑÑ Ð¾Ð´Ð½Ð¾Ð³Ð¾ кода на GitHub, а ÑÑебÑÐµÑ Ð¾ÑделÑной ÑбоÑки. ÐÑли вам не Ð¿Ð¾Ð´Ñ Ð¾Ð´Ð¸Ñ Ð½Ð¸ один из гоÑовÑÑ Ð²Ð°ÑианÑов, ÑиÑайÑе [докÑменÑаÑÐ¸Ñ Ð¿Ð¾ ÑбоÑке][5]. ## ÐиÑÐµÐ½Ð·Ð¸Ñ Highlight.js ÑаÑпÑоÑÑÑанÑеÑÑÑ Ð¿Ð¾Ð´ лиÑензией BSD. ÐодÑобнее ÑиÑайÑе Ñайл [LICENSE][10]. ## СÑÑлки ÐÑиÑиалÑнÑй ÑÐ°Ð¹Ñ Ð±Ð¸Ð»Ð¸Ð¾Ñеки ÑаÑположен по адÑеÑÑ <https://highlightjs.org/>. Ðолее подÑÐ¾Ð±Ð½Ð°Ñ Ð´Ð¾ÐºÑменÑаÑÐ¸Ñ Ð¿Ð¾ API и дÑÑгим Ñемам ÑаÑположена на <http://highlightjs.readthedocs.org/>. ÐвÑоÑÑ Ð¸ конÑÑибÑÑÑоÑа пеÑеÑиÑлена в Ñайле [AUTHORS.ru.txt][9] file. [1]: http://highlightjs.readthedocs.org/en/latest/api.html#inithighlightingonload [2]: http://highlightjs.readthedocs.org/en/latest/api.html#highlightblock-block [3]: http://highlightjs.readthedocs.org/en/latest/api.html#configure-options [4]: https://highlightjs.org/download/ [5]: http://highlightjs.readthedocs.org/en/latest/building-testing.html [8]: http://highlightjs.readthedocs.org/en/latest/css-classes-reference.html [9]: https://github.com/isagalaev/highlight.js/blob/master/AUTHORS.ru.txt [10]: https://github.com/isagalaev/highlight.js/blob/master/LICENSE