=== WP SyntaxHighlighter ===
Contributors: redcocker
Donate link: http://www.near-mint.com/blog/donate/
Tags: syntaxhighlighter, code, snippet, syntax, highlight, highlighting
Requires at least: 3.0
Tested up to: 3.1.3
Stable tag: 1.3

This plugin is code syntax highlighter based on SyntaxHighlighter ver. 3.0.83 and 2.1.382.

== Description ==

This plugin is code syntax highlighter based on SyntaxHighlighter ver. 3.0.83 and 2.1.382.

= Feature =

* Based on "[SyntaxHighlighter](http://alexgorbatchev.com/SyntaxHighlighter/ "JavaScript library")" JavaScript library.
* Including ver. 3.0.83 and 2.1.382 libraries.
* You can operate in Visual Editor, No need to use HTML Editor.
* Easy wrap your code in `<pre>` tag by two ways and change language and options of previously-markuped code.
* Once your code is wrapped in `<pre>` tag, You can type 'tabs' for indent.
* Easy to configure through setting panel.
* Support "[Dynamic Brush Loading](http://alexgorbatchev.com/SyntaxHighlighter/manual/api/autoloader.html "A key feature")" which allows to load only necessary brush files dynamically.
* Loading JavaScripts on only Posts and Pages which have code to highlight.
* Translated into English(Default) and Japanese(UTF-8).

= Supported languages =

AppleScript, ActionScript3, Bash, ColdFusion, C, C++, C#, CSS, Delphi, Diff, Erlang, Groovy, HTML, Java, Java FX, JavaScript, Pascal, Patch, Perl, PHP, Plain text, PowerShell, Python, Ruby, Ruby on Rails, Sass, SCSS, Shell, SQL, VB, VB NET, XHTML, XML and XSLT

= Recommended plugin =

In Ver. 1.1 or higher, "SH TinyMCE Button" was built into "WP SyntaxHighlighter".

However, If you want, you can use the feature-rich "[SyntaxHighlighter TinyMCE Button](http://wordpress.org/extend/plugins/syntaxhighlighter-tinymce-button/ "Recommended plugin")".

== Installation ==

= Installation =

1. Upload plugin folder to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. If you need, go to Settings -> WP SyntaxHighlighter to configure.

= Usage =

Usage: To wrap your code in `<pre>` tag with "SH TinyMCE Button".

If you have previously-written code on your post or page, by this way, you can wrap your code in `<pre>` tag for 'SyntaxHighlighter'.

1. With the mouse, select and highlight your code where you want to aplly "SyntaxHighlighter".
1. Click "pre" button.
1. Select language and options.
1. Click "Insert" button.

Usage: To paste your code into the post or page with "SH TinyMCE Button".

If you want to copy the code from the other document and paste into your post or page, this way is best. Your pasted code will be warpped in `<pre>` tag automatically.

1. Click "CODE" button.
1. Select language and options and paste your code into textbox.
1. Click "Insert" button.

Usage: To change language and options of previously-markuped code with "SH TinyMCE Button".

1. With the mouse, select and highlight your code.
1. Click "pre" button.
1. Change language and options.
1. Click "Update" button.

Usage: To indent by tabs.

1. Just type tab in your code. But till your code is wrapped in `<pre>` tag, you can not type any tabs.

Usage: Using HTML Editor without "SH TinyMCE Button".

Just wrap Your Code in `<pre>` tag as below in HTML Editor or using the "Preformatted" style in Visual Editor.

However, your codes **must be escape to HTML entities in HTML Editor**.

`<pre class="brush: lang">Your Code</pre>` *"lang" = your language

* e.g. `<pre class="brush: php">Your PHP Code</pre>`
* e.g. `<pre class="brush: xhtml">Your XHTML Code</pre>`

See "[Available languages](http://alexgorbatchev.com/SyntaxHighlighter/manual/brushes/ "Brushes")". *"Brush aliases" means "lang".

You can also use some options with `<pre>` tag.

See "[Options](http://alexgorbatchev.com/SyntaxHighlighter/manual/configuration/ "Class value")".

* e.g. `<pre class="brush: xhtml; first-line: 10">Your Code</pre>`
* e.g. `<pre class="brush: php; html-script: true">Your Code</pre>`

This plugin also can support `<script>` tag method. However, No one should use `<script>` tag.

= Legacy mode =

You can switch to "Legacy mode" through setting panel.
"Legacy mode" allows you to use the old style tag in ver. 1.5.

See "[Ver. 1.5 Usage](http://code.google.com/p/syntaxhighlighter/wiki/Usage "Old style tag")".

In "Legacy mode", your selected brushes(languages) will be pre-loaded. Only pre-loaded brushes(languages) can highlight your source code with old style tag. The old style tag can't depended on "autoloader" in ver. 3.0 mode. By default, all brushes(languages) will be pre-loaded in "Legacy mode".

"Legacy mode" may save your previous posts with old style tag. However, No one should continue using old style tag. You must use "HTML Editor" to type old style tag, and when switching to "Visual Editor", TinyMCE will destroy your tag.

= For developers =

You can add new languages(brush files) to this plugin using "Action hooks" and associative array.

For details, see "sample" directory.

== Frequently Asked Questions ==

= Q. I want to change language and options of previously-markuped code with "pre" button. But I can't select whole my code. =

A. You need not to select whole your code. It's enough to select first line of your code.

= Q. After the update to new version, Buttons do not work correctly. =

A. Old javascript files may be cached. Please clear your browser's cache or delete cached javascript files.

= Q. "pre" button does not work in fullscreen mode. =

A. In fullscreen mode, You can use "pre" button only for updating language and options.

== Screenshots ==

1. This is a highlighted code.
2. This is setting panel.
3. This is "SH TinyMCE" button.
4. This is pop up window at the click of "pre" button.
5. This is pop up window at the click of "CODE" button.

== Changelog ==

= 1.3 =
* In ver. 2.0 or "Legacy mode", loaded languages become pre-selectable through setting panel.
* "Reset All Setting" button Added to setting panel.
* `<script>` and `<textarea>` tag methods are supported.
* Fix a bug: In "Legacy mode", the source code with old style tag can't be highlighted correctly.

= 1.2.3 =
* Added more language for ver. 2.1.382 by defaut, or this version will load all bundled languages for ver. 2.1.382 by defaut.(added languages are: Actionscript3, Bash shell, ColdFusion, Diff, Erlang, Groovy, JavaFX, Perl, Plain Text, PowerShell,Scala)
* Added "Action hooks" and associative array for developers.
* Fix a bug: When choosen "MDUltra" theme in ver. 2.1, "Your Current Theme" in setting panel can't be updated correctly.

= 1.2.2 =
* To prevent conflict with other TinyMCE button, the priority of a function hooked has been changed.
* Removed an unnecessary file from the file set.

= 1.2.1 =
* Fix a bug: "CODE" button does not work in fullscreen mode.

= 1.2 =
* Added "CODE" button which allows to paste sourcecode into post or page, keeping indent by tab.
* Enable to change language and options of previously-markuped code.
* Button icons has been changed.
* layout of buttons on TinyMCE popup window has been changed.

= 1.1.1 =
* Fix a bug: Sometimes Code do not be highlighted in home.

= 1.1 =
* Adding the button to type `<pre>` tag in Visual Editor.
* You can preview your current theme in setting panel.
* Fix a bug: Setting values in databese can't be removed when uninstall.

= 1.0.1 =
* Fix a warning in setting panel.

= 1.0 =
* This is the initial release.

== Upgrade Notice ==

= 1.3 =
This version has some new features, changes and a bug fix.

= 1.2.2 =
This version has some low-priority changes.

= 1.2.1 =
This version has a bug fix.

= 1.2 =
This version has some new features.

= 1.1.1 =
This version fixes a bug.

= 1.1 =
This version has some new features and a bug fix.

= 1.0.1 =
This version fixes a warning in setting panel.

= 1.0 =
This is the initial release.