查看“帮助:代码高亮工具”的源代码

{{FromOther/CN|site=萌娘百科|originURL=https://zh.moegirl.org.cn/{{FULLPAGENAMEE}}|origin={{FULLPAGENAME}}|copyright=cc|lsubtype=by-nc-sa|lver=3.0|contribURL=https://zh.moegirl.org.cn/index.php?title={{FULLPAGENAMEE}}&action=history}}
{{Gadgets|type=site}}

[[MediaWiki:Gadget-code-prettify.js|Code prettify]]是一个基于JavaScript开发的页面显示工具，可以对页面上的代码进行高亮。您可以在[[Special:参数设置#mw-prefsection-gadgets|参数设置]]中勾选“{{MediaWiki:Gadget-code-prettify}}”启用此工具。

此工具基于Google Code Prettify写成，源地址：https://github.com/googlearchive/code-prettify

== 可用语言列表 ==

=== 自动高亮语言 ===
本工具支持下表左列语言的高亮和自动检测，探测到对应语言的代码块时会自动进行高亮。

{| class="wikitable"
|+ 语言支持情况
! 受支持的语言 !! 对应可用名称
|-
| TypeScript
| <code>ts</code><br/><code>typescript</code>
|-
| JavaScript
| <code>js</code><br/><code>javascript</code>
|-
| JSON
| <code>json</code>
|-
| CSS
| <code>css</code>
|-
| HTML
| <code>htm</code><br/><code>html</code>
|-
| Lua
| <code>scribunto</code><br/><code>lua</code>
|-
| PHP
| <code>php</code>
|-
| Regex
| <code>regex</code>
|-
| LaTeX
| <code>latex</code><br/><code>tex</code>
|-
| Wikitext
| <code>wiki</code><br/><code>wikitext</code><br/><code>mediawiki</code><br/><code>mw</code>
|}

=== 手动高亮语言 ===
本工具支持<code>code-prettify</code>默认支持的其他语言高亮，但不会自动检测语言，需要手动指定语言：
* C系列语言：c, cc, cpp, cxx, cyc, cs
* Java
* Python
* Bash
* SQL
* Perl
* XML
* Ruby
* Makefile
* Rust
* 正则表达式
不在上表的语言也可能能被高亮，但效果不作保证。
== 使用方法 ==
=== 读者侧 ===
您只需要到[[Special:参数设置#mw-prefsection-gadgets|参数设置]]中勾选“{{MediaWiki:Gadget-code-prettify}}”启用本工具即可。

=== 编辑侧 ===
您可以通过以下几种方式编写可被本工具自动检测语言并高亮的代码块：
<ol>
<li>JS、CSS页面等页面内容模型为[[#自动高亮语言]]表中左侧语言之一的页面；</li>
<li>在<code>&lt;pre&gt;</code>、<code>&lt;code&gt;</code>标签里填写<code>lang</code>属性，值需为[[#自动高亮语言]]表中右侧名称之一，不分大小写：
* {{tl|pre}}支持<code>&lt;pre&gt;</code>的语言指定，具体参见模板文档。
</li></ol>
您可以通过以下方式编写可被本工具高亮的代码块，但须手动指定语言：
<ol>
<li value="3">在<code>&lt;pre&gt;</code>、<code>&lt;code&gt;</code>标签里填写<code>class</code>属性，值需为<code>prettyprint lang-【语言名】</code>，语言名要么为[[MediaWiki:Gadget-code-prettify-core.js#L681]]-L739所定义的语言名，要么为该语言的通用名或文件扩展名，不分大小写。</li>
</ol>
通过上述第2、3种方法进行高亮的<code>&lt;pre&gt;</code>元素可在标签里填写<code>data-start</code>属性，值需为正整数，指定代码第一行的行号，若不指定则默认为1。

{{萌娘百科帮助}}