Table of contents

Fletcher T. Penney fletcher at fletcherpenney.net
Thu Mar 5 13:19:08 EST 2009


MultiMarkdown has the ability to generate such a ToC, complete with
links from the headers back to the ToC via the xhtml-toc.xslt file.

Strictly speaking, this file can be used by xsltproc on any XHTML
file, not necessarily one that was created by MMD.



Fletcher




On Mar 5, 2009, at 1:03 PM, Sherwood Botsford wrote:


> The bird is right on this one. You want easy ways to navigate, and

> multiple ones to navigate.

>

> I *don't* think that markdown is the place for this however.

>

> I find working even with Markdown to put a picture in a file is slow

> and awkward. You want to avoid this level of detail while you are

> writing.

> You want to write, not tweak brackets and braces and such. Don't turn

> MD into the mess that HTML is.

>

> I think this is better approached by your page generating software.

> Consider:

> Write your basic markdown.

> Labelmaker goes through your markdown, and any header lines get an

> auto generated label put before them to create an anchor.

> Labelmaker is customized to look for sequences like ### Table and

> ##### Figure and do the right thing.

>

> The previous-toc-next links are handled by your templating software.

>

> Now you are just writing markdown.

>

> the only thing I'd add to markdown would be a good mechanism for

> resolving links externally, so that if you rename a file, you don't

> have to back trace all the files that reference them. Again this

> should be programmed. You put the link in normally the first time. A

> program pulls the links out, puts a 'external reference link' tag in

> markdown, and adds this to the external link. Ideally it's smart

> enough taht if you reference something several times, it reuses the

> tag. Now if you rename or move a file, you only have to fix it in the

> single external links file.

>

>

>

>

> --

> Sherwood Botsford

> Sherwood's Forests

> Warburg, Alberta T0C 2T0

> http://www.sherwoods-forests.com

> 780-848-2548

> _______________________________________________

> Markdown-Discuss mailing list

> Markdown-Discuss at six.pairlist.net

> http://six.pairlist.net/mailman/listinfo/markdown-discuss




--
Fletcher T. Penney
fletcher at fletcherpenney.net

People demand freedom of speech to make up for the freedom of thought
which they avoid.
- Soren Aabye Kierkegaard (1813-1855)

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 2437 bytes
Desc: not available
Url : <http://six.pairlist.net/pipermail/markdown-discuss/attachments/20090305/b01024ee/attachment.bin>


More information about the Markdown-Discuss mailing list