Extension:SyntaxHighlight/uk

Розширення SyntaxHighlight, раніше відоме як SyntaxHighlight_GeSHi, надає багате форматування початкового коду за допомогою тегу. Воно працює на бібліотеці Pygments і підтримує сотні різних мов програмування та форматів файлів.

Як і з тегами  і , текст відображається точнісінько так, як був набраний, зберігаючи будь-які пропуски.

Використання
Раз установивши, можна використовувати теги «syntaxhighlight» на вікі-сторінках. Наприклад,

є результатом наступної розмітки вікітексту:

У старіших версіях (до MediaWiki 1.16) розширення використовувало тег. Він досі підтримується, але  може допомогти уникнути конфліктів, якщо сам початковий код містить теги   (наприклад, XML).

Стилізація
Якщо відображуваний код завеликий, можна підігнати його, помістивши наступне на сторінку MediaWiki:Common.css у вашій Вікіпедії (створіть її за відсутності):

Оболонкування блоків коду в межі можна зробити шляхом вставки рядка на кшталт  у розділі вище. Контроль над використовуваною родиною шрифтів також може здійснюватися вставкою рядка на кшталт  у розділі вище.

Категорія помилок підсвічування синтаксису
Розширення додає сторінки, що мають поганий атрибут  у тегах   або , до категорії відстеження. Ключ повідомлення MediaWiki:syntaxhighlight-error-category визначає назву категорії; у цій Вікіпедії це Category:.

Найпоширенішою помилкою, що призводить до позначення сторінок даною категорією, є повна відсутність атрибуту  у тегах   або , оскільки старіші версії даного розширення підтримуювали визначення «$wgSyntaxHighlightDefaultLang». Як правило, можна або замінити на  чи , або додати   до тегу.

Категорія також може додаватися, а вміст не підсвічуватися, якщо текст перевищує 1000 рядків або 100 кБ.

lang
Атрибут  визначає, який лексичний аналізатор слід використати. Мова впливає на підсвічування розширенням початкового коду. Див. розділ Підтримувані мови для подробиць підтримуваних мов.

Вказання недійсної чи невідомої назви помітить сторінку категорією відстеження. Детальніше див. у розділі Категорія помилок підсвічування синтаксису на цій сторінці.

line
Атрибут  вмикає номери рядків.

start
Атрибут  (у поєднанні з  ) визначає номер першого рядка блоку коду. Наприклад,  пронумерує рядки, починаючи з 55.

highlight
Атрибут  визначає один чи більше рядків, які слід маркувати (підсвічуванням цих рядків іншим кольором тла). Можна вказати багато номерів рядків, розділених комами (наприклад, ), чи діапазони за допомогою двох номерів рядків і дефісу (наприклад,  ). Зауважте, що специфікація номерів рядків ігнорує будь-яке перенумерування відображених номерів рядків атрибутом.

є результатом

inline
Атрибут позначає, що початковий код слід вбудувати як частину абзацу (на відміну від власного блоку). Ця опція доступна, починаючи з MediaWiki 1.26. Для зворотної сумісності атрибут  має наслідок ту саму поведінку.

Зауважте, що розриви рядків можуть відбуватися в будь-якому місці між відкривальним і закривальним тегами, якщо початковий код не марковано нерозривним за допомогою  (на тих Вікіпедіях, що підтримують його; див. нижче) чи.

Наприклад:

є лямбда-виразом у мові Python.

є результатом:

є лямбда-виразом у мові Python.

class
При використанні,   (не тих Вікіпедіях, що підтримують його; не на самій MediaWiki) вказує, що рядки не слід розривати на пропусках у блоці коду.

Наприклад:

Без :

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx With : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

style
Атрибут  дозволяє пряме включення атрибутів CSS. Це еквівалентно оточуванню блоку в тег  (не  ). Атрибут  не можна вказувати таким чином; він вимагає оточування тегом , як описано нижче в Розширений.

Наприклад:

є результатом:

Підтримувані мови
Бібліотека Pygments надає підтримку сотень комп'ютерних мов і форматів файлів. повний список:

Programming languages
ActionScript

Ada

ANTLR

AppleScript

Assembly

Asymptote

Awk

Befunge

Boo

BrainFuck

C / C++

C#

Clojure

CoffeeScript

ColdFusion

Common Lisp

Coq

Cryptol

Crystal

Cython

D

Dart

Delphi

Dylan

Elm

Erlang

Ezhil

Factor

Fancy

Fortran

F#

GAP

Gherkin (Cucumber)

GL shaders

Groovy

Haskell

IDL

Io

Java

JavaScript

Lasso

LLVM

Logtalk

Lua

Matlab

MiniD

Modelica

Modula-2

MuPad

Nemerle

Nimrod

Objective-C

Objective-J

Octave

OCaml

PHP

Perl

PovRay

PostScript

PowerShell

Prolog

Python 2.x and 3.x

REBOL

Red

Redcode

Ruby

Rust

S, S-Plus and R

Scala

Scheme

Scilab

Smalltalk

SNOBOL

Tcl

Vala

Verilog

VHDL

Visual Basic.NET

Visual FoxPro

XQuery

Zephir

Template languages
Cheetah templates

Django / Jinja templates

ERB

Genshi

JSP

Myghty

Mako

Smarty templates

Tea

Other markup
Apache config files

Bash shell scripts

BBCode

CMake

CSS

Debian control files

Diff files

DTD

Gettext catalogs

Gnuplot script

Groff markup

HTML

HTTP sessions

INI-style config files

IRC logs (irssi style)

JSON

Lighttpd config files

Makefiles

MoinMoin/Trac Wiki markup

MySQL

Nginx config files

POV-Ray scenes

Ragel

Redcode

ReST

Robot Framework

RPM spec files

SQL

Squid configuration

TeX

tcsh

Vim Script

Windows batch files

XML

XSLT

YAML

Точні коди мов див. у повних деталях у документі Pygments, і деякі відображення для деяких назв мов, які підтримує GeSHi (повний список).

Нижче частковий список мов, які GeSHi може підсвітити, закреслені мови більше не підтримуються після перемикання на Pygments.

Конфігурація

 * Linux:


 * (опційна): Абсолютний шлях до pygmentize з пакету Pygments. Розширення за замовчуванням збирає пакет Pygments і точки  у комплектну версію, але можна вказати на іншу версію, якщо хочете. Наприклад:.
 * : Налаштовує лексичний аналізатор за замовчуванням для деяких вікі-сторінок. За замовчування це підсвічуватиме сторінки javascript і css. Додаткові моделі вмісту можуть налаштовуватися розширеннями (наприклад, Lua, JSON, …).


 * Windows:


 * Якщо ви розміщуєте свою MediaWiki на машині Windows, ви маєте встановити шлях для Pygmentize.exe
 * За відсутності  запустіть   з командного рядка всередині папки   для генерування файлу.

При використанні комплектного двійкового файлу pygmentize (extensions/SyntaxHighlight_GeSHi/pygments/pygmentize) впевніться, що веб-сервер має дозвіл виконувати його. Якщо ваш хост не дозволяє вам додавати виконавчі файли до веб-директорії, встановіть python-pygments і додайте  до LocalSettings.php.


 * Вирішення проблем:

Після оновлення до MediaWiki v1.26 і вище деякі користувачі почали доповідати про проблеми з розширенням. Можливі випадки, коли деякі мови на кшталт Lua могли не підсвічуватися, а після увімкнення налагодження MediaWiki викидав помилку.


 * Спробуйте вказати  у LocalSettings.php просто до зовнішнього двійкового файлу pygmentize.
 * In shared hosting environments with cPanel, this can be done by setting up a new Python application through the "Setup Python App" menu, and activating the virtual environment for the app through SSH . After this, the Pygments module can be added to the Python app, for which navigate to the virtual environment path, download and install Pygments and then activate the module by adding "Pygments" under the "Existing applications" section of the "Setup Python App" menu. This will create the required file at path:


 * Див. завдання на Фабрикаторі щодо цього для подальших пропозицій та інформації.

Інтеграція з Візуальним редактором
Плагін дозволяє пряме редагування з Візуальним редактором. Спливне вікно відкривається, коли користувач хоче редагувати розділи  або. Аби це працювало, Візуальний редактор повинен бути встановлений і налаштований з останньої версії на git, так само для Parsoid. Можливість довільно не працює зі старішими версіями Parsoid. Детальніше див. Extension:SyntaxHighlight/VisualEditor

Розширено
На відміну від тегів  та , символьні сутності HTML на кшталт   не вимагають (і не повинні) екранування символу   як. Як тег, але на відміну від тегу  , теги всередині діапазону (іншого, ніж власний закривальний тег) не вимагає екранування символу   як  , а вікітекст не вимагає екранування тегом.

Більше того, хоча  припускає табуляції щовісім символів і відображає їх за допомогою дійсних пропусків при копіюванні відображеного тексту,   використовує чотири-пропускні табуляції (за винятком Internet Explorer, який використовує 8) і зберігає символи табуляції у відображеному тексті; останнє може бути змінено за допомогою огородження тегом   (не   і не використовуючи власний атрибут  ). Префікс  вимагається для Firefox (з версії 4.0), а префікс   вимагається для Opera (з версії 10.60 до 15). (Зауважте, що вікно редагування вікі припускає восьми-пропускні табуляції.) Це застосовується лише для дійсних збережених сторінок, попередні перегляди, згенеровані через вікна редагування чи Special:ExpandTemplates можуть відрізнятися.

Див. також

 * Pygments – Python syntax highlighter
 * Пов'язані розширення:
 * – підсвічувальник синтаксису, що використовує бібліотеку Google Code Prettify.
 * – підсвічувальник синтаксису, що використовує бібліотеку SyntaxHighlighter.
 * – розширення, залежно від цього, для підтримки підсвіченого тексту з файлів, переглянутих через спеціальну сторінку.