Параметры шорткода плагина SyntaxHighlighter и список поддерживаемых языков

Привет дорогой кодер.

SyntaxHighlighter - это очень полезная для сайтов, так или иначе публикующих код, библиотека подсветки кода (и плагин для WP), который дает возможность выводить код в записях и на страницах в красивом и удобном формате без каких-либо затруднений. Многие популярные сервисы (в том числе и этот блог) используют эту библиотеку либо в стандартном виде, либо с внесением изменений в стили.

Проблемка в том, что у этого плагина куча параметров, которые реально сложно запомнить сразу, конечно всеми я не пользуюсь, но я пользуюсь многими, поэтому я решил выложить здесь этот небольшой пост с кратким описанием для всех параметров шорткода плагина SyntaxHighlighter-а, а также описанием синтаксиса. Блин, такое сложное предложение получилось :).

Если честно, эта запись планировалась изначально как небольшая шпаргалка для меня. Но логично оказалось, что эта информация нужна не только мне, поэтому надеюсь и тебе поможет эта информация.

Поэтому, спецом для тебя...

Все возможные параметры шорткода подсветки кода, а также список поддерживаемых языковых разметок в виде справки.

 

Параметры шорткода (кода для вставки SyntaxHighlighter):

lang or language — Цветовую схему для какого языка использовать. (Как вариант, можно использовать это слово как тэг)

autolinks — Активными или неактивными выводить ссылки в коде.

classname — Добавить дополнительный CSS-класс к контейнеру (блоку) с кодом.

collapse — Включить сворачивание кода по умолчанию, и разворачивание по клику. (Удобная штука, особенно когда кода много)

firstline — Переменная - номер первой строки вставленного кода Например, твой код по смыслу начинается не с первой строки, а из середины какого-нибудь скрипта, с 253-й строки, тогда и нумерация начнется не с первой строки, а с 253-й.

gutter — Включить нумерацию строк с левой стороны.

highlight — Разделенный запятыми список номеров строк, которые надо дополнительно подсветить. Более того, можно указать промежуток номеров. Например: 2,5-10,12 (2 строка, с 5-й по 10-ю строки, 12 строка)

htmlscript — Включить дополнительную подсветку HTML/XML. Очень удобная фича, когда ты совмещаешь HTML или XML с другим языком, например PHP код в HTML странице. Естественно, эта функция работает только с некоторыми языками.

light — Включить "облегченный" режим отображения. Отключена нумерация строк и тулбар. Только твой красивый код.

padlinenumbers — Отступ столбца с номерами строк. Корректные значения для этого параметра: false (нет отступа), true (автоматический отступ, по умолч.) или любая положительная цифра (в этом случае отступ в твоих руках).

title (только версия v3) — Заголовок к коду, вывод любого текста перед кодом. Практично сочетается с параметром collapse, чтобы читающий понимал, что его ждет внутри.

toolbar — Включить или выключить тулбар (кнопки в версии v2, значок об авторе в версии v3)

wraplines (только версия v2) — Настройка переноса строк. (Именно из-за этого параметра пользуюсь версией v2)

Парочка примеров шорткодов плагина SyntaxHighlighter-а:

!К сожалению ничего умнее чем заменить квадратные [] скобки на фигурные {} скобки я не придумал. Плагин работает с квадратными [].

{php}Твой PHP-код здесь{/php}

{css autolinks="false" classname="myclass" collapse="false" firstline="1" gutter="true" highlight="1-3,6,9" htmlscript="false" light="false" padlinenumbers="false" smarttabs="true" tabsize="4" toolbar="true" title="example-filename.php"}Твой CSS-код здесь{/css}

{code lang="js"}Твой JS-код здесь{/code}

{sourcecode language="plain"}Твой код здесь{/sourcecode}

Таблица поддерживаемых цветовых разметок языков:

(если дословно, это называется - кисти)

Язык Название для параметра
ActionScript3 as3, actionscript3
Bash/shell bash, shell
ColdFusion cf, coldfusion
C# c-sharp, csharp
C++ cpp, c
CSS css
Delphi delphi, pas, pascal
Diff diff, patch
Erlang erl, erlang
Groovy groovy
JavaScript js, jscript, javascript
Java java
JavaFX jfx, javafx
Perl perl, pl
PHP php
Plain Text plain, text
PowerShell ps, powershell
Python py, python
Ruby rails, ror, ruby
Scala scala
SQL sql
Visual Basic vb, vbnet
XML xml, xhtml, xslt, html, xhtml

Успехов в кодинге!

Богдан Григорук

[ Прочитайте комменты ниже или напишите свой... ]

Ищете хостинг для своего сайта? Могу порекомендовать свой (нажмите здесь)

Комментариев пока нет.