I would like to suggest another more Markdown based flavor when it comes to formatting code blocks und inclusion directives.
Rationale: While everyday coding in the Literate Programming style can be a bit cumbersone, I really like the technique for creating smaller bits of "executable" documentation for the web like blog posts. In this scenario my prefered format is Markdown and the first and formost concern is to publish an article and not to develop software.
Suggestion Code Blocks
Article text
``` { #hellocode .ocaml }
let _ = print_endline "Hello"
```
``` { #hello.ml .ocaml }
<<hellocode>>
```
Hand this is how the html is generated, including nice syntax highlightning
pandoc -s --from=markdown+fenced_code_attributes hello.ml.md > hello.html
I already have changed the regex in lang/web.ml, so I already have a working version.
What do you think of all this?
I would like to suggest another more Markdown based flavor when it comes to formatting code blocks und inclusion directives.
Rationale: While everyday coding in the Literate Programming style can be a bit cumbersone, I really like the technique for creating smaller bits of "executable" documentation for the web like blog posts. In this scenario my prefered format is Markdown and the first and formost concern is to publish an article and not to develop software.
Suggestion Code Blocks
Hand this is how the html is generated, including nice syntax highlightning
I already have changed the regex in lang/web.ml, so I already have a working version.
What do you think of all this?