Extension:SyntaxHighlight/uk

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

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

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

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

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

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

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

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

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

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

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

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

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)

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:


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

Інтеграція з Візуальним редактором
Плагін дозволяє пряме редагування з Візуальним редактором. A popup is opened when a user wants to edit  or   sections. For this to work, VisualEditor must be installed and configured from the latest git version, same for Parsoid. The feature randomly does not work with older Parsoid versions. See Extension:SyntaxHighlight/VisualEditor for details

Advanced
Unlike the  and   tags, HTML character entities such as   need not (and should not) have the   character escaped as. Like the  tag but unlike the   tag, tags within the range (other than its own closing tag) need not have the   symbol escaped as , nor does wikitext need to be escaped with a   tag.

Furthermore, while  assumes tab stops every 8 characters and renders tabs using actual spaces when the rendered text is copied,   uses 4-space tab stops (except Internet Explorer, which uses 8) and preserves the tab characters in the rendered text; the latter may be changed using an enclosing   tag (not , and not using its own   attribute). The  prefix is required for Firefox (from version 4.0), and the   prefix is required for Opera (from version 10.60 to version 15). (Note that the wiki editing box assumes 8-space tabs.) This applies only to actual saved pages; previews generated through an edit box or Special:ExpandTemplates may differ.