這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

WP-Markdown-SyntaxHighlighter

外掛說明

WP-Markdown-SyntaxHighlighter is intended to work with the wp-markdown and SyntaxHighlighter Evolved plugins as follows:

  • WP-Markdown can automatically use Prettify.js to format code, but if you prefer Alex Gorbatchev’s SyntaxHighlighter, this plugin will re-format the Markdown-formatted code blocks to be properly styled by SyntaxHighlighter directly or SyntaxHighlighter Evolved via plugin.
  • SyntaxHighlighter Evolved uses SyntaxHighlighter and additional extended functionality to display code blocks in an easily readable manner.

There are two methods of use:

  1. Add a #! line to your code example and specify the language (brush) only
  2. Add a #!! line to your code example and specify any/all supported parameters via a JSON object

Simple Method

To use, add a #! line as the first line of your code example with the language you are using:

#!ruby
class Foo < Bar
  def hello
    puts "Hello World!"
  end
end

The #! is removed, and the code is reformatted as:

<pre class="brush:ruby; notranslate" title="">class One < Two
  def hello
    puts "Hello World!"
  end
end</pre>

Full Method

To use, add a #!! line as the first line of your code example, with any of the supported SyntaxHighlighter parameters as a JSON object

#!!{"brush":"ruby","toolbar":"true","highlight":"[2,3,4]"}
class Foo < Bar
  def hello
    puts "Hello World!"
  end
end

The #!! is removed, and the parameters are interpreted into a CSS class string as:

<pre class="brush: ruby; toolbar: true; highlight: [2,3,4]; notranslate">class Foo < Bar
  def hello
    puts "Hello World!"
  end
end</pre>

TODO

  • Consider adding support to toggle ‘notranslate’

安裝方式

  1. Upload the wp-markdown-syntaxhighlighter folder (and its contents) to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Modify improperly formatted code blocks with your chosen #! or #!! formatting.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈WP-Markdown-SyntaxHighlighter〉的開發相關工作。

參與者

將〈WP-Markdown-SyntaxHighlighter〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

0.4

  • Switched from preg_replace() to preg_replace_callback for ()
  • Removed some potentially harmful formatting code
  • Hat tip to Richard Cyrus for suggesting these changes

0.3.1

  • Updated licensing to GPL 2 in order to post in WP plugin directory
  • Cleaned up some comments, code formatting

0.3

  • Fixed case where both syntaxes could not be used in a single post
  • Added support for the title parameter (default: empty)

0.2.1

  • Refactored strings to constants
  • Fixed a typo

0.2

  • Added #!! syntax to support extended parameters from JSON string
  • Added support for the following parameters:
    • auto-links (default: true)
    • class-name (default: ”)
    • collapse (default: false)
    • first-line (default: 1)
    • gutter (default: true)
    • highlight (default: null, format is a number or array of numbers)
    • html-script (default: false)
    • ruler (default: false)
    • smart-tabs (default: true)
    • title (default: null) NOTE: This does not set the title attribute on the <pre> tag yet.
    • tab-size (default: 4)
    • toolbar (default: true)

0.1

  • Initial release