fletcher / peg-multimarkdown

An implementation of MultiMarkdown in C, using a PEG grammar - a fork of jgm's peg-markdown. No longer under active development - see MMD 5.
Other
525 stars 55 forks source link

peg MMD vs Perl MMD in HTML Output of Citations & Footnotes #110

Closed johanolofolsson closed 12 years ago

johanolofolsson commented 12 years ago

Short Question: the old Perl MMD outputs citations and footnotes differently from peg MMD, why the change?

Longer Question:

I originally posted this issue on the Marked app support pages: http://support.markedapp.com/discussions/problems/209-marked-incorrectly-processes-mmd-citations-html

But I then learnt that it is a difference between the old Perl MMD (what I remember using on my old linux laptop) and peg MMD, which is what Marked uses.

Essentially, I seem to remember that Perl MMD would output HTML where citations and footnotes were placed in separate divs and were numbered independently of each other. But now they seem to be both put in a footnote div and numbered based on how they appeared in the MMD text. I have to say I liked the old style more, and I was wondering what the rationale was for the change?

Byword seems to come with Perl MMD, as it outputs citations and footnotes in that way. However I do prefer previewing HTML in Marked.

I appreciate that this won't be at the top of your to-do list, and perhaps I'm one of the few who prefers the old output. I also see it as a fun excuse to finally learn some XSLT so that I can tweak the HTML output to exactly what I want.

Cheers,

Johan

fletcher commented 12 years ago

The way the text is processed is completely different with MMD 3 which uses a PEG grammar, and MMD 2 which used a messy batch of perl regular expressions.

When rewriting to accommodate this many things had to be adjusted, but I view almost all of them as improvements and don't plan on changing anything back at this point.

As you say, this is exactly where an xslt can be useful.

F

Sent from my iPhone

On Feb 29, 2012, at 6:49 AM, folo1988reply@reply.github.com wrote:

Short Question: the old Perl MMD outputs citations and footnotes differently from peg MMD, why the change?

Longer Question:

I originally posted this issue on the Marked app support pages: http://support.markedapp.com/discussions/problems/209-marked-incorrectly-processes-mmd-citations-html

But I then learnt that it is a difference between the old Perl MMD (what I remember using on my old linux laptop) and peg MMD, which is what Marked uses.

Essentially, I seem to remember that Perl MMD would output HTML where citations and footnotes were placed in separate divs and were numbered independently of each other. But now they seem to be both put in a footnote div and numbered based on how they appeared in the MMD text. I have to say I liked the old style more, and I was wondering what the rationale was for the change?

Byword seems to come with Perl MMD, as it outputs citations and footnotes in that way. However I do prefer previewing HTML in Marked.

I appreciate that this won't be at the top of your to-do list, and perhaps I'm one of the few who prefers the old output. I also see it as a fun excuse to finally learn some XSLT so that I can tweak the HTML output to exactly what I want.

Cheers,

Johan


Reply to this email directly or view it on GitHub: https://github.com/fletcher/peg-multimarkdown/issues/110

johanolofolsson commented 12 years ago

Thanks for the quick reply. I completely get that changes happen, and are there to satisfy the majority users of MMD. And I guess that's were a bit of fun xslt comes in, for people who want to extend things further.

Cheers, I'll mark this as closed.

Johan.