tutorials icon indicating copy to clipboard operation
tutorials copied to clipboard

Org mode tutorials or other formats supported?

Open behrica opened this issue 5 years ago • 4 comments

I would like to contribute my tutorials in form of emacs org mode files... Is this OK? Eventually this means that I would have a org mode file here and 'somewhere' a html file exported from it.

Other people might want to use as well other notebook environments, like 'nextjournal' which are hosted somewhere else, so there is no file to commit. So maybe we should have as well a 'tutorial table' with links somewhere

behrica avatar Mar 02 '19 11:03 behrica

@behrica Yes, good idea!

For reference, here is a similar remark by @genmeblog: https://clojurians.zulipchat.com/#narrow/stream/187445-scicloj-tutorials/topic/no.20notebook

I'll update the README accordingly.

Let us have some drafts, and then start organizing the links as you suggested.

daslu avatar Mar 02 '19 11:03 daslu

Updated the README with the call for using different formats.

daslu avatar Mar 02 '19 13:03 daslu

Given the argumentation in #4, I would propose that this folder should only contain jupyter notebooks and focus on clojupyter as the only supported notebook format (in this folder).

Because then we don't need any project.clj.

If me or others want to contribute "notebooks" in different formats, maybe with additional org or clj files or projecrt.clj files we should handle this outside this folder. (either in a table with links or other repos)

behrica avatar Mar 02 '19 15:03 behrica

Thanks, @behrica.

Regarding clojupyter, gave you seen my remarks at #4? (haven't managed to make clojupyter work without project.clj; also, lein-jupyter is preferable imho)

Regarding directory structure, it seems worth trying to have some topic-based structure (e.g., all solutions related to the same kaggle challenge can lie under the same subdirectory). Could you explain why not?

Thanks!

daslu avatar Mar 02 '19 15:03 daslu