nimib icon indicating copy to clipboard operation
nimib copied to clipboard

multiDoc and having multiple outputs such as Markdown and Html

Open pietroppeter opened this issue 4 years ago • 0 comments
trafficstars

I like the fact that I can output both html and markdown at the same time. It allows me to have both a html documentation and readme style documentation directly in github.

I do not like current implementation on how to do that (various reasons).

Also I would like to have the possibility to change the content depending on the output format (e.g. in readme I link to github repo and in docs I link to docs: both unnecessary, but linking github repo from docs and docs from gihtub repo are both need).

I am thinking of a generic DoubleDoc feature that will create a second nbDoc2 container and by default they are the same document, but I can change content referring directly to the variable or using special templates such as (nbOnlyDoc1, onlyDoc2 or maybe nbOnlyHtml, nbOnlyMark).

The special case of Html and Markdown format is then generalized to a DoubleDoc or actually maybe let's go fully general as MultiDoc. In order to warrant for this generalization I need to think carefully about good use case that could take advantage of this.

pietroppeter avatar Dec 03 '20 13:12 pietroppeter