`, чтобы задать ему
какой-нибудь специальный стиль:
```html
```
Дальше скрипт ищет на странице конструкции `...
`,
которые традиционно используются для написания кода, и код в них
размечается на куски, помеченные разными значениями классов.
### Инициализация вручную
Если вы используете другие теги для блоков кода, вы можете инициализировать их
явно с помощью функции `highlightBlock(code, tabReplace)`. Она принимает
DOM-элемент с текстом расцвечиваемого кода и опционально - строчку для замены
символов TAB.
Например с использованием jQuery код инициализации может выглядеть так:
```javascript
$(document).ready(function() {
$('pre code').each(function(i, e) {hljs.highlightBlock(e, ' ')});
});
```
Если ваш блок кода использует `
` вместо переводов строки (т.е. если это не
``), передайте `true` третьим параметром в `highlightBlock`:
```javascript
$('div.code').each(function(i, e) {hljs.highlightBlock(e, null, true)});
```
### Выбор стилей
Размеченным классами элементам кода можно задать желаемые стили например так:
```css
.comment {
color: gray;
}
.keyword {
font-weight: bold;
}
.python .string {
color: blue;
}
.html .atribute .value {
color: green;
}
```
В комплекте с highlight.js идут несколько стилевых тем в директории styles,
которые можно использовать напрямую или как основу для собственных экспериментов.
**Внимание**: приложенные стили работают для кода, определённого внутри блоков
``. Если вы используете собственную разметку, стили нужно исправить
соответствующим образом.
Полный список классов приведён в файле [crossref.txt][cr].
[cr]: http://github.com/isagalaev/highlight.js/blob/master/classref.txt
## Экспорт
В файле export.html находится небольшая программка, которая показывает и дает
скопировать непосредственно HTML-код подсветки для любого заданного фрагмента кода.
Это может понадобится например на сайте, на котором нельзя подключить сам скрипт
highlight.js.
## Эвристика
Определение языка, на котором написан фрагмент, делается с помощью
довольно простой эвристики: программа пытается расцветить фрагмент всеми
языками подряд, и для каждого языка считает количество подошедших
синтаксически конструкций и ключевых слов. Для какого языка нашлось больше,
тот и выбирается.
Это означает, что в коротких фрагментах высока вероятность ошибки, что
периодически и случается. Чтобы указать язык фрагмента явно, надо написать
его название в виде класса к элементу ``:
```html
...
```
Можно использовать рекомендованные в HTML5 названия классов:
"language-html", "language-php". Также можно назначать классы на элемент
``.
Чтобы запретить расцветку фрагмента вообще, используется класс "no-highlight":
```html
...
```
## Координаты
- Версия: 6.2
- URL: http://softwaremaniacs.org/soft/highlight/
- Автор: Иван Сагалаев ()
Лицензионное соглашение читайте в файле LICENSE.
Список соавторов читайте в файле AUTHORS.ru.txt