You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is something I've talked about for a while (and is actually already in progress), and is an important step to completing the vision of Oz as a tool for the "namespace as a notebook" concept.
I'm debating about whether this should be the default option or not. Again, it's something I've stated I would be doing, and I don't think our collective philosophy on "changing" API functions really applies in this case, since we're still taking clojure code and spitting out html; (We're not taking a function that used to take sheep and stone and producing wool into one that produces corn). It's also just not very ergonomic right now to have to embed your markdown in [:md ...] hiccup blocks (for lots of reasons). Finally, Oz is still in alpha, and while I have every intent of not breaking anything (or even really changing behavior like this in unexpected ways), this is exactly the sort of wiggle room I've been trying to preserve with this very long running line of alpha releases. So everything here is pointing to me going ahead and making this the default, but it may be a good idea to add a function which allows for setting global Oz options, so that this behavior can be turned off without too much trouble on the part of the user if need be.
I believe the correct behavior here is more or less what Marginalia embraced: Only lines that specifically start with ;; will be processed as markdown. Lines that look like ;; some indented comment or ;(some-code ...) or even ;;some comment I don't want in the output will not be processed as markdown. This probably should be shown inline with the code if #135 is enabled, but in the code blocks, and not as html.
The text was updated successfully, but these errors were encountered:
This is something I've talked about for a while (and is actually already in progress), and is an important step to completing the vision of Oz as a tool for the "namespace as a notebook" concept.
I'm debating about whether this should be the default option or not. Again, it's something I've stated I would be doing, and I don't think our collective philosophy on "changing" API functions really applies in this case, since we're still taking clojure code and spitting out html; (We're not taking a function that used to take sheep and stone and producing wool into one that produces corn). It's also just not very ergonomic right now to have to embed your markdown in
[:md ...]
hiccup blocks (for lots of reasons). Finally, Oz is still inalpha
, and while I have every intent of not breaking anything (or even really changing behavior like this in unexpected ways), this is exactly the sort of wiggle room I've been trying to preserve with this very long running line ofalpha
releases. So everything here is pointing to me going ahead and making this the default, but it may be a good idea to add a function which allows for setting global Oz options, so that this behavior can be turned off without too much trouble on the part of the user if need be.I believe the correct behavior here is more or less what Marginalia embraced: Only lines that specifically start with
;;
will be processed as markdown. Lines that look like;; some indented comment
or;(some-code ...)
or even;;some comment I don't want in the output
will not be processed as markdown. This probably should be shown inline with the code if #135 is enabled, but in the code blocks, and not as html.The text was updated successfully, but these errors were encountered: