How would you modify a TOC at build time?

[DavidMarquezF]

In our docs we have some articles that should get excluded depending on a metadata field in the TOC items and a parameter passed to the cmd. From my understanding this should probably be achievable by using document processors. I was looking for a way to extend the TocDocumentProcessor or add another Toc build step, but I'm not sure which is the way to go.

Has anybody tried to do something similar or has any recommendations on how to approach it?

Thanks!

[filzrev]

It can customize generated TOCs on build-time by adding toc.extension.js to docfx custom template.

In our docs we have some articles that should get excluded depending on a metadata field in the TOC items and a parameter passed to the cmd.

Thought by this approach. it can access TOC items metadata. But can't read cmd parameters.

Note

Currently toc.extension.js is applied to toc.html only and not applied to toc.json (that used by modern template).
So it need to customize toc.json.js file also.
See: #9944 (comment)