Textile Plugin 2.6 released

3 Oct

Note: A newer version is available. Please see the category page for the latest.

Another release of Textile by Dean Allen in his blogging tool TextPattern 4.0 has prompted me to make another release of my pluing based on his work. This release is so much better than the last couple, that I really want to just call it Textile 3. I won’t though, because that would confuse everyone, including me.

At any rate, this release improves block handling, and the ‘notextile’ tag (or double equals) actually works as advertised ( *check out* this "textile":1 code that was _not_ converted! ). Actually, that example brings us to another new feature: You can move the URLs out of your code, (even for images) and refer to them by number.

This release is also a lot better about not screwing up when you insert html into your posts, so this, for instance was done with a pair of <b> tags instead of textile markup. That means that comments don’t get messed up, and there should be any problem, for instance, with the adwords plugin.

There are two versions: Textile 2.6 and Textile 2.6 for beautifiers ... the “for beautifiers” version is what I’m using, it removes Textile’s clean-up of <code> sections, so that I can use GeshiSyntaxColorer …

Just for a cool example of the neat stuff:

The following textile code:

Check out this page for a nice place to test your Textile skills.

The image below shows a photo from my flickr page

[1]http://textism.com/tools/textile/index.html
[2]http://flickr.com/photos/jaykul/l
[3]http://flickr.com/photos/jaykul/48483236/
[4]http://static.flickr.com/28/48483236_f9d5d11b99_m.jpg

Would reproduce like this:

Check out this page for a nice place to test your Textile skills.

The image below shows a photo from my flickr page

By Joel 'Jaykul' Bennett
Tagged as:

Viewing 42 Comments

Patrick Lawrence 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Hello,

I installed your textile 2.6 plugin and like it so far. However, I've got a problem with inserting Amazon images. I've got a code snipet like this:

!1!:2 [1] http://images.amazon.com/images/P/B000AJJNFE.01... [2] http://www.amazon.com/gp/redirect.html..blah..b...> < < snip >> The result is that the serial number in the first link gets screwed up by textile and turned into an < em > block, and nothing works after that. In your Flickr example, I would expect the same behavior with the underscores becoming blocks. Got any idea what's going on?

reply edit reblog flag

http://patsoffice.com/

Jaykul 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Well, the simplest answer to Patrick's problem is to change the _ to a &#95; which textile will pretty much ignore, but which will render properly in the image.

The complicated answer is that you should go to http://textism.com/tools/textile/ and post a bug to Dean ;)

reply edit reblog flag

http://www.HuddledMasses.org

asd 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

textile2.6 cannot supoort chinese character
when i put star around chinese word(ex: *a?????* )
it has no effect

reply edit reblog flag

Kerim Friedman 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

This plugin produces invalid HTML when used with blockquote, as discussed in this WordPress Support Forum thread. Basically, it should not wrap the tag inside tags, since it ends up overlapping tags if there are multiple paragraphs inside the blockquote. You end up with: !!! It would be great if this could be fixed, since some people on a group blog I manage depend on your plugin!

reply edit reblog flag

http://keywords.oxus.net/

Kerim Friedman 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Ugh. That didn't come out right:

No This plugin produces invalid HTML when used with blockquote, as discussed inthis WordPress Support Forum thread:

http://wordpress.org/support/topic/19587

Basically, it should not wrap the blockquote tag inside p tags, since it ends up overlapping tags if there are multiple paragraphs inside the blockquote. You end up with: p-blockquote-/p!!! It would be great if this could be fixed, since some people on a group blog I manage depend on your plugin!

reply edit reblog flag

http://keywords.oxus.net/

Jaykul 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

If you're using textile ... you should be using "bq. " at the begginning of the line for blockquotes, not the @blockquote@ tag ...

You *can* use xhtml while using textile, but you need to take into account that you *are* using textile. Which is to say: if you leave a blank line, textile is going to start a new paragraph for you, unless you're in a @notextile@ block -- which does weird things converting everything to code blocks-- so to accommodate the fact that your are using textile, you need to put a leading space on the line if you're starting a block-level xhtml tag after blank lines ... or use textile markup.

bq. For example, this blockquote was put in using the bq. textile markup.
It breaks on lines like a @pre@ section, but you can use XHTML inside it, or the usual textile markup.

Now, here's some normal text, and we'll break for a new paragraph.

Lastly, I've got a simple @blockquote@ tag with a space in front of it ...

This is that simple @blockquote@ tag with a space in front of it that they mentioned in the "textpattern wiki":http://textpattern.net/wiki/index.php?title=Troubleshooting_Common_XHTML_Validation_Issues_in_a_Textpattern_Site#Block_Elements_Wrapped_by_Paragraph_Elements.
Again, you can use textile markup or XHTML...

So, I guess I'm not sure what else to say.

reply edit reblog flag

http://www.HuddledMasses.org

Clemens 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

as far as i can see, textile2.6beauty breaks the more-teaser-separator by enclosing it in del-tags. probably breaks other html comments, too. in the preq in function span (line 508 in my version), i replaced
($f)
with
(?<!<!-)($f)

reply edit reblog flag

Jaykul 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Hmm... it should leave html alone, I'll have to check that one out.

reply edit reblog flag

http://www.HuddledMasses.org

Nick Curry 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

it seems the img tag gets garbled if an alignement = indicator is added. To fix, replace image and fImage functions with the following:

// -------------------------------------------------------------
function image($text)
{
return preg_replace_callback("/
\! # opening !
#REPLACE THIS
#(\)?
#WITH THIS:
($this->hlgn) # optional alignment atts
($this->c) # optional style,class atts
(?:\. )? # optional dot-space
([^\s(!]+) # presume this is the src
\s? # optional space
(?:$([^$]+)\))? # optional title
\! # closing
(?::(\S+))? # optional href
(?=\s|$) # lookahead: space or end of string
/Ux", array(&$this, "fImage"), $text);
}

// -------------------------------------------------------------
function fImage($m)
{
//$this->dump($m);

list(, $algn, $atts, $url) = $m;
$atts = $this->pba($atts);
/*
REPLACE THIS
$atts .= ($algn != '') ? ' align="' . $this->iAlign($algn) . '"' : '';
WITH THIS:
*/
$atts .= (isset($m[1])) ? ' align="' . $this->iAlign($m[1]) . '"' : 'ALIGNNOTFOUND-m0='.$m[1];

$atts .= (isset($m[4])) ? ' title="' . $m[4] . '"' : '';
$atts .= (isset($m[4])) ? ' alt="' . $m[4] . '"' : ' alt=""';
$size = @getimagesize($url);
if ($size) $atts .= " $size[3]";

$href = (isset($m[5])) ? $this->checkRefs($m[5]) : '';
$url = $this->checkRefs($url);
$out = array(
($href) ? '' : '',
'',
($href) ? '' : ''
);

return join('',$out);
}

// -------------------------------------------------------------

I hope this helps...

reply edit reblog flag

Nick Curry 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

hmmm, looks like the textile plugin garbled the above... the important bits are

#REPLACE THIS
#(\)?
#WITH THIS:

and

/*
REPLACE THIS
==$atts .= ($algn != a??a??) ? a?? align=a??a?? . $this->iAlign($algn) . a??a??a?? : a??a??;==
WITH THIS:

*/
==$atts .= (isset($m[1])) ? ' align="' . $this->iAlign($m[1]) . '"' : '';==

reply edit reblog flag

Michael 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Great plugin. I have been using it for a couple of weeks, and now I can't live without it. Keep up the good work :-)

reply edit reblog flag

http://www.noentry.org

Jim Jeffers 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Hey, when I use the 2.6b.php file the geshi code still gets turned into html. Any advice? Checkout "my page":http://www.donttrustthisguy.com/2005/12/29/transition-to-dreamhost/ to see what I mean.

reply edit reblog flag

http://www.donttrustthisguy.com

Jaykul 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

The trick is the priority you assign to the plugins... for instance, if you look at my "geshi plugin":http://www.huddledmasses.org/wp-content/plugins/source.php?file=geshi_plugin.php, you'll see I have it set to priority 5 (the priority is the last number in the @add_filter('the_content', 'GeshiSyntaxColorer', 5);@ command at the bottom of the file. And if you check my "textile 2.6":http://www.huddledmasses.org/wp-content/plugins/source.php?file=textile2.6b.php plugin, you'll see that I've set it to priority 6. This way seems to work for me ;)

reply edit reblog flag

http://www.HuddledMasses.org

Kyle Rove 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

I have found that punctuation after an abbreviation (i.e. ... USA(United States of America), ... rest of my sentence) does not properly convert the textile markup to the abbr html element. Any possibility of fixing this?

reply edit reblog flag

http://www.sensoryoutput.com/

Kyle Rove 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

never mind.... I guess it does here... :-p

reply edit reblog flag

http://www.sensoryoutput.com/

Paul Pehrson 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

I'm wondering if in a future release you might consider allowing people to turn this off in WordPress on a post-by-post basis. Maybe there could be a custom field or something that allows you to turn off Textile for a specific post.

I'm having trouble with WP2.0 putting double spaces between lines because I'm using the WP2.0 rich text editor. Is there something I should be doing to make it work with WP2.0?

reply edit reblog flag

http://blog.paulpehrson.com

Jaykul 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

There's a "TextControl plugin":http://dev.wp-plugins.org/wiki/TextControl that allows switching post-processors per-post ... I'm not really planning on supporting that here ... Honestly, if you're using the rich-text editor, I don't see any reason to use Textile on those posts, and I'm frankly rather frustrated with Matt and the WordPress team for putting the rich text editor in as default even though people are using Textile and Markdown and others -- and can't disable them, because the original WordPress design for these plugins was that they should leave the unprocessed text in the database.

reply edit reblog flag

http://www.HuddledMasses.org

Jeremy 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Great plugin, I love it!!!

I'm trying to push it a little further, to use it in titles and meta fields, and here's where I'm running into a problem:

Is there a way to keep Textile from adding p tags when the content is only one line long? Then I can hard-code a field to be a header, for example, without getting a nested p tag...

Any help you could offer would be appreciated.

Thanks!
-Jeremy

reply edit reblog flag

Arne 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

hi there,

is there any chance to use the plugin without harming the function allowed_tags() (used in comments.php to show what html tags are allowed)? whenever i active the textile plugin, it strips away allowed_tags' output.

reply edit reblog flag

http://www.mfkne.de

Arne 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

and another problem here... the contact form plugin doesnt work, also because of textile. isnt there a notextile-tag like in txp?

reply edit reblog flag

http://www.mfkne.de

Jaykul 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

Jeremy: That's a good question. I'm not 100% sure if this will do what you want, but you can try using the 'lite' version... You will see on lines 992-995 the function @textile@ which calls @TextileThis@, and passes only one parameter. Make yourself a copy, call it @textileLite@ and change the call to @return $textile->TextileThis($string, true);@ ... then, in your @add_filter@ calls, use @textileLite@ instead of @textile@.

Arne: Look at the bottom of the file. Line 1008.
Arne: Contact form plugin? It must be (inappropriately) calling a filter for 'the_content', 'the_excerpt', or 'comment_text' ...

reply edit reblog flag

http://www.HuddledMasses.org

Arne 2 years ago 1 point
Please login to rate.

Do you already have an account? Log in and claim this comment.

thx, commenting out these two lines did it for me :-)
@contact form plugin: well, i dont know anything about wp's plugin structure, so i dont know in which way i could change the plugin. i only can see that you're right: it's calling a filter for "the_content".

thats the plugin: http://johannesries.de/webwork/contactform/

reply edit reblog flag

http://www.mfkne.de

Huddled Masses

You can do more than breathe for free…

Similar Posts

Recent Posts

In-Page Navigation [+]

Textile Plugin 2.6 released

The following textile code:

Would reproduce like this:

Add New Comment

Viewing 42 Comments