` with class-attributes and a css-file
are used for styling
* optionally add a heading for every code-block
* optionally specify line-number offset (BREAKS XHTML COMPLIANCE)
* optionally don’t display line-numbers
* set per-codeblock if the code is html_entity_encoded or not
* only parses ``-tags with the `lang=`-attribute, thus does not interfere
with any regular preformatted contents you might have
* degrades beautifully through ``-tags (if you keep the sources clean, that
is)
* all settings through logical, valid arguments for the main container
* comes with generic cross-browser CSS (tested: IE5.5+, FF, Safari, Opera)
#### Version History
* 1.3: Thanks to a tipp now the link-path to the stylesheets is correct, sorry
for the inconvenience
* 1.2: Leading whitespace isn’t stripped anymore (indents as well as newlines),
when there’s no title the title-div is not being generated anymore
* 1.1: Solved the issue with single-quotes being changed to typographical quotes
#### Known Issues
While the plugin is basically XHTML 1.0 Strict compliant there’s just no way of
getting the offset-based line-numbering to display without inadequate (ab)use of
javascript and css hacks, so be warned that _IF you use the line-number offset,
your documents will **NOT** validate_ because of the forbidden `start=`-attribute
for the ``!
### Documentation
More on the [Highlight Source Pro Page](http://blog.kno.at/tools/highlight-source-pro/)
## 屏幕截图
* [[
* All-In-One Preview
## 安装
The plugin is simple to install:
1. Upload the `highlight_source_pro` folder to your `/wp-content/plugins` directory
2. Enable via Admin-Interface
#### How to Use
Set your code-blocks as ``-tags. If the language is supported by GeSHi (see
file list in the `/geshi-directory`) use the filename (without extension) as language-
attribute. If your code is encoded (html-entities; e.g. `<` is displayed as `<`–
most likely the case if you write in the visual editor) add the `enc__`-prefix.
For example for a php-codeblock you would start as follows:
```
```
You can control various things:
* Start of Line-Offset, e.g. for #17: `` * define entity-encoded blocks, e.g. for php: `` *
Define a title for your code-block that appears inside the block, but above the
code lines. Everything in the same line as the opening `` tag will be considered
the title, including HTML works fine:
```
This is an example with a headline
```
* disable line numbers by not specifying an offset
* combine all those things as
long as you stick to the right order:
## 常见问题
I use Self-Formatted Markup in older posts, what’s gonna happen?
As long as they aren’t wrapped in ``-tags _with a `lang=`-attribute_ nothing
is going to happen – your markup will stay untouched. Highlight Source Pro only
hooks in for those ``-tags having a `lang=`-attribute.
What about that class-abuse for line numbering???
The line-numbering is the one problem here, because – currently – it requires to
break with the XHTML-Standard. Because the `` is always and guaranteed inside
a `` with the `.geshi`-class there is no need for the `class`-attribute on
the list element. Also due to the fact that a CSS-classname is not allowed to start
with a number, this solution is valid XHTML for downgrading and _can never interfere
with existing CSS-rules_.
I can use all HTML for the title-line?
Yep. The basic idea is, once again, backwards compatibility. If you consider your
code-blocks being important you’ll most likely want to add a heading instead of
just a line, on the other hand you can simply use the title-feature to show which
file is being talked about. Since the title-string will be placed inside a `
` you’ll be fine as long as there’s no line-break (and your markup is valid)
What about that html_entity_decode thing and the enc__ – prefix??
There’s two ways of handling code-listing in your original post source. You can
either use the HTML-input and hardcode PHP, C or whatever you think about, statements
in there, Highlight Source Pro will handle those listings without any problems (
in fact, it’s the safer version to use for Highlighting as all characters are present
in their original form).
On the other hand this will get problematic if – for any reason – you stop using
Highlight Source Pro, because WordPress (and every other serious software) will
strip lots of those listings for security and compatibility reasons. If you want
to be sure that your listings don’t break when moving to another platform you should
consider using htmlentities() on your listings, or writing them with the Visual
Editor in the first place, so when falling back everything will be displayed as
you want.
In this case you’ll have to use the `enc__`-prefix to tell Highlight Source Pro
to apply `html_entity_decode()` before the actual syntax-highlighting. While this
might be the more _default_ case it’s still the one requiring the alteration with
the prefix, for compatibility reasons. If encoded scripts would be marked with the
original language-signature and the source would later on be used in another GeSHi-
environment things would get very, very complicated and confusing.
## 评价
此插件暂无评价。
## 贡献者及开发者
「Highlight Source Pro」是开源软件。 以下人员对此插件做出了贡献。
贡献者
* [ kno ](https://profiles.wordpress.org/kno/)
[帮助将「Highlight Source Pro」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/highlight-source-pro)
### 对开发感兴趣吗?
您可以[浏览代码](https://plugins.trac.wordpress.org/browser/highlight-source-pro/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/highlight-source-pro/)，或通过[RSS](https://plugins.trac.wordpress.org/log/highlight-source-pro/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/highlight-source-pro/)。
## 额外信息
* 版本 **1.3**
* 最后更新：**18 年前**
* 活跃安装数量 **30+**
* WordPress 版本 ** 2.3 或更高版本 **
* 已测试的最高版本为 **2.5**
* 语言
* [English (US)](https://wordpress.org/plugins/highlight-source-pro/)
* 标签
* [code](https://cn.wordpress.org/plugins/tags/code/)[Highlight](https://cn.wordpress.org/plugins/tags/highlight/)
[markup](https://cn.wordpress.org/plugins/tags/markup/)[source](https://cn.wordpress.org/plugins/tags/source/)
[syntax](https://cn.wordpress.org/plugins/tags/syntax/)
* [高级视图](https://cn.wordpress.org/plugins/highlight-source-pro/advanced/)
## 评级
尚未提交反馈。
[Your review](https://wordpress.org/support/plugin/highlight-source-pro/reviews/#new-post)
[查看全部评论](https://wordpress.org/support/plugin/highlight-source-pro/reviews/)
## 贡献者
* [ kno ](https://profiles.wordpress.org/kno/)
## 支持
有话要说吗？是否需要帮助？
[查看支持论坛](https://wordpress.org/support/plugin/highlight-source-pro/)
## 捐助
您愿意支持这个插件的发展吗?
[ 捐助此插件 ](http://tinyurl.com/3mjxz2)