Need Developer Docs for adding a new language/kernel

Great tool! Would be great for me and future generations to document the steps needed to add a new language.

Consider Scheme. There is a link to a live kernel here:

Details:

• file extension (that we use): .ss
• comment from here to end of line: ; (often times we use two or more)
• kernel: https://github.com/Calysto/calysto_scheme

Anything else one needs?

[dsblank]

1. I believe that is correct that there are no regular python code that can start with a percent.
2. Other languages can start with percents, but we decided for metakernel, we would put those at very top of cell. Metakernel can have 1, 2, or three percents (3 means sticky magic, and continues to apply)
3. Note that ipython’s magics can appear anywhere, even on right of an equal sign.
4. We are considering allowing some metakernel magics in middle of code, but still at left of line (like %include)

[mwouts]

@dsblank , I will soon review the treatment of magics in Jupytext (and possibly make it simpler, cf. #94). May I ask you two questions?

1. Do you think I can consider any command that starts with one or two percent sign as a ‘magic’? Are there legitimate Python commands that start with one percent sign?
2. Above you mention that metakernel magics may start with up to three percent signs. I have never seen one of those, may I ask you to confirm? Thanks,