tomtom-international / asciidoxy

AsciiDoxy generates API documentation from Doxygen XML output to AsciiDoc.
Apache License 2.0
31 stars 10 forks source link

Feature Request: Select template #55

Closed RerrerBuub closed 2 years ago

RerrerBuub commented 2 years ago

When using the previous version V0.7.5., we used a hidden feature (kind_override) to select a template for generating the documentation. With the new release V0.8.0 additional parameter at the insert command are rejected.

On my project I have some structure, that I just like to display at a simple table for other structures need the complete description. I select the kind of documentation generation with kind_override at this way for selecting the template. ${insert("MY_STRUCT_T", kind_override="typedef_table")}

silvester747 commented 2 years ago

Sorry for that, I was not aware this internal detail was used. It should not be hard to expose it again as an official feature. I am considering adding a template argument to insert and adding a command line switch to provide a template directory to search in.

silvester747 commented 2 years ago

The next release of AsciiDoxy will add the template argument to the insert command. The command line argument --template-dir is added to provide your own customized templates to use.

Please note that this is for now considered experimental functionality. The APIs used in the templates are not completely stable yet and may still change. I plan to stabilize them at version 1.0.0.