# [IPython-User] nbconvert converts to/from IPyNB or just from IPyNb?

Nitin Borwankar nborwankar@gmail....
Sat Feb 23 18:48:56 CST 2013

Matthias,

Re: your comment about knitr - yes knitr is similar to what I am saying but
IPyNB metaphor is, IMHO, superior as it is not tied to a single language.
Just my massively unashamedly biased opinion.

I am using knitr for a Coursera class right now - I like it a lot but I
think pandoc + markdown + IPyNB ends up winning.  Right now R is way ahead
due to very mature stats libs and easy to use for statistician
non-programmers.

I use %%R a lot for my content creation. Nbviewer views coming soon.

In my opinion general purpose languages win in the longer term as they have
law of large numbers (of users) on their side and they get better and
better.  R object model and data types and data slicing can cause
irreversible brain damage especially to an old time SQL user like myself. I
spend hours resuscitating hundreds of thousands of neurons every day after
my R sessions. :-)

But OTOH, ggplot is very cool and where R works it works really well.  So I
have Stockholm Syndrome with R
:-)

Nitin Borwankar

------------------------------------------------------------------
Nitin Borwankar
nborwankar@gmail.com

On Sat, Feb 23, 2013 at 2:54 PM, Matthias BUSSONNIER <
bussonniermatthias@gmail.com> wrote:

> Hi Nitin,
>
> Le 23 févr. 2013 à 23:24, Nitin Borwankar a écrit :
>
> > Hello all,
> >
> > Sorry if this is a really dumb question and/or a FAQ.
> >
> > First some context to avoid the inevitable - "what are you really trying
> to do?"
> >
> > I have a small amount of funding to create educational content in data
> science in open formats and free licenses so as to be re-usable and
> mashable by the Internet community.
> >
> > I would like to author most of my non-code content in vanilla Markdown
> or Asciidoc in a text editor first. I would like to then "import into" or
> "convert to" IPy NBk so as to then do further authoring and testing of the
> inline code.
> >
> > I need to take existing Markdown and convert it TO IPython format.
> >
> > The Readme for nbconvert says it converts to/from but the examples and
> usage only shows *from* IPython to others.  I need the other way around.
>
> Yes, the nbconvert repository is made to contain both convert To and From
> ipynb, right now we are mostly focused on from,
> The only To converter is  rst2ipynb.py (so dealing with rst...), there is
> the .py to ipynb but this one is of the "put everything in one code cell"
> type.
>
> I don't have knowledge of the other script that generate IPynb files,
> except copy/pasting.
>
>
> > For obvious reasons there is a need, in this scenario, to convert the
> initial Markdown to multiple formats using pandoc (HTML, PDF, Slidey, ...).
> > Most of these will be exposition of the subject and will not contain
> live code.  The Notebook format will be for exercises injected into the
> content.
> >
> > Another need is to keep example code modular and decoupled from the
> content so as to be able to plug in R exercises or NumPy exercises or even
> MATLAB exercises via a build tool depending on user need.
>
> What you describe would also look like knitr [1] is doing (haven't tried
> it though), and I think converter knitr <-> ipynb would be great.
> There is also the %%R and %%matlab magic :-)
>
> > Questions
> >
> > a) forgetting my eventual goal - if I just have some Markdown can I
> convert to IPy Nbk easily - are there some tools - am I missing something
>
> Right now, there is no tool, but it shouldn't be too hard. The most
> difficult would be to define cell "delimiters". (I guess those can be
> "In[*]" and "Out[*]" in some cases)
>
> > b) if my Markdown contains inline latex markup are there additional
> requirements other than making sure mathjax etc is in the browser
> environment.
>
> None that I can see. Even if mathjax can't deal with it, it won't
> **break** the notebook. it will just display the raw tex.
>
> > Thanks much and sorry again if this is a FAQ.
> No problem, this is not a frequently asked question, there is just so much
> to do that we can't fight on all front !
> Keep us posted if you want to try to work a md->ipynb converter, and don't
>
> I opened an issue to track this [2]
>
> --
> Matthias
>
> [1]: http://yihui.name/knitr/
> [2]: https://github.com/ipython/nbconvert/issues/96
>
> _______________________________________________
> IPython-User mailing list
> IPython-User@scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-user
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/ipython-user/attachments/20130223/47a4975d/attachment.html