Create a dynamic table of contents with page numbers in HTML

Question

I have a python script that converts a MarkDown text to HTML (with some additions and styling of my own), The markdown code includes headers and bookmarks, I want the script to automatically create a table of contents that would include the page numbers (like you might find in a printed book for example) based on the assumption that the document would be printed on standard A4 sheets. Is it possible?

Thanks...
YK

Answer 1

Why not use .rst or .md files with sphinx ? You can have a table of contents and it will generate your html and you can do all kinds of fancy stuff with it. An overwhelming majority of python documentation is written using it. It looks like they account for A4 paper size as well in some cases.

From the sphinx docs environment variables section :