Table of Contents in "commands.xd"

[celtic-coder]

Hi Adam (@xigoi),

The Commands reference document is quite long. Might it be possible to include a Table of Contents (based on the "h2" headings), like the following:

• Introduction
• Top-level commands
• HTML commands
• CSS commands
• Math commands

This will give the reader an overview of the content before they get caught up in the technical details. The document is well-written and comprehensive. Therefore, I believe, that a Table of Contents would make it easier to approach for a new user.

Kind Regards, Liam

[xigoi]

Sounds like a good idea! I'm planning to add a facility for generating a table of contents, but I'm not sure how to fit it into the single-pass nature of xidoc. I might add one manually though.

[celtic-coder]

OK, thanks!

[xigoi]

After a year of head-scratching, I've finally come up with a good way to implement a table of contents command. As a consequence, there is now a table of contents in the command reference.

[celtic-coder]

Great work, thanks! 👍