Re: [Python-markdown-discuss] New TOC extension.

[Yuri T. <qar...@gm...>]

> Just guessing, but did you turn on anchors in the config (it's off by
> default - and should be IMO)? And did you add the marker ``[TOC]`` to
> the document for placement of the TOC.

Turns out I was putting "[TOC]" into the wrong file. :)  Yes, I agree
that anchor links should be off by default.

> 1. Do nothing (current implementation). Without a marker you don't get
> a TOC - just ids. Although the HeaderID ext already gives you this, so
> the only value here is when an author wants some documents to have a
> TOC, but not others.
>
> 2. Insert the TOC into the beginning of the document by default.
> Although, this may be undesireable in some instances, so would need to
> be configurable.

I am a little divided between those, but if we go with #2, then we
would need a parameter to get #1 behavior, which I think may well be
needed at times.  If we stick with #1, again, a config parameter to
get #2 may be helpful, but less important.

> 3. Make the TOC available as an attribute on the Markdown class (much
> like Meta-Data ext does). This way a templating system could place the
> TOC elsewhere in a HTML template for a document if desired. Actually,
> this could happen regardless of 1 or 2.

Perhaps it would be a little cleaner to make those attributes of the
extensions?  I.e., have something like: md.extensions['toc'].tocTree

 - yuri

-- 
http://sputnik.freewisdom.org/