描述
WP-Syntax使用
GeSHi提供干净的语法高亮– 支持各种流行
语言。它支持带或不带行号的突出显示,并在
从浏览器复制代码片段时保持格式。
它通过运行早期
预过滤器和后期过滤器来避免与其他第三方插件的冲突,后置过滤器首先替换并拉出代码片段
,然后在最后突出显示它们。该
结果是源代码格式,并强调你希望的方式。
“ 其他注释”部分提供了“使用”,“支持的语言”,“样式指南”和“发行说明” 。
想贡献?WP-Sytax可以在Github上找到。今天就提交您的拉动请求!
基本用法
总结代码块与<pre lang="LANGUAGE" line="1">
和</pre>
其中“语言”
是一种称作GeSHi支持的语言的语法。
该line
属性是可选的。更多用法示例
用法
总结代码块与<pre lang="LANGUAGE" line="1">
和</pre>
其中“语言”是一种称作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>Supported Languages</h3>
lang
属性中最支持以下语言:
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
有关
支持的语言的完整列表,请参阅GeSHi文档
。
(大胆的语言只是突出了更受欢迎的语言。)
造型指南
WP-Syntax使用默认的GeSHi颜色为代码着色。它还使用内联
样式来确保代码突出显示仍然可以在RSS源中使用。它使用
默认wp-syntax.css
样式表进行基本布局。要自定义样式,
请将默认值复制wp-content/plugins/wp-syntax/wp-syntax.css
到主题的
模板目录并进行修改。如果
主题的模板目录中wp-syntax.css
存在名为的文件
,则使用此样式表而不是默认值。
这允许主题作者在他们认为合适时添加他们自己的自定义。
高级定制
WP-Syntax支持wp_syntax_init_geshi
动作挂钩来自定义GeSHi
初始化设置。博客所有者可以在手工制作的插件
或其他地方处理钩子:
<?php
add_action('wp_syntax_init_geshi', 'my_custom_geshi_styles');
function my_custom_geshi_styles(&$geshi)
{
$geshi->set_brackets_style('color: #000;');
$geshi->set_keyword_group_style(1, 'color: #22f;');
}
?>
这允许不同自定义的很大可能性。请务必
查看GeSHi文档。
文章评论 (0)