Sorry, here it is again with full stops.
irb(main):007:0> RedCloth.new("p(link). blah").to_html
=> "<p class=\"link\">blah</p>"
irb(main):008:0> RedCloth.new("-- p(link). blah").to_html
=> "<p>—p(link). blah</p>"
Tony Perrie
Engineer, STI Convergence Team, BQQA
11501 Burnet Rd, Building 906/3007C Austin, TX, 78759
Phone: 512-838-1402, T/L: 678-1402
Fax: 512-838-2132
Tom Counsell
<tamc2 at cam.ac.uk>
To
06/13/2006 04:33 Joseph Perrie/Austin/IBM at IBMUS
PM cc
Subject
[Instiki] Problems with RedCloth
Anchor Support
On 13 Jun 2006, at 22:15, Joseph Perrie wrote:> Is this intentional?
>
> r = RedCloth.new("-- --\r\n p(link)")
> => "-- --\r\n p(link)"
> irb(main):014:0> r.to_html
> => "<hr />\n p(#link)"
Try adding a full stop after the p, i.e.: p(link).
Tom
I replicated the alleged bug here: http://instiki.org/show/AnchorBug Tony
Hi Tony, As a point of order: While Instiki folks are certainly interested in RedCloth issues, RedCloth is maintained by a separate team from Instiki. If you have a suspected or confirmed bug, I recommend checking out the RedCloth homepage, with links to the project page, mailing lists, etc.: http://whytheluckystiff.net/ruby/redcloth/ To the specific issue that you cite, I believe that your interpretation of Textile is incorrect in this case. All of the "block modifiers" must begin a paragraph. This is essentially all of the modifiers that end in a period, e.g. "hn.", "p.", "bq.", and so forth. Your example "-- p(link). blah" places the "p." after the start of the paragraph, so it (correctly) isn''t recognized. Possible solutions are to start the paragraph with the "p." marker: p(#link). -- blah which produces: <p id="link">—blah</p> Or alternatively use a Textile span marker: -- %(#link)blah% to get: <p>—<span class="link">blah</span></p> FYI, The above examples were generated via RedCloth 3.0.4. -- John On Jun 13, 2006, at 3:28 PM, Joseph Perrie wrote:> I replicated the alleged bug here: > > http://instiki.org/show/AnchorBug > > Tony > > _______________________________________________ > Instiki-users mailing list > Instiki-users at rubyforge.org > http://rubyforge.org/mailman/listinfo/instiki-users
What do you define as a paragraph in RedCloth? Because in RedCloth also doesn''t support this either: -- p(link). Nor does it support this: <hr> p(link). The quick reference page on hobix, seems to suggest that characters on a line by themself are considered a paragraph. http://hobix.com/textile/quick.html So, I''m fairly confused at this point. What exactly is considered a paragraph to RedCloth? Clearly, this behavior is not obvious to the casual user of Textile (Instiki users?). I personally think it is a bug. I''m looking at the RedCloth source code to try to fix it, but it''s fairly dense code. I''m not blaming anyone, and I''m hoping that this thread will serve as documentation for other users. Also, I emailed _why who I met briefly at SXSWi in March of this year. I will keep the list updated with any response that he has. Finally, I feel that this is an appropriate forum for this discussion because if this software is used by a wider audience these emails serve as documentation for users. This is particularly relevant because RedCloth doesn''t have a mailing list that I can seem to find. Regards, Tony On 6/13/06, John Whitley <whitley at acm.org> wrote:> Hi Tony, > > As a point of order: While Instiki folks are certainly interested in > RedCloth issues, > RedCloth is maintained by a separate team from Instiki. If you have > a suspected or confirmed bug, I recommend checking out the RedCloth > homepage, with links to the project page, mailing > lists, etc.: > http://whytheluckystiff.net/ruby/redcloth/ > > To the specific issue that you cite, I believe that your > interpretation of Textile is > incorrect in this case. All of the "block modifiers" must begin a > paragraph. This is > essentially all of the modifiers that end in a period, e.g. "hn.", > "p.", "bq.", and so forth. > Your example "-- p(link). blah" places the "p." after the start of > the paragraph, so it (correctly) isn''t recognized. > > Possible solutions are to start the paragraph with the "p." marker: > > p(#link). -- blah > > which produces: > > <p id="link">—blah</p> > > Or alternatively use a Textile span marker: > > -- %(#link)blah% > > to get: > > <p>—<span class="link">blah</span></p> > > FYI, The above examples were generated via RedCloth 3.0.4. > > -- John > > On Jun 13, 2006, at 3:28 PM, Joseph Perrie wrote: > > > I replicated the alleged bug here: > > > > http://instiki.org/show/AnchorBug > > > > Tony > > > > _______________________________________________ > > Instiki-users mailing list > > Instiki-users at rubyforge.org > > http://rubyforge.org/mailman/listinfo/instiki-users > > _______________________________________________ > Instiki-users mailing list > Instiki-users at rubyforge.org > http://rubyforge.org/mailman/listinfo/instiki-users >
What do you define as a paragraph in RedCloth? Because in RedCloth also doesn''t support this either: -- p(link). Nor does it support this: <hr> p(link). The quick reference page on hobix, seems to suggest that characters on a line by themself are considered a paragraph. http://hobix.com/textile/quick.html So, I''m fairly confused at this point. What exactly is considered a paragraph to RedCloth? Clearly, this behavior is not obvious to the casual user of Textile (Instiki users?). I personally think it is a bug. I''m looking at the RedCloth source code to try to fix it, but it''s fairly dense code. I''m not blaming anyone, and I''m hoping that this thread will serve as documentation for other users. Also, I emailed _why who I met briefly at SXSWi in March of this year. I will keep the list updated with any response that he has. Finally, I feel that this is an appropriate forum for this discussion because if this software is used by a wider audience these emails serve as documentation for users. This is particularly relevant because RedCloth doesn''t have a mailing list that I can seem to find. Regards, Tony On 6/13/06, John Whitley <whitley at acm.org> wrote:> Hi Tony, > > As a point of order: While Instiki folks are certainly interested in > RedCloth issues, > RedCloth is maintained by a separate team from Instiki. If you have > a suspected or confirmed bug, I recommend checking out the RedCloth > homepage, with links to the project page, mailing > lists, etc.: > http://whytheluckystiff.net/ruby/redcloth/ > > To the specific issue that you cite, I believe that your > interpretation of Textile is > incorrect in this case. All of the "block modifiers" must begin a > paragraph. This is > essentially all of the modifiers that end in a period, e.g. "hn.", > "p.", "bq.", and so forth. > Your example "-- p(link). blah" places the "p." after the start of > the paragraph, so it (correctly) isn''t recognized. > > Possible solutions are to start the paragraph with the "p." marker: > > p(#link). -- blah > > which produces: > > <p id="link">—blah</p> > > Or alternatively use a Textile span marker: > > -- %(#link)blah% > > to get: > > <p>—<span class="link">blah</span></p> > > FYI, The above examples were generated via RedCloth 3.0.4. > > -- John > > On Jun 13, 2006, at 3:28 PM, Joseph Perrie wrote: > > > I replicated the alleged bug here: > > > > http://instiki.org/show/AnchorBug > > > > Tony > > > > _______________________________________________ > > Instiki-users mailing list > > Instiki-users at rubyforge.org > > http://rubyforge.org/mailman/listinfo/instiki-users > > _______________________________________________ > Instiki-users mailing list > Instiki-users at rubyforge.org > http://rubyforge.org/mailman/listinfo/instiki-users >
A paragraph is delineated by a wholly blank line. I agree that Textile documentation (read: spec and tutorial material) needs improvement on this point and many others; this is a convention common to many lightweight markup languages of Textile''s ilk, which is largely how they''ve gotten this far. That said, and having used many markup languages of various uses, I''ve found Textile to be far and away the nicest to actually write in. -- John On Jun 13, 2006, at 5:47 PM, Tony Perrie wrote:> What do you define as a paragraph in RedCloth? Because in RedCloth > also doesn''t support this either: > > -- > p(link). > > Nor does it support this: > > <hr> > p(link). > > The quick reference page on hobix, seems to suggest that characters on > a line by themself are considered a paragraph. > http://hobix.com/textile/quick.html > > So, I''m fairly confused at this point. What exactly is considered a > paragraph to RedCloth? > > Clearly, this behavior is not obvious to the casual user of Textile > (Instiki users?). I personally think it is a bug. I''m looking at the > RedCloth source code to try to fix it, but it''s fairly dense code. > I''m not blaming anyone, and I''m hoping that this thread will serve as > documentation for other users. > > Also, I emailed _why who I met briefly at SXSWi in March of this year. > I will keep the list updated with any response that he has. > > Finally, I feel that this is an appropriate forum for this discussion > because if this software is used by a wider audience these emails > serve as documentation for users. This is particularly relevant > because RedCloth doesn''t have a mailing list that I can seem to find. > > Regards, > > Tony > > On 6/13/06, John Whitley <whitley at acm.org> wrote: >> Hi Tony, >> >> As a point of order: While Instiki folks are certainly interested in >> RedCloth issues, >> RedCloth is maintained by a separate team from Instiki. If you have >> a suspected or confirmed bug, I recommend checking out the RedCloth >> homepage, with links to the project page, mailing >> lists, etc.: >> http://whytheluckystiff.net/ruby/redcloth/ >> >> To the specific issue that you cite, I believe that your >> interpretation of Textile is >> incorrect in this case. All of the "block modifiers" must begin a >> paragraph. This is >> essentially all of the modifiers that end in a period, e.g. "hn.", >> "p.", "bq.", and so forth. >> Your example "-- p(link). blah" places the "p." after the start of >> the paragraph, so it (correctly) isn''t recognized. >> >> Possible solutions are to start the paragraph with the "p." marker: >> >> p(#link). -- blah >> >> which produces: >> >> <p id="link">—blah</p> >> >> Or alternatively use a Textile span marker: >> >> -- %(#link)blah% >> >> to get: >> >> <p>—<span class="link">blah</span></p> >> >> FYI, The above examples were generated via RedCloth 3.0.4. >> >> -- John >> >> On Jun 13, 2006, at 3:28 PM, Joseph Perrie wrote: >> >>> I replicated the alleged bug here: >>> >>> http://instiki.org/show/AnchorBug >>> >>> Tony >>> >>> _______________________________________________ >>> Instiki-users mailing list >>> Instiki-users at rubyforge.org >>> http://rubyforge.org/mailman/listinfo/instiki-users >> >> _______________________________________________ >> Instiki-users mailing list >> Instiki-users at rubyforge.org >> http://rubyforge.org/mailman/listinfo/instiki-users >> > _______________________________________________ > Instiki-users mailing list > Instiki-users at rubyforge.org > http://rubyforge.org/mailman/listinfo/instiki-users
Indeed, I''m an idiot. Thanks for your help. Tony On 6/13/06, John Whitley <whitley at acm.org> wrote:> A paragraph is delineated by a wholly blank line. I agree that > Textile documentation (read: spec and tutorial material) needs > improvement on this point and many others; this is a convention > common to many lightweight markup languages of Textile''s ilk, which > is largely how they''ve gotten this far. > > That said, and having used many markup languages of various uses, > I''ve found Textile to be far and away the nicest to actually write in. > > -- John > > On Jun 13, 2006, at 5:47 PM, Tony Perrie wrote: > > > What do you define as a paragraph in RedCloth? Because in RedCloth > > also doesn''t support this either: > > > > -- > > p(link). > > > > Nor does it support this: > > > > <hr> > > p(link). > > > > The quick reference page on hobix, seems to suggest that characters on > > a line by themself are considered a paragraph. > > http://hobix.com/textile/quick.html > > > > So, I''m fairly confused at this point. What exactly is considered a > > paragraph to RedCloth? > > > > Clearly, this behavior is not obvious to the casual user of Textile > > (Instiki users?). I personally think it is a bug. I''m looking at the > > RedCloth source code to try to fix it, but it''s fairly dense code. > > I''m not blaming anyone, and I''m hoping that this thread will serve as > > documentation for other users. > > > > Also, I emailed _why who I met briefly at SXSWi in March of this year. > > I will keep the list updated with any response that he has. > > > > Finally, I feel that this is an appropriate forum for this discussion > > because if this software is used by a wider audience these emails > > serve as documentation for users. This is particularly relevant > > because RedCloth doesn''t have a mailing list that I can seem to find. > > > > Regards, > > > > Tony > > > > On 6/13/06, John Whitley <whitley at acm.org> wrote: > >> Hi Tony, > >> > >> As a point of order: While Instiki folks are certainly interested in > >> RedCloth issues, > >> RedCloth is maintained by a separate team from Instiki. If you have > >> a suspected or confirmed bug, I recommend checking out the RedCloth > >> homepage, with links to the project page, mailing > >> lists, etc.: > >> http://whytheluckystiff.net/ruby/redcloth/ > >> > >> To the specific issue that you cite, I believe that your > >> interpretation of Textile is > >> incorrect in this case. All of the "block modifiers" must begin a > >> paragraph. This is > >> essentially all of the modifiers that end in a period, e.g. "hn.", > >> "p.", "bq.", and so forth. > >> Your example "-- p(link). blah" places the "p." after the start of > >> the paragraph, so it (correctly) isn''t recognized. > >> > >> Possible solutions are to start the paragraph with the "p." marker: > >> > >> p(#link). -- blah > >> > >> which produces: > >> > >> <p id="link">—blah</p> > >> > >> Or alternatively use a Textile span marker: > >> > >> -- %(#link)blah% > >> > >> to get: > >> > >> <p>—<span class="link">blah</span></p> > >> > >> FYI, The above examples were generated via RedCloth 3.0.4. > >> > >> -- John > >> > >> On Jun 13, 2006, at 3:28 PM, Joseph Perrie wrote: > >> > >>> I replicated the alleged bug here: > >>> > >>> http://instiki.org/show/AnchorBug > >>> > >>> Tony > >>> > >>> _______________________________________________ > >>> Instiki-users mailing list > >>> Instiki-users at rubyforge.org > >>> http://rubyforge.org/mailman/listinfo/instiki-users > >> > >> _______________________________________________ > >> Instiki-users mailing list > >> Instiki-users at rubyforge.org > >> http://rubyforge.org/mailman/listinfo/instiki-users > >> > > _______________________________________________ > > Instiki-users mailing list > > Instiki-users at rubyforge.org > > http://rubyforge.org/mailman/listinfo/instiki-users > > _______________________________________________ > Instiki-users mailing list > Instiki-users at rubyforge.org > http://rubyforge.org/mailman/listinfo/instiki-users >
I gave you props in my blog here. http://involution.com/2006/06/13/redcloth-bug/ Tony On 6/13/06, John Whitley <whitley at acm.org> wrote:> A paragraph is delineated by a wholly blank line. I agree that > Textile documentation (read: spec and tutorial material) needs > improvement on this point and many others; this is a convention > common to many lightweight markup languages of Textile''s ilk, which > is largely how they''ve gotten this far. > > That said, and having used many markup languages of various uses, > I''ve found Textile to be far and away the nicest to actually write in. > > -- John > > On Jun 13, 2006, at 5:47 PM, Tony Perrie wrote: > > > What do you define as a paragraph in RedCloth? Because in RedCloth > > also doesn''t support this either: > > > > -- > > p(link). > > > > Nor does it support this: > > > > <hr> > > p(link). > > > > The quick reference page on hobix, seems to suggest that characters on > > a line by themself are considered a paragraph. > > http://hobix.com/textile/quick.html > > > > So, I''m fairly confused at this point. What exactly is considered a > > paragraph to RedCloth? > > > > Clearly, this behavior is not obvious to the casual user of Textile > > (Instiki users?). I personally think it is a bug. I''m looking at the > > RedCloth source code to try to fix it, but it''s fairly dense code. > > I''m not blaming anyone, and I''m hoping that this thread will serve as > > documentation for other users. > > > > Also, I emailed _why who I met briefly at SXSWi in March of this year. > > I will keep the list updated with any response that he has. > > > > Finally, I feel that this is an appropriate forum for this discussion > > because if this software is used by a wider audience these emails > > serve as documentation for users. This is particularly relevant > > because RedCloth doesn''t have a mailing list that I can seem to find. > > > > Regards, > > > > Tony > > > > On 6/13/06, John Whitley <whitley at acm.org> wrote: > >> Hi Tony, > >> > >> As a point of order: While Instiki folks are certainly interested in > >> RedCloth issues, > >> RedCloth is maintained by a separate team from Instiki. If you have > >> a suspected or confirmed bug, I recommend checking out the RedCloth > >> homepage, with links to the project page, mailing > >> lists, etc.: > >> http://whytheluckystiff.net/ruby/redcloth/ > >> > >> To the specific issue that you cite, I believe that your > >> interpretation of Textile is > >> incorrect in this case. All of the "block modifiers" must begin a > >> paragraph. This is > >> essentially all of the modifiers that end in a period, e.g. "hn.", > >> "p.", "bq.", and so forth. > >> Your example "-- p(link). blah" places the "p." after the start of > >> the paragraph, so it (correctly) isn''t recognized. > >> > >> Possible solutions are to start the paragraph with the "p." marker: > >> > >> p(#link). -- blah > >> > >> which produces: > >> > >> <p id="link">—blah</p> > >> > >> Or alternatively use a Textile span marker: > >> > >> -- %(#link)blah% > >> > >> to get: > >> > >> <p>—<span class="link">blah</span></p> > >> > >> FYI, The above examples were generated via RedCloth 3.0.4. > >> > >> -- John > >> > >> On Jun 13, 2006, at 3:28 PM, Joseph Perrie wrote: > >> > >>> I replicated the alleged bug here: > >>> > >>> http://instiki.org/show/AnchorBug > >>> > >>> Tony > >>> > >>> _______________________________________________ > >>> Instiki-users mailing list > >>> Instiki-users at rubyforge.org > >>> http://rubyforge.org/mailman/listinfo/instiki-users > >> > >> _______________________________________________ > >> Instiki-users mailing list > >> Instiki-users at rubyforge.org > >> http://rubyforge.org/mailman/listinfo/instiki-users > >> > > _______________________________________________ > > Instiki-users mailing list > > Instiki-users at rubyforge.org > > http://rubyforge.org/mailman/listinfo/instiki-users > > _______________________________________________ > Instiki-users mailing list > Instiki-users at rubyforge.org > http://rubyforge.org/mailman/listinfo/instiki-users >