search

swcarpentry / DEPRECATED-lesson-template

DEPRECATED: THIS REPOSITORY IS NO LONGER IN USE: PLEASE SEE swcarpentry/styles INSTEAD.
Other
22 stars 43 forks source link

How should non-Python input cells be labeled? #116

Closed jdblischak closed 9 years ago

jdblischak commented 9 years ago

In the documentation for creating lessons, it has the input code with the label {.python} and the output code with the label {output}. There is no advice on how to label input cells containing other languages (e.g. R, MATLAB).

I checked what the novice-shell repo did. They labeled the input code cells as {.input}. However this results in black text (ex), unlike the green text in the Python lessons (ex).

gvwilson commented 9 years ago

I believe that {.r} should work - if it doesn't, I'll fix it.

rgaiacs commented 9 years ago

@jdblischak Pandoc supports the following keys to mark the source code language:

I checked what the novice-shell repo did. They labeled the input code cells as {.input}. However this results in black text (ex), unlike the green text in the Python lessons (ex).

My fault, check 4744316a29e0d747d01fafa4049e4fbb2984262f. I wasn't careful to keep back compatibility. #111 should fix this issue. @gvwilson or @twitwi could you take a look and press the green button if OK?

jdblischak commented 9 years ago

Ok, thanks. {.r} does work. I will implement that into the workflow for building topic pages from R Markdown source files.

@r-gaia-cs, that list is very helpful. Do you have a link to it? Could you add a note in the documention that would direct people writing non-Python lessons to this information?

rgaiacs commented 9 years ago

that list is very helpful. Do you have a link to it?

The best way to get it is pandoc --version as you can find in http://pandoc.org/README.html#fenced-code-blocks.

Could you add a note in the documention that would direct people writing non-Python lessons to this information?

Sure.