Allows you to make pull-quotes without duplicating content. If the plugin is disabled the pull-quotes disappear seamlessly.
NOTE: If you would like to have a "Pull-quotes" button in the post editor, I highly recommend Frank Bueltge's Add Quicktags plugin. I've included in my plugin (in the "extras" folder) a settings file that you can import into "Add Quicktags" (though it isn't hard to do it manually).
To make a pull-quote:
Just wrap the text you want to put in a pull-quote like this:
All you need to do is
<span class="pullquote">wrap the quotable text in a span element and give it the class name "pullquote"
(optional) If you want a pull-quote that has text different than the text in the
<span>, put it inside
<!-- an HTML comment --> like so:
<span class="pullquote"><!-- This sentence should be a pull-quote -->This sentence, without this middle clause, should be a pull-quote`.
The content inside the HTML comment will only show up as the pull-quote -- it will not appear at all in the main flow of text.
(optional) To specify a side for a particular pull-quote, give the ` a secondary class of either pqLeft or pqRight (that's case-sensitive!), like so:
<span class="pullquote pqRight">This will appear on the right` no matter what the Settings screen says.
A little known "gotcha" with HTML quotes is that technically speaking you are not allowed to put a double-dash ("--") inside a comment, except as part of the beginning and end markers. (A double-dash technically ends an HTML comment.) In some browsers I have seen this expose comment data as page text. This is part of the official HTML spec and not a "bug" per se in this plugin.
BUG: WordPress does weird things if you try to put HTML tags inside an HTML comment. See http://core.trac.wordpress.org/ticket/8912 for more info. This may be fixed in WP 3.3.
BUG: HTML entities (e.g. accented characters) inside HTML comments get messed up. I believe this is a WordPress bug related to the above bug.