Re: mkhtml.py: writing HTML documents in Markdown

2008-06-08 Thread Aristotle Pagaltzis
* Kragen Javier Sitaker [EMAIL PROTECTED] [2008-06-08 18:00]:
 On Sat, 7 Jun 2008 17:42:53 +0200, Aristotle Pagaltzis wrote:
  * Kragen Javier Sitaker [EMAIL PROTECTED] [2008-06-07 09:40]:
   Stylesheeting comes naturally. I just put a `style`
   element at the top with a few lines inside of it to format
   nicely.
  
  Note that Markdown ends up wrapping `link` and `style` in
  `p` tags, arguably erroneously.
 
 What, is Markdown supposed to know that those elements are
 neither block-level nor span-level markup?

In fact it is – or to phrase the statement more appropriately, it
is supposed to know that wrapping such elements in `p` tags is
not a useful thing to do. It already avoids wrapping block-level
tags in paragraphs; there is no reason not to extend that list to
also contain all the elements that may appear in the head of an
HTML document, even though they are nominally invalid in the body.

  Of course, neither tag has any business being in the HTML
  body; they should both be in the head. Since you’re loading
  BeautifulSoup anyway, you probably want to include that as
  fix-up step in your postprocessing.
 
 Yeah, I've been planning to do that, but didn't get around to
 doing it before sending it out.  (I also have this theory that
 I'll be a happier person if I don't spend too much time on
 inventing private markup languages, and that makes me perhaps
 unreasonably reluctant to add extra postprocessing steps, even
 when the alternative is ill-formed HTML.)

I agree with that theory, which is why I use Markdown despite the
minor (and a few less minor) things I dislike about it. Attaching
some light postprocessing to Markdown to add support for small
missing bits seems like a much better approach to achieve both
satisfaction and an absence of unhappiness.

I try to write code only when I can’t help it…

Regards,
-- 
Aristotle Pagaltzis // http://plasmasturm.org/
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
http://six.pairlist.net/mailman/listinfo/markdown-discuss


Re: mkhtml.py: writing HTML documents in Markdown

2008-06-07 Thread Aristotle Pagaltzis
[Note to markdown-discuss readers: for context see
http://lists.canonical.org/pipermail/kragen-hacks/2008-June/000488.html]

* Kragen Javier Sitaker [EMAIL PROTECTED] [2008-06-07 09:40]:
 Stylesheeting comes naturally. I just put a `style` element
 at the top with a few lines inside of it to format nicely.

Note that Markdown ends up wrapping `link` and `style`
in `p` tags, arguably erroneously. Weirdly, it looks like
Python-Markdown should avoid that mistake:

* http://babelmark.bobtfish.net/?markdown=%3Cstyle%3Efoo+%7B%7D%3C%2Fstyle%3E
* http://babelmark.bobtfish.net/?markdown=%3Clink+%2F%3E

But at the top of http://canonical.org/~kragen/crywrap.html the
problem shows up anyway.

Of course, neither tag has any business being in the HTML body;
they should both be in the head. Since you’re loading
BeautifulSoup anyway, you probably want to include that as fix-up
step in your postprocessing.

Regards,
-- 
Aristotle Pagaltzis // http://plasmasturm.org/
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
http://six.pairlist.net/mailman/listinfo/markdown-discuss


Re: mkhtml.py: writing HTML documents in Markdown

2008-06-07 Thread Waylan Limberg
On Sat, Jun 7, 2008 at 11:42 AM, Aristotle Pagaltzis [EMAIL PROTECTED] wrote:
 [Note to markdown-discuss readers: for context see
 http://lists.canonical.org/pipermail/kragen-hacks/2008-June/000488.html]

 * Kragen Javier Sitaker [EMAIL PROTECTED] [2008-06-07 09:40]:
 Stylesheeting comes naturally. I just put a `style` element
 at the top with a few lines inside of it to format nicely.

 Note that Markdown ends up wrapping `link` and `style`
 in `p` tags, arguably erroneously. Weirdly, it looks like
 Python-Markdown should avoid that mistake:

Well, first of all, he's using an old version of Python-Markdown. The
first line of his `render` function gives it away (due to the change
in 1.7 to all-unicode -- you generally don't pass unicode text to
str())

body = str(markdown.Markdown(text))

Just use the wrapper (all lowercase in any version):

body = markdown.markdown(text)

IIRC, there was a bugfix in 1.7 that also addressed the raw html
wrapped in p tags thing. So, upgrade to 1.7 and that problem should
go away.



-- 

Waylan Limberg
[EMAIL PROTECTED]
___
Markdown-Discuss mailing list
Markdown-Discuss@six.pairlist.net
http://six.pairlist.net/mailman/listinfo/markdown-discuss