View source for Extension:SyntaxHighlight/ru

<languages />
{{bundled|1.21}}
{{note|1=Для подсветки синтаксиса викитекста при использовании редактора кода см. расширение {{ll|Extension:CodeMirror|CodeMirror}} или скрипты пользователей [[User:Remember the dot/Syntax highlighter|Remember the dot]] and [[:en:User:Cacycle/wikEd|Cacycle]].|2=reminder}}
{{Extension
|status    = stable
|type      = tag
|author    = <nowiki/>
* [[User:Brooke Vibber (WMF)|Brooke Vibber]],
* [[User:Tim Starling (WMF)|Tim Starling]],
* Rob Church,
* [[User:Ori Livneh (WMF)|Ori Livneh]]
|image     = SyntaxHighlighting with Pygments.png
|imagesize = 375
|version   = постоянное обновление
|update    = 
|compatibility policy = master
|mediawiki = 1.25+
|download  = {{WikimediaDownload|SyntaxHighlight_GeSHi|phab=ESHG}}
|needs-updatephp = No
|readme    = {{git file|action=raw|project=mediawiki/extensions/SyntaxHighlight_GeSHi|branch=HEAD|file=README|text=README}}
|changelog = 
|description = Позволяет подсвечивать исходный код на вики-страницах
|example   =
|phabricator = syntaxhighlight
|CheckUsageNameOverride = SyntaxHighlight
|tags = {{tag|syntaxhighlight|open}}
|translate = ext-syntaxhighlightgeshi
}}
Расширение '''SyntaxHighlight''', ранее известное как SyntaxHighlight_GeSHi обеспечивает огромное количество подсветок синтаксиса [[w:ru:Исходный код|кода]] используя тег {{tag|syntaxhighlight|open}}
Расширение работает от библиотеки [https://pygments.org Pygments] и поддерживает сотни различных языков программирования и форматов файлов.

Подобно тегам {{tag|pre|open}} и <code><{{ll|Extension:Poem|poem}}></code>, текст отображается точно так же, как и набранный, сохраняя любое пустое пространство.

The '''SyntaxHighlight''' extension does not work on wiki installations  [[wikipedia:Hardening (computing)|hardened]] using [http://hardened-php.net Hardened-PHP] due to the lack of <code>proc_open</code>, <code>shell_exec</code> and other functions.
См. {{phab|T250763}}.

Тег {{tag|syntaxhighlight|open}} стал [[Special:MyLanguage/Manual:$wgExpensiveParserFunctionLimit|затратным]] с версии 1.39. для 5000 или какого-то другого экстремального количества тегов синтаксиса на одной странице, например, для Викиучебника.
<span lang="en" dir="ltr" class="mw-content-ltr">Increase webserver timeout value in environments in extreme cases.</span>
(См. {{phab|T316858}}.)

<span id="Usage"></span>
== Применение ==

После установки вы можете использовать теги «syntaxhighlight» на страницах вики. Например,

<syntaxhighlight lang="python" line>
def quick_sort(arr):
	less = []
	pivot_list = []
	more = []
	if len(arr) <= 1:
		return arr
	else:
		pass
</syntaxhighlight>

является результатом следующей разметки wikitext:

{{#tag:syntaxhighlight|
{{^(}}syntaxhighlight lang="python" line{{)^}}
def quick_sort(arr):
	less = []
	pivot_list = []
	more = []
	if len(arr) <= 1:
		return arr
	else:
		pass
{{^(}}/syntaxhighlight{{)^}}
| lang = html
}}

В старых версиях (до MediaWiki 1.16) расширение использовало тег {{tag|source|open}}.
Этот вариант по-прежнему поддерживается, но считается устаревшим. Вместо него необходимо использовать {{tag|syntaxhighlight|open}}.

<span id="Styling"></span>
== Стайлинг ==

Если отображаемый код слишком велик, вы можете настроить его, поместив следующее на страницу <samp>MediaWiki:Common.css</samp> в своей вики (создайте её, если она не существует):

<syntaxhighlight lang="CSS">
/* CSS, размещённый здесь, будет применяться ко всем скинам */
.mw-highlight pre {
	font-size: 90%;
}
</syntaxhighlight>

Выделение рамкой кодовых блоков в границах можно сделать, вставив строку, подобную {{inline-code|lang=css|border: 1px dashed blue;}}, в секции выше.
Контроль над «семейством используемых шрифтов» также может быть осуществлен путем вставки строки, такой как {{inline-code|lang=css|font-family: "Courier New", monospace;}}, в секции выше.

<span id="Syntax_highlighting_error_category"></span>
== Категория подсветки ошибок синтаксиса ==
Расширение добавляет страницы, которые имеют неверный атрибут <code class="mw-highlight">{{attr|lang}}</code> в теге {{tag|syntaxhighlight|open}}, в [[Special:MyLanguage/Help:Tracking categories|отслеживающую категорию]].
Ключ сообщения [[MediaWiki:syntaxhighlight-error-category]] определяет имя категории; на этой вики это [[:Category:{{MediaWiki:syntaxhighlight-error-category}}]].

Наиболее распространённой ошибкой, которая приводит к тому, что страницы помечаются этой категорией, является тег {{tag|syntaxhighlight|open}} вообще без атрибута <code class="mw-highlight">{{attr|lang}}</code>, поскольку более старые версии этого расширения поддерживали определение {{phpi|$wgSyntaxHighlightDefaultLang}}.
Обычно их можно заменить на {{tag|pre|open}}, или к тегу можно добавить <code class="mw-highlight">{{attr|lang|"bash"}}</code> или <code class="mw-highlight">{{attr|lang|"text"}}</code>.

Категория также может быть добавлена, и её содержимое не будет выделено, если в тексте более 1000 строк или текст более 100 КБ.<ref>
[[phab:T104109#3879800]]
</ref>

<span id="Parameters"></span>
== Параметры ==
=== lang ===
Атрибут <code class="mw-highlight">{{attr|lang|"<var>name</var>"}}</code> определяет, какой lexer следует использовать.
Язык влияет на то, как расширение подсвечивает исходный код.
Подробнее о поддерживаемых языках см. в разделе [[#Supported_languages|Поддерживаемые языки]].

<syntaxhighlight lang="python">
def quick_sort(arr):
    less = []
</syntaxhighlight>
{{#tag:syntaxhighlight|
{{^(}}syntaxhighlight lang="python"{{)^}}
...
{{^(}}/syntaxhighlight{{)^}}
| lang = html
}}

Указание недопустимого или неизвестного имени пометит страницу, что поместит её в категорию отслеживания.
Подробнее см. в разделе [[#Syntax highlighting error category|Категория подсветки ошибок синтаксиса]] на этой странице.

=== line ===
Атрибут <code class="mw-highlight">{{attr|line}}</code> активирует нумерацию строк.

<syntaxhighlight lang="python" line>
def quick_sort(arr):
	less = []
</syntaxhighlight>
{{#tag:syntaxhighlight|
{{^(}}syntaxhighlight lang="python" line{{)^}}
...
{{^(}}/syntaxhighlight{{)^}}
| lang = html
}}

=== start ===
Атрибут <code class="mw-highlight">{{attr|start}}</code> (в сочетании с <code class="mw-highlight">{{attr|line}}</code>) определяет номер первой строки кода.
Например, <code class="mw-highlight">{{attr|line}} {{attr|start|"55"}}</code> начнёт нумерацию строк с числа 55.

<syntaxhighlight lang="python" line start="55">
def quick_sort(arr):
    less = []
</syntaxhighlight>
{{#tag:syntaxhighlight|
{{^(}}syntaxhighlight lang="python" line start="55"{{)^}}
...
{{^(}}/syntaxhighlight{{)^}}
| lang = html
}}

=== highlight ===
Атрибут <code class="mw-highlight">{{attr|highlight}}</code> указывает одну или несколько строк, которые должны быть отмечены (путем выделения этих строк другим цветом фона).
Вы можете указать несколько номеров строк, разделенных запятыми (например, <code class="mw-highlight">{{attr|highlight|"1,4,8"}}</code>) или диапазоны, используя два номера строк и дефис (например, <code class="mw-highlight">{{attr|highlight|"5-7"}}</code>).

{{note|1=Характеристика номера строки игнорирует любую перенумерацию отображаемых номеров строк с атрибутом <code class="mw-highlight">{{attr|start}}</code>.}}

<syntaxhighlight lang="python" line start="3" highlight="1,5-7">
def quick_sort(arr):
    less = []
    pivot_list = []
    more = []
    if len(arr) <= 1:
        return arr
</syntaxhighlight>

является результатом

{{#tag:syntaxhighlight|
{{^(}}syntaxhighlight lang="python" line start="3" highlight="1,5-7"{{)^}}
...
{{^(}}/syntaxhighlight{{)^}}
| lang = html
}}

{{anchor|enclose}}
=== inline ===
{{MW_1.26|and after}}
Атрибут указывает, что исходный код должен быть встроенным как часть абзаца (в отличие от отдельного блока).
Эта опция доступна начиная с MediaWiki 1.26.

{{note|1=Использование параметра «enclose» не рекомендуется; если установлено значение «none», его следует заменить на inline; в любом другом случае его можно полностью удалить.}}

{{note|1=Разрывы строк могут возникать в любом месте между тегами открытия и закрытия, если исходный код не помечен как неразрывный с помощью <code class="mw-highlight">{{attr|class|"nowrap"}}</code> (на тех вики, которые это поддерживают, см. ниже) или <code class="mw-highlight"><span style="white-space:nowrap">{{attr|style|"white-space:nowrap"}}</span></code>.}}

Например:

Следующий код <syntaxhighlight lang="python" inline>lambda x: x * 2</syntaxhighlight> - это [[w:ru:Анонимная функция|aнонимная функция]] в Python.

Является результатом:

{{#tag:syntaxhighlight|
Следующий код {{^(}}syntaxhighlight lang="python" inline{{)^}}lambda x: x * 2{{^(}}/syntaxhighlight{{)^}} - это [[w:ru:Анонимная функция|aнонимная функция]] в Python.
| lang = html
}}

=== class ===
Использование <code class="mw-highlight">{{attr|inline}}</code>, <code class="mw-highlight">{{attr|class|"nowrap"}}</code> (на тех вики, которые его поддерживают, а не на самой MediaWiki) указывает, что разрывы строк не должны возникать в пробелах внутри блока кода.

Например:

Без <code class="mw-highlight">{{attr|class|"nowrap"}}</code>:

<div style="max-width:800px; border:1px solid #ccc ">
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx<syntaxhighlight lang="python" inline>lambda x: x * 2</syntaxhighlight>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
</div>

С <code class="mw-highlight">{{attr|style|"white-space:nowrap"}}</code>:

<div style="max-width:800px; border:1px solid #ccc">
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx<syntaxhighlight lang="python" inline style="white-space:nowrap">lambda x: x * 2</syntaxhighlight>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
</div>

=== style ===
Атрибут <code class="mw-highlight">{{attr|style}}</code> позволяет напрямую использовать атрибуты CSS.
Это эквивалентно включению блока в тег {{tag|div|open}} (не {{tag|span|open}}).
Атрибут <code>tab‑size</code> не может быть указан таким образом; для этого требуется заключение в тег {{tag|span|open}}, как описано ниже, в разделе [[#Advanced| Дополнительно]].

Например:

<syntaxhighlight lang="python" style="border: 3px dashed blue;">
def quick_sort(arr):
	less = []
	pivot_list = []
	more = []
	if len(arr) <= 1:
		return arr
	else:
		pass
</syntaxhighlight>

Является результатом:

{{#tag:syntaxhighlight|
{{^(}}syntaxhighlight lang="python" style="border: 3px dashed blue;"{{)^}}
def quick_sort(arr):
	less = []
	pivot_list = []
	more = []
	if len(arr) <= 1:
		return arr
	else:
		pass
{{^(}}/syntaxhighlight{{)^}}
| lang = html
}}

<span id="Supported_languages"></span>
== Поддерживаемые языки ==
Библиотека Pygments обеспечивает поддержку для подсветки синтаксиса сотен компьютерных языков и форматированных файлов посредством различных "lexers", включённых в библиотеку.

В большинстве случаев атрибут <code>lang=</code>, используемый с этим расширением, представляет собой версию имени языка в нижнем регистре.
Однако у многих есть псевдонимы или "короткие имена", как они называются в документации Pygments; см. "[https://pygments.org/docs/lexers/ Доступные лексеры]" для получения полной информации.

Некоторые языки, ранее поддерживаемые [[w:GeSHi|GeSHi]], были сопоставлены с лексерами Pygments; подробности см. в [https://github.com/wikimedia/mediawiki-extensions-SyntaxHighlight_GeSHi/blob/master/includes/SyntaxHighlightGeSHiCompat.php <code>SyntaxHighlightGeSHiCompat.php</code>].

{{tip|1=Pygments предоставляет лексер "[https://pygments.org/docs/lexers/#pygments.lexers.markup.WikitextLexer wikitext]" с апреля 2023 года. Вместо этого используйте "[https://pygments.org/docs/lexers/#pygments.lexers.templates.HandlebarsHtmlLexer html+handlebars]" или "[https://pygments.org/docs/lexers/#pygments.lexers.markup.MoinWikiLexer moin]".}}

[https://pygments.org/languages/ Полный список] поддерживаемых Pygments языков по состоянию на январь 2020 года:
*
=== Языки программирования ===
<blockquote>
{{flatlist|1=
* ActionScript
* Ada
* Agda (включая Literate Agda)
* Alloy
* AMPL
* ANTLR
* APL
* AppleScript
* Ассемблер (различные)
* Asymptote
* Augeas
* AutoIt
* Awk
* BBC Basic
* Befunge
* BlitzBasic
* Boa
* Boo
* Boogie
* BrainFuck
* C, C++ (включая диалекты, например Arduino)
* C#
* Chapel
* Charm++ CI
* Cirru
* Clay
* Clean
* Clojure
* CoffeeScript
* ColdFusion
* Common Lisp
* Component Pascal
* Coq
* Croc (MiniD)
* Cryptol (включая Literate Cryptol)
* Crystal
* Cypher
* Cython
* D
* Dart
* DCPU-16
* Delphi
* Dylan (включая консоль)
* Eiffel
* Elm
* Emacs Lisp
* Email
* Erlang (включая сессии в командной строке)
* Ezhil
* Factor
* Fancy
* Fantom
* Fennel
* FloScript
* Forth
* Fortran
* FreeFEM++
* F#
* GAP
* Gherkin (Cucumber)
* Шейдеры GLSL
* Golo
* Gosu
* Groovy
* Haskell (включая Literate Haskell)
* HLSL
* HSpec
* Hy
* IDL
* Idris (включая Literate Idris)
* Igor Pro
* Io
* Jags
* Java
* JavaScript
* Jasmin
* Jcl
* Julia
* Kotlin
* Lasso (включая шаблонизирование)
* Limbo
* LiveScript
* Logtalk
* Logos
* Lua
* Mathematica
* Matlab
* Modelica
* Modula-2
* Monkey
* Monte
* MoonScript
* Mosel
* MuPad
* NASM
* Nemerle
* NesC
* NewLISP
* Nimrod
* Nit
* Notmuch
* NuSMV
* Objective-C
* Objective-J
* Octave
* OCaml
* Opa
* OpenCOBOL
* ParaSail
* Pawn
* PHP
* Perl 5
* Pike
* Pony
* PovRay
* PostScript
* PowerShell
* Praat
* Prolog
* Python (включая сессии в командной строке и трассировки стека)
* QBasic
* Racket
* Raku a.k.a. Perl 6
* REBOL
* Red
* Redcode
* Rexx
* Ride
* Ruby (включая сессии irb)
* Rust
* S, S-Plus, R
* Scala
* Scdoc
* Scheme
* Scilab
* SGF
* Сценарии командной строки (Bash, Tcsh, Fish)
* Shen
* Silver
* Slash
* Slurm
* Smalltalk
* SNOBOL
* Snowball
* Solidity
* SourcePawn
* Stan
* Standard ML
* Stata
* Swift
* Swig
* SuperCollider
* Tcl
* Tera Term language
* TypeScript
* TypoScript
* USD
* Unicon
* Urbiscript
* Vala
* VBScript
* Verilog, SystemVerilog
* VHDL
* Visual Basic.NET
* Visual FoxPro
* Whiley
* Xtend
* XQuery
* Zeek
* Zephir
* Zig
}}
</blockquote>

=== Языки шаблонов ===
<blockquote>
{{flatlist|1=
* Шаблоны Angular
* Шаблоны Cheetah
* ColdFusion
* Шаблонизатор Django / Jinja
* ERB (шаблонизатор Ruby)
* Evoque
* Genshi (шаблонизатор проекта Trac)
* Handlebars
* JSP (Java Server Pages)
* Liquid
* Myghty (фреймворк на основе HTML::Mason)
* Mako (преемник Myghty)
* Slim
* Smarty (шаблонизация для языка PHP)
* Tea
* Twig
}}
</blockquote>

=== Другая разметка ===
<blockquote>
{{flatlist|1=
* Конфигурационные файлы Apache
* Apache Pig
* BBCode
* CapDL
* Cap'n Proto
* CMake
* Партитуры Csound
* CSS
* Управляющие (control) файлы Debianа
* Diff файлы
* Dockerfiles
* DTD
* EBNF
* Заголовки электронной почты
* Extempore
* Flatline
* Каталоги gettext
* Скрипт Gnuplot
* Groff разметка
* Hexdumps
* HTML
* HTTP сессии
* IDL
* Inform
* Конфигурационные файлы в стиле .ini
* Логи IRC (в стили irssi)
* Isabelle
* Нотация JSGF
* JSON, JSON-LD
* Доказатель теорем Lean
* Конфигурационные файлы lighttpd
* Сообщения ядра Linux (dmesg)
* Сборка LLVM
* Скрипты LSL
* Makefiles
* Вики-разметка MoinMoin/Trac
* MQL
* MySQL
* NCAR command language
* Конфигурационные файлы nginx
* Язык [[w:Nix package manager|Nix]]
* Скрипты NSIS
* Notmuch
* сцены POV-Ray
* Puppet
* QML
* Ragel
* Redcode
* ReST
* Roboconf
* Robot Framework
* файлы спецификации RPM
* Rql
* RSL
* Scdoc
* SPARQL
* SQL, а также MySQL, SQLite
* Конфигурационные файлы Squidа
* TADS 3
* Terraform
* TeX
* Thrift
* TOML
* Спецификации грамматик на Treetop
* USD (Universal Scene Description)
* Конфигурационные файлы Varnish
* VGL
* Vim Script
* WDiff
* Пакетный файл Windows
* XML
* XSLT
* YAML
* Файлы реестра Windows
}}
</blockquote>

{{Note|1=Начиная с MediaWiki 1.37, с обновлением pygments до версии 2.10.0 было добавлено больше лексеров, как описано в {{Phab|T280117}}.

{{flatlist|1=
* ansys
* apdl
* asc
* gcode
* golang === go
* gsql
* jslt
* julia-repl
* kuin
* meson
* nestedtext
* nodejsrepl
* nt
* omg-idl
* output
* pem
* procfile
* pwsh
* smithy
* teal
* thingsdb
* ti
* wast
* wat
}}

}}

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

{{Collapse top
|title=Лексические анализаторы ранее поддерживаемые при помощи GeSHi
|padding=.3em
}}
{|class="wikitable" style="font-size:small;line-height:normal;margin:0;padding:0"
|-
!scope="col"| Код
!scope="col"|Язык
|-
|<del><code>4cs</code></del>||GADV 4CS
|-
|<code>6502acme</code>||MOS 6502 (6510) ACME Cross Assembler
|-
|<code>6502kickass</code>||MOS 6502 (6510) Kick Assembler
|-
|<code>6502tasm</code>||MOS 6502 (6510) TASM/64TASS
|-
|<code>68000devpac</code>||Motorola 68000 - HiSoft Devpac ST 2 Assembler
|-
|<code>abap</code>||[[w:ABAP|ABAP]]
|-
|<code>actionscript</code>||[[w:ActionScript|ActionScript]]
|-
|<code>actionscript3</code>||[[w:ActionScript3|ActionScript3]]
|-
|<code>ada</code>||[[w:Ada (programming language)|Ada]]
|-
|<del><code>algol68</code></del>||[[w:ALGOL 68|ALGOL 68]]
|-
|<code>apache</code>||[[w:Apache HTTP Server|Apache Configuration]]
|-
|<code>applescript</code>||[[w:AppleScript|AppleScript]]
|-
|<code>apt_sources</code>||[[w:Apt sources|Apt sources]]
|-
|<code>arm</code>||[[w:ARM architecture|ARM]] Assembler
|-
|<code>asm</code>||[[w:Assembly language|Assembly]]
|-
|<code>asp</code>||[[w:Active Server Pages|Active Server Pages (ASP)]]
|-
|<code>asymptote</code>||[[w:Asymptote (vector graphics language)|Asymptote]]
|-
|<del><code>autoconf</code></del>||[[w:Autoconf|Autoconf]]
|-
|<code>autohotkey</code>||[[w:AutoHotkey|AutoHotkey]]
|-
|<code>autoit</code>||[[w:AutoIt|AutoIt]]
|-
|<del><code>avisynth</code></del>||[[w:AviSynth|AviSynth]]
|-
|<code>awk</code>||[[w:AWK|AWK]]
|-
|<code>bascomavr</code>||BASCOM AVR
|-
|<code>bash</code>||[[w:Bash (Unix shell)|Bash]]
|-
|<code>basic4gl</code>||[[w:Basic4GL|Basic4GL]]
|-
|<code>bf</code>||[[w:Brainfuck|Brainfuck]]
|-
|<code>bibtex</code>||[[w:BibTeX|BibTeX]]
|-
|<code>blitzbasic</code>||[[w:Blitz BASIC|Blitz BASIC]]
|-
|<code>bnf</code>||[[w:Backus–Naur Form|Backus–Naur Form]]
|-
|<code>boo</code>||[[w:Boo (programming language)|Boo]]
|-
|<code>c</code>||[[w:C (programming language)|C]]
|-
|<code>c_loadrunner</code>||C Loadrunner
|-
|<code>c_mac</code>||C (Mac)
|-
|<del><code>caddcl</code></del>||[[w:Dialog Control Language|AutoCAD DCL]]
|-
|<code>cadlisp</code>||[[w:AutoLISP|AutoLISP]]
|-
|<code>cfdg</code>||CFDG
|-
|<code>cfm</code>||[[w:ColdFusion Markup Language|ColdFusion Markup Language]]
|-
|<code>chaiscript</code>||[[w:ChaiScript|ChaiScript]]
|-
|<del><code>cil</code></del>||[[w:Common_Intermediate_Language|Common Intermediate Language (CIL)]]
|-
|<code>clojure</code>||[[w:Clojure|Clojure]]
|-
|<code>cmake</code>||[[w:CMake|CMake]]
|-
|<code>cobol</code>||[[w:COBOL|COBOL]]
|-
|<code>coffeescript</code>||[[w:CoffeeScript|CoffeeScript]]
|-
|<code>cpp</code>||[[w:C++|C++]]
|-
|<code>cpp-qt</code>||[[w:Qt (toolkit)|C++ (Qt toolkit)]]
|-
|<code>csh</code>||[[w:C Shell|C shell]]
|-
|<code>csharp</code>||[[w:C Sharp (programming language)|C#]]
|-
|<code>css</code>||[[w:Cascading Style Sheets|Cascading Style Sheets (CSS)]]
|-
|<del><code>cuesheet</code></del>||[[w:Cue sheet (computing)|Cue sheet]]
|-
|<code>d</code>||[[w:D (programming language)|D]]
|-
|<code>dart</code>||[[w:Dart (programming language)|Dart]]
|-
|<code>dcl</code>||[[w:Data Control Language|Data Control Language]]
|-
|<code>dcpu16</code>||[[w:DCPU-16|DCPU-16]]
|-
|<del><code>dcs</code></del>||Data Conversion System
|-
|<code>delphi</code>||[[w:Delphi programming language|Delphi]]
|-
|<code>diff</code>||[[w:Diff|Diff]]
|-
|<code>div</code>||DIV
|-
|<code>dosbatch</code>||[[w:DOS batch file|DOS batch file]]
|-
|<del><code>dot</code></del>||[[w:DOT (graph description language)|DOT]]
|-
|<del><code>e</code></del>||[[w:E (programming language)|E]]
|-
|<code>ebnf</code>||[[w:Backus–Naur Form|Extended Backus–Naur Form]]
|-
|<code>ecmascript</code>||[[w:ECMAScript|ECMAScript]]
|-
|<code>eiffel</code>||[[w:Eiffel (programming language)|Eiffel]]
|-
|<del><code>email</code></del>||Email (mbox \ eml \ RFC format)
|-
|<del><code>epc</code></del>||Enerscript
|-
|<code>erlang</code>||[[w:Erlang (programming language)|Erlang]]
|-
|<code>euphoria</code>||[[w:Euphoria (programming language)|Euphoria]]
|-
|<del><code>f1</code></del>||Formula One
|-
|<del><code>falcon</code></del>||[[w:Falcon (programming language)|Falcon]]
|-
|<del><code>fo</code></del>||FO
|-
|<code>fortran</code>||[[w:Fortran|Fortran]]
|-
|<code>freebasic</code>||[[w:FreeBASIC|FreeBASIC]]
|-
|<del><code>freeswitch</code></del>||[[w:FreeSWITCH|FreeSWITCH]]
|-
|<code>fsharp</code>||[[w:Fsharp|Fsharp]]
|-
|<code>gambas</code>||[[w:Gambas programming language|Gambas]]
|-
|<del><code>gdb</code></del>||[[w:GDB|GDB]]
|-
|<code>genero</code>||Genero
|-
|<del><code>genie</code></del>||[[w:Genie (programming language)|Genie]]
|-
|<code>gettext</code>||[[w:gettext|gettext]]
|-
|<code>glsl</code>||[[w:GLSL|OpenGL Shading Language (GLSL)]]
|-
|<del><code>gml</code></del>||[[w:Game Maker Language|Game Maker Language (GML)]]
|-
|<code>gnuplot</code>||[[w:gnuplot|gnuplot]]
|-
|<code>go</code>||[[w:Go (programming language)|Go]]
|-
|<code>groovy</code>||[[w:Groovy (programming language)|Groovy]]
|-
|<code>gwbasic</code>||[[w:GW-BASIC|GW-BASIC]]
|-
|<code>haskell</code>||[[w:Haskell (programming language)|Haskell]]
|-
|<code>haxe</code>||[[w:Haxe|Haxe]]
|-
|<del><code>hicest</code></del>||HicEst
|-
|<del><code>hq9plus</code></del>||[[w:HQ9+|HQ9+]]
|-
|<del><code>html4strict</code></del>||[[w:HTML|HTML]] (use "html" instead)
|-
|<del><code>html5</code></del>||[[w:HTML5|HTML5]] (use "html" instead)
|-
|<code>icon</code>||[[w:Icon (programming language)|Icon]]
|-
|<code>idl</code>||[[w:Universal Network Objects|Uno IDL]]
|-
|<code>ini</code>||[[w:INI file|INI]]
|-
|<del><code>inno</code></del>||[[w:Inno Setup|Inno]]
|-
|<del><code>intercal</code></del>||[[w:INTERCAL|INTERCAL]]
|-
|<code>io</code>||[[w:Io (programming language)|Io]]
|-
|<code>j</code>||[[w:J (programming language)|J]]
|-
|<code>java</code>||[[w:Java (programming language)|Java]]
|-
|<code>java5</code>||[[w:Java (programming language)|Java(TM) 2 Platform Standard Edition 5.0 ]]
|-
|<code>javascript</code>||[[w:JavaScript|JavaScript]]
|-
|<code>jquery</code>||[[w:jQuery|jQuery]]
|-
|<del><code>kixtart</code></del>||[[w:KiXtart|KiXtart]]
|-
|<del><code>klonec</code></del>||Klone C
|-
|<del><code>klonecpp</code></del>||Klone C++
|-
|<code>kotlin</code>||[[w:Kotlin (programming language)|Kotlin]]
|-
|<code>ksh</code>||[[w:Korn Shell|Korn shell]]
|-
|<code>latex</code>||[[w:LaTeX|LaTeX]]
|-
|<del><code>lb</code></del>||[[w:Liberty BASIC|Liberty BASIC]]
|-
|<del><code>ldif</code></del>||[[w:LDAP Data Interchange Format|LDAP Data Interchange Format]]
|-
|<code>lisp</code>||[[w:Lisp (programming language)|Lisp]]
|-
|<code>llvm</code>||[[w:LLVM|LLVM]]
|-
|<code>locobasic</code>||[[w:Locomotive BASIC|Locomotive BASIC]]
|-
|<code>logtalk</code>||[[w:Logtalk|Logtalk]]
|-
|<del><code>lolcode</code></del>||[[w:LOLCODE|LOLCODE]]
|-
|<del><code>lotusformulas</code></del>||[[w:Formula language|Formula language]]
|-
|<del><code>lotusscript</code></del>||[[w:LotusScript|LotusScript]]
|-
|<del><code>lscript</code></del>||[[w:LScript|LightWave 3D]]
|-
|<del><code>lsl2</code></del>||[[w:Linden Scripting Language|Linden Scripting Language]]
|-
|<code>lua</code>||[[w:Lua (programming language)|Lua]]
|-
|<del><code>magiksf</code></del>||[[w:Magik (programming language)|Magik]]
|-
|<code>m68k</code>||[[w:Motorola 68000|Motorola 68000 Assembler]]
|-
|<code>make</code>||[[w:Make (software)|make]]
|-
|<code>mapbasic</code>||[[w:MapBasic|MapBasic]]
|-
|<code>matlab</code>||[[w:MATLAB|MATLAB M]]
|-
|<del><code>mirc</code></del>||[[w:mIRC scripting language|mIRC scripting language]]
|-
|<code>mmix</code>||[[w:MMIX|MMIX]]
|-
|<code>modula2</code>||[[w:Modula-2|Modula-2]]
|-
|<del><code>modula3</code></del>||[[w:Modula-3|Modula-3]]
|-
|<code>mpasm</code>||[[w:PIC microcontroller|Microchip Assembler]]
|-
|<code>mxml</code>||[[w:MXML|MXML]]
|-
|<code>mysql</code>||[[w:MySQL|MySQL]]
|-
|<del><code>nagios</code></del>||[[w:Nagios|Nagios]]
|-
|<code>netrexx</code>||[[w:NetRexx|NetRexx]]
|-
|<code>newlisp</code>||[[w:NewLISP|NewLISP]]
|-
|<code>nsis</code>||[[w:Nullsoft Scriptable Install System|Nullsoft Scriptable Install System (NSIS)]]
|-
|<code>oberon2</code>||[[w:Oberon-2 (programming language)|Oberon-2]]
|-
|<code>objc</code>||[[w:Objective-C|Objective-C]]
|-
|<del><code>objeck</code></del>||[[w:Objeck (programming language)|Objeck]]
|-
|<code>ocaml</code>||[[w:OCaml|OCaml]]
|-
|<code>ocaml-brief</code>||[[w:OCaml|OCaml]]
|-
|<code>octave</code>||[[w:Octave programming language|Octave]]
|-
|<code>oobas</code>||[[w:StarOffice Basic|LibreOffice/OpenOffice.org Basic]]
|-
|<code>oorexx</code>||[[w:Object REXX|Object REXX]]
|-
|<code>oracle11</code>||[[w:PL/SQL|Oracle 11 SQL]]
|-
|<code>oracle8</code>||[[w:PL/SQL|Oracle 8 SQL]]
|-
|<del><code>oxygene</code></del>||[[w:Oxygene (programming language)|Oxygene]]
|-
|<code>oz</code>||[[w:Oz (programming language)|Oz]]
|-
|<del><code>parasail</code></del>||[[w:ParaSail (programming language)|ParaSail]]
|-
|<del><code>parigp</code></del>||[[w:PARI/GP|PARI/GP]]
|-
|<code>pascal</code>||[[w:Pascal (programming language)|Pascal]]
|-
|<del><code>pcre</code></del>||[[w:Perl Compatible Regular Expressions|Perl Compatible Regular Expressions]]
|-
|<del><code>per</code></del>||per
|-
|<code>perl</code><code>pl</code><br />||[[w:Perl|Perl]]
|-
|<code>perl6</code><br /><code>pl6</code><br /><code>raku</code>||[[w:Perl 6|Perl 6]]
|-
|<del><code>pf</code></del>||[[w:PF (firewall)|PF]]
|-
|<code>php</code>||[[w:PHP|PHP]]
|-
|<code>php-brief</code>||[[w:PHP|PHP]] ''([[phab:T94292 |deprecated]] &ndash; no colors, odd framing)''
|-
|<code>pic16</code>||[[w:PIC microcontroller|PIC assembly language]]
|-
|<code>pike</code>||[[w:Pike (programming language)|Pike]]
|-
|<del><code>pixelbender</code></del>||[[w:Adobe Pixel Bender|Pixel Bender]]
|-
|<del><code>pli</code></del>||[[w:PL/I|PL/I]]
|-
|<code>plsql</code>||[[w:PL/SQL|PL/SQL]]
|-
|<code>postgresql</code>||[[w:PostgreSQL|PostgreSQL]]
|-
|<code>postscript</code>||[[w:PostScript|PostScript]]
|-
|<code>povray</code>||[[w:POV-Ray|Persistence of Vision Raytracer]]
|-
|<del><code>powerbuilder</code></del>||[[w:PowerBuilder|PowerBuilder]]
|-
|<code>powershell</code>||[[w:Windows PowerShell|Windows PowerShell]]
|-
|<del><code>proftpd</code></del>||[[w:ProFTPD|ProFTPD]]
|-
|<code>progress</code>||[[w:OpenEdge Advanced Business Language|OpenEdge Advanced Business Language]]
|-
|<code>prolog</code>||[[w:Prolog|Prolog]]
|-
|<code>properties</code>||[[w:.properties|Properties file]]
|-
|<del><code>providex</code></del>||[[w:ProvideX|ProvideX]]
|-
|<code>purebasic</code>||[[w:PureBasic|PureBasic]]
|-
|<code>pycon</code>||[[w:Python (programming language)|Python]]
|-
|<code>pys60</code>||[[w:Python for S60|PyS60]]
|-
|<code>python</code><br /><code>py</code><br /><code>python3</code><br /><code>py3</code>||[[w:Python (programming language)|Python]]
|-
|<code>python2</code><br /><code>py2</code>||[[w:Python (programming language)|Python 2]]
|-
|<del><code>q</code></del>||[[w:Q (equational programming language)|Q]]
|-
|<code>qbasic</code>||[[w:QBasic|QBasic/QuickBASIC]]
|-
|<code>rails</code>||[[w:Ruby on Rails|Rails]]
|-
|<code>rebol</code>||[[w:Rebol|Rebol]]
|-
|<code>reg</code>||[[w:Windows Registry|Windows Registry]]
|-
|<code>rexx</code>||[[w:Rexx|Rexx]]
|-
|<del><code>robots</code></del>||[[w:Robots exclusion standard|robots.txt]]
|-
|<code>rpmspec</code>||[[w:RPM Package Manager|RPM Spec files]]
|-
|<code>rsplus</code>||[[w:R (programming language)|R]]
|-
|<code>ruby</code>||[[w:Ruby (programming language)|Ruby]]
|-
|<del><code>sas</code></del>||[[w:SAS (software)|SAS]]
|-
|<code>scala</code>||[[w:Scala_(programming_language)|Scala]]
|-
|<code>scheme</code>||[[w:Scheme (programming language)|Scheme]]
|-
|<code>sh</code><br /><code>shell</code><br /><code>shell-session</code>||[[w:Shell script|Shell Script]] (POSIX)
|-
|<code>scilab</code>||[[w:Scilab|Scilab]]
|-
|<code>sdlbasic</code>||[[w:SdlBasic|SdlBasic]]
|-
|<code>smalltalk</code>||[[w:Smalltalk|Smalltalk]]
|-
|<code>smarty</code>||[[w:Smarty|Smarty]]
|-
|<code>spark</code>||[[w:SPARK (programming language)|SPARK]]
|-
|<code>sparql</code>||[[w:SPARQL|SPARQL]]
|-
|<code>sql</code>||[[w:SQL|SQL]]
|-
|<del><code>stonescript</code></del>||StoneScript (Scripting language for [[w:ShiVa|ShiVa3D]])
|-
|<code>systemverilog</code>||[[w:SystemVerilog|SystemVerilog]]
|-
|<code>tcsh</code>||[[w:Tcsh|Tcsh]]
|-
|<code>tcl</code>||[[w:Tcl|Tcl]]
|-
|<code>teraterm</code>||[[w:Tera Term|Tera Term]]
|-
|<code>text</code>||[[w:Plain text|Plain text]]
|-
|<code>thinbasic</code>||[[w:thinBasic|thinBasic]]
|-
|<code>ts</code>||[[w:TypeScript|TypeScript]]
|-
|<code>tsql</code>||[[w:Transact-SQL|Transact-SQL]]
|-
|<code>typoscript</code>||[[w:TYPO3|TypoScript]]
|-
|<code>unicon</code>||[[w:Unicon (programming language)|Unicon]]
|-
|<code>upc</code>||[[w:Unified Parallel C|Unified Parallel C]]
|-
|<code>urbi</code>||[[w:URBI|URBI]]
|-
|<del><code>uscript</code></del>||[[w:UnrealScript|UnrealScript]]
|-
|<code>vala</code>||[[w:Vala_(programming_language)|Vala]]
|-
|<code>vb</code>||[[w:Visual Basic|Visual Basic]]
|-
|<code>vbnet</code>||[[w:Visual Basic .NET|Visual Basic .NET]]
|-
|<del><code>vedit</code></del>||[[w:VEDIT|VEDIT]]
|-
|<code>verilog</code>||[[w:Verilog|Verilog]]
|-
|<code>vhdl</code>||[[w:VHDL|VHDL]]
|-
|<code>vim</code>||[[w:Vim script|Vim script]]
|-
|<code>visualfoxpro</code>||[[w:Visual FoxPro|Visual FoxPro]]
|-
|<code>visualprolog</code>||[[w:Visual Prolog|Visual Prolog]]
|-
|<del><code>whitespace</code></del>||[[w:Whitespace (programming_language)|Whitespace]]
|-
|<del><code>whois</code></del>||[[w:Whois|Whois]]
|-
|<code>winbatch</code>||[[w:Winbatch|Winbatch]]
|-
|<code>xml</code>||[[w:XML|XML]]
|-
|<del><code>xorg_conf</code></del>||[[w:Xorg.conf|Xorg.conf]]
|-
|<code>yaml</code>||[[w:YAML|YAML]]
|-
|<code>xpp</code>||[[w:Microsoft Dynamics AX|Microsoft Dynamics AX]]
|-
|<code>z80</code>||[[w:Zilog Z80|ZiLOG Z80 Assembler]]
|-
|<code>zxbasic</code>||ZXBasic
|}
{{Collapse bottom}}


<span id="Installation"></span>
== Установка ==
{{Note|1=Версия этого расширения в комплекте с [[MediaWiki 1.31]] требует установки [https://www.python.org Python] версии 3 (<code>python3</code>) на сервере. Это изменение по сравнению с версией в комплекте с [[MediaWiki 1.30]], в которой использовалась версия Python 2 (<code>python</code>).}}
{{Note|1=Несмотря на то, что расширение обновлено до Pygments (и ухода от GeSHi), и несмотря на его обновленное имя, это внутреннее расширение по-прежнему использует прежние имена файлов, как указано ниже.}}
{{ExtensionInstall
|vagrant=syntaxhighlight
|SyntaxHighlight_GeSHi
|composer=yes
|registration=required
|custom-steps=<nowiki/>
* В '''Linux''', установите разрешения для выполнения "pygmentize". Для этого вы можете использовать FTP-клиент или следующую команду:

<syntaxhighlight lang="Bash">
chmod a+x /path/to/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize
</syntaxhighlight>
}}
{{Note|1=При установке из [[Special:MyLanguage/Git|Git]] обратите внимание, что начиная с MediaWiki 1.26 и кончая MediaWiki 1.31, для этого расширения требуется [[Special:MyLanguage/Composer|Composer]].<br /><br />Итак, после установки из Git измените на каталог, содержащий расширение, например. <code>"../extensions/SyntaxHighlight_GeSHi/"</code> и запустите {{inline-code|composer install --no-dev|bash}} или при обновлении: {{inline-code|composer update --no-dev|bash}}.<br /><br />Альтернативно, а также предпочтительно добавить строку {{inline-code|"extensions/SyntaxHighlight_GeSHi/composer.json"|json}} в файл "composer.local.json" в корневой каталог вашей вики, например:
<syntaxhighlight lang="JSON">
{
	"extra": {
		"merge-plugin": {
			"include": [
				"extensions/SyntaxHighlight_GeSHi/composer.json"
			]
		}
	}
}
</syntaxhighlight>
Теперь запустите {{inline-code|composer update --no-dev|bash}}. Voilà!
}}
{{Warning|1=При загрузке расширения через FTP обязательно загрузите файл ''pygments/pygmentize'' с типом передачи ''binary''.}}

<span id="Configuration"></span>
=== Настройка ===
{{phpi|$wgSyntaxHighlightMaxLines}} and {{phpi|$wgSyntaxHighlightMaxBytes}} (optional): For performance reasons, blobs or pages (JS, Lua and CSS pages) larger than these values will not be highlighted. (since 1.40)

;Linux:

* {{phpi|$wgPygmentizePath}} (необязательно): Абсолютный путь к ''pygmentize'' пакета Pygments. Расширение связывает пакет Pygments и {{phpi|$wgPygmentizePath}} с установленной версией по умолчанию, но вы можете указать другую версию, если хотите. Например: {{phpi|$wgPygmentizePath {{=}} "/usr/local/bin/pygmentize";}}.

;Windows:

* Если вы размещаете свою Mediawiki на компьютере с Windows, вам необходимо установить путь для Pygmentize.exe в {{phpi|$wgPygmentizePath {{=}} "c:\\Python27\\Scripts\\pygmentize.exe";}}
** Если в директории нет <code>pygmentize.exe</code> запустите <code>easy_install Pygments</code> из командной строки внутри папки <code>Scripts</code>, чтобы сгенерировать файл.

Если вы используете бинарный пакет pygmentize (extensions/SyntaxHighlight_GeSHi/pygments/pygmentize), убедитесь, что вашему веб-серверу разрешено его выполнение.
Если ваш хост не позволяет добавлять исполняемые файлы в ваш веб-каталог, установите python-pygments и добавьте {{phpi|$wgPygmentizePath {{=}} pygmentize}} в LocalSettings.php.

;Поиск и устранение неисправностей:

После обновления до MediaWiki v1.26 и выше некоторые пользователи начали сообщать о проблемах с расширением. Могут быть случаи, когда некоторые языки (например «Luа») могут не подсвечиваться, и при включении [[Special:MyLanguage/Manual:How to debug|режима отладки]] MediaWiki выдает ошибку, <code>Notice: Failed to invoke Pygments: /usr/bin/env: python3: No such file or directory</code>.

* Попробуйте указать в {{phpi|$wgPygmentizePath}} в LocalSettings.php на внешний двоичный файл pygmentize.
:* В средах общего хостинга с cPanel это можно сделать, настроив новое приложение Python через меню "Настройка приложения Python" и активировав виртуальную среду для приложения через SSH (<code>source /virtualenv/python/3.5/bin/activate</code>). После этого Pygments [https://clients.temok.com/knowledgebase.php?action=displayarticle&id=524 модуль можно добавить] в приложение Python, для чего перейдите по пути к виртуальной среде (<code>cd virtualenv/python/3.5/bin/</code>), загрузите и установите Pygments (<code>./pip install Pygments</code>), а затем активируйте модуль, добавив "Pygments" в раздел "Существующие приложения" меню "Настройка приложения Python". Это создаст требуемый файл по адресу: <code>virtualenv/python/3.5/bin/pygmentize</code>
* См. [[phab:T128993]] для этого для дальнейших предложений и информации.
* SELinux также может предотвратить запуск расширения с ошибкой, аналогичной <code>type=AVC msg=audit(1609598265.169:225924): avc:  denied  { execute } for  pid=2360888 comm="bash" name="pygmentize" dev="dm-0" ino=50814399 scontext=system_u:system_r:httpd_t:s0 tcontext=unconfined_u:object_r:httpd_user_content_t:s0 tclass=file permissive=0</code> в вашем audit.log. Это может быть разрешено с <code>setsebool -P httpd_unified 1</code>
* В более ранних версиях этого расширения Windows иногда выдавал ошибку _Py_HashRandomization_Init. Это была [[phab:T300223|ошибка]], когда среда Windows не передавалась в выполнение Python. Исправление было выпущено в версии 1.40 с бэкпортами на версии 1.38 и 1.39.

<span id="VisualEditor_integration"></span>
=== Интеграция с VisualEditor ===
Плагин позволяет прямое редактирование с помощью [[Special:MyLanguage/Extension:VisualEditor|VisualEditor]].
Всплывающее окно открывается, когда пользователь хочет редактировать <code>syntaxhighlight</code> секции.
Чтобы это работало, VisualEditor должен быть установлен и настроен с последней версии git, такой же для Parsoid.
Функция случайным образом не работает со старыми версиями Parsoid.
Для более подробной информации смотрите {{ll|Extension:SyntaxHighlight/VisualEditor}}

<span id="Advanced"></span>
== Дополнительно ==
В отличие от тегов {{tag|pre|open}} и {{tag|code|open}}, символьные сущности HTML, такие как <code>&amp;nbsp;</code>, не имеют (и не должны) экранироваться символом <code>&</code> как <code>&amp;amp;</code>.
Подобно тегу {{tag|pre|open}}, но, в отличие от тега {{tag|code|open}}, теги в пределах диапазона (кроме собственного закрывающего тега) не должны иметь экранированный символ <code><</code> как <code>&amp;lt;</code>, а также не нужно экранировать викитекст тегом {{tag|nowiki|open}}.

Кроме того, в то время как {{tag|pre|open}} предполагает, что табуляция останавливается каждые 8 символов и отображает вкладки с использованием фактических пробелов при копировании текста, {{tag|syntaxhighlight|open}} использует четырехпозиционные табуляции (кроме Internet Explorer, который использует 8) и сохраняет символы табуляции в визуализированном тексте ; последний может быть изменен с помощью охватывающего тега {{tag|span|open|params={{attr|style|"-moz-tab-size: {{var|nn}}; -o-tab-size: {{var|nn}}; tab-size: {{var|nn}};"}} }} (не {{tag|div|open}}, и не используя собственный атрибут <code class="mw-highlight">{{attr|style}}</code>).
Префикс <code>-moz-</code> требуется для Firefox (для версий с 4.0 по 90), а префикс <code>-o-</code> требуется для Opera (для версий с 10.60 по 15).<ref>[[devmo:Web/CSS/tab-size]]</ref>
(Обратите внимание, что в окне редактирования вики предполагаются 8-пробельные табуляции.)
Это относится только к сохранённым страницам; превью, сгенерированные в окне редактирования, или [[Special:ExpandTemplates]] имеют отличия.

<span id="See_also"></span>
== См. также ==

* [https://pygments.org/ Pygments — Python syntax highlighter]
* Расширения, зависящие от этого:
** {{ll|Extension:SyntaxHighlightPages}} — выделяет страницы на основе суффиксов заголовков.
* Альтернативные расширения:
** {{ll|Extension:Highlightjs Integration}} — расширение синтаксической подсветки, которое использует библиотеку HighlightJS (поддерживает некоторые языки которые Pygments не поддерживает, например Maxima)
** {{ll|Extension:GoogleCodePrettify}} — расширение синтаксической подсветки, которое использует библиотеку Google Prettify.
** {{ll|Extension:ExternalContent}} — <span lang="en" dir="ltr" class="mw-content-ltr">embed external content, such as code from GitHub, GitLab, and Bitkeeper repos with automatic rendering of Markdown files; and using syntax highlighting via the Prism.js library for nearly 300 supported languages. Content indexed by CirrusSearch</span>


<span id="Footnotes"></span>
== Примечания ==
<references />

{{OnWikimedia}}
{{Used by}}

[[Category:Syntax highlighting extensions{{#translation:}}]]
[[Category:GeSHi extensions{{#translation:}}]]
[[Category:Extensions with VisualEditor support{{#translation:}}]]