內容簡介
WP-Syntax 提供乾淨的語法突顯，使用 GeSHi，支援多種流行的語言，包括有或沒有行號的語法突顯，可以在從瀏覽器中複製程式碼片段時保持格式。
它通過運行早期的前置過濾器和後期的後置過濾器來避免與其他第三方外掛程序的衝突，先替換和提取代碼片段，然後在最後推回並加上突顯。結果是源代碼的格式和突顯方式都和預期的一樣。
使用、支援的語言、樣式指南和版本信息都可以在「其他說明」部分中獲得。
想貢獻？WP-Syntax 可以在 GitHub 上找到，現在就派生並提交拉取請求吧！
基本用法
將代碼區塊用 <pre lang="LANGUAGE" line="1"> 和 </pre> 包裹起來，其中 LANGUAGE 為 GeSHi 支持的語言語法。
line 屬性是可選的。欲知更多用法範例，請參閱其他說明。
用法
將代碼區塊用 <pre lang="LANGUAGE" line="1"> 和 </pre> 包裹起來，其中 LANGUAGE 為 GeSHi 支持的語言語法。下面是支援的語言列表。
line 屬性是可選的。
範例 1: PHP，無行號
<pre lang="php">
<div id="foo">
<?php
function foo() {
echo "Hello World!\\n";
}
?>
</div>
</pre>
範例 2: Java，行號
<pre lang="java" line="1">
public class Hello {
public static void main(String[] args) {
System.out.println("Hello World!");
}
}
</pre>
範例 3: Ruby，從第 18 行開始顯示行號
<pre lang="ruby" line="18">
class Example
def example(arg1)
return "Hello: " + arg1.to_s
end
end
</pre>
範例 4: 如果你的代碼已經轉義了 HTML 實體，請使用 escaped="true" 作為選項
<pre lang="xml" escaped="true">
<xml>Hello</xml>
</pre>
範例 5: PHP，帶行號和突顯特定行
<pre lang="php" line="1" highlight="3">
<div id="foo">
<?php
function foo() {
echo "Hello World!\\n";
}
?>
</div>
</pre>
範例 6: PHP，帶標題（源文件或源文件的文件路徑）
<pre lang="php" src"https://github.com/shazahm1/Connections/blob/master/connections.php">
<div id="foo">
<?php
function foo() {
echo "Hello World!\\n";
}
?>
</div>
</pre><h3>支援的語言</h3>
以下是 lang 屬性中支援的主要語言列表：
abap、actionscript、actionscript3、ada、apache、applescript、apt_sources、asm、asp、autoit、avisynth、bash、bf、bibtex、blitzbasic、bnf、boo、c、c_mac、ca...
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
WP-Syntax provides clean syntax highlighting using
GeSHi — supporting a wide range of popular
languages. It supports highlighting with or without line numbers and maintains formatting while copying snippets of code
from the browser.
It avoids conflicts with other 3rd party plugins by running an early
pre-filter and a late post-filter that substitutes and pulls the code snippets
out first and then pushes them back in with highlighting at the end. The
result is source code formatted and highlighted the way you intended.
Usage, Supported Languages, Styling Guidelines, and Release Notes are available
in the Other Notes section.
Want to contribute? WP-Syntax can be found on GitHub. Fork and submit your pull requests today!
Basic Usage
Wrap code blocks with
and
where “LANGUAGE”
is a GeSHi supported language syntax.
The line attribute is optional. More usage examples
Usage
Wrap code blocks with
and
where “LANGUAGE” is a GeSHi supported
language syntax. See below for a full list of supported languages.
The line attribute is optional.
Example 1: PHP, no line numbers
Example 2: Java, with line numbers
public class Hello {
public static void main(String[] args) {
System.out.println("Hello World!");
}
}
Example 3: Ruby, with line numbers starting at 18
class Example
def example(arg1)
return "Hello: " + arg1.to_s
end
end
Example 4: If your code already has html entities escaped, use escaped="true" as an option
<xml>Hello</xml>
Example 5: PHP, with line numbers and highlighting a specific line
Example 6: PHP, with a caption (file and/or file path of the source file)
Supported Languages
The following languages are most supported in the lang attribute:
abap, actionscript, actionscript3, ada, apache, applescript, apt_sources, asm,
asp, autoit, avisynth, bash, bf, bibtex, blitzbasic, bnf, boo, c,
c_mac, caddcl, cadlisp, cil, cfdg, cfm, cmake, cobol, cpp-qt, cpp,
csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang,
fo, fortran, freebasic, genero, gettext, glsl, gml, bnuplot, groovy, haskell,
hq9plus, html4strict, idl, ini, inno, intercal, io, java, java5,
javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode
lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc,
modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml-brief, ocaml,
oobas, oracle11, oracle8, pascal, per, pic16, pixelbender, perl,
php-brief, php, plsql, povray, powershell, progress, prolog, properties,
providex, python, qbasic, rails, rebol, reg, robots, ruby, sas,
scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm,
text, thinbasic, tsql, typoscript, vb, vbnet, verilog, vhdl, vim,
visualfoxpro, visualprolog, whitespace, whois, winbatch, xml, xorg_conf,
xpp, z80
See the GeSHi Documentation
for a full list of supported languages.
(Bold languages just highlight the more popular ones.)
Styling Guidelines
WP-Syntax colors code using the default GeSHi colors. It also uses inline
styling to make sure that code highlights still work in RSS feeds. It uses a
default wp-syntax.css stylesheet for basic layout. To customize your styling,
copy the default wp-content/plugins/wp-syntax/wp-syntax.css to your theme’s
template directory and modify it. If a file named wp-syntax.css exists in
your theme’s template directory, this stylesheet is used instead of the default.
This allows theme authors to add their own customizations as they see fit.
Advanced Customization
WP-Syntax supports a wp_syntax_init_geshi action hook to customize GeSHi
initialization settings. Blog owners can handle the hook in a hand-made plugin
or somewhere else like this:
set_brackets_style('color: #000;');
$geshi->set_keyword_group_style(1, 'color: #22f;');
}
?>
This allows for a great possibility of different customizations. Be sure to
review the GeSHi Documentation.
