curvenote / notebooks-in-publishing

Documents for using notebooks in publishing
https://curvenote.github.io/notebooks-in-publishing/
Creative Commons Attribution 4.0 International
3 stars 1 forks source link

👩‍🔬 Draft of inline expressions as <notes> #22

Closed rowanc1 closed 1 year ago

rowanc1 commented 1 year ago

This is a draft of inline expressions which is consistent with other notebook cells/content as well as solves some of the challenges with single notebooks that @dragonstyle raised in #2.

The basic idea is to store these as "footnotes" that are then referenced throughout the document. However, fn presents a bunch of other problems due to what it can have in it -- <notes> on the other hand I think is perfect (maybe @jeffbeckncbi has thoughts?!).

image

This also I think gets around the main article not having to be a notebook. We can also potentially look to milestone-start to record the boundaries of the markdown cells. For the notebook-is-the-article, we should just have a specific use on the sections, and I think we are good to go?!

I am less sure about the notebook/article differences, however, the inline expressions I think are well thought out! Looking forward to feedback.