[IPython-dev] CodeMirror versions?
Doug Blank
doug.blank at gmail.com
Thu Jun 19 15:11:31 EDT 2014
On Thu, Jun 19, 2014 at 2:27 PM, Fernando Perez <fperez.net at gmail.com>
wrote:
> Hey Doug,
>
> as you look into markdown questions for more academic/scientific work,
> it's worth keeping an eye on "Pandoc markdown":
>
> http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown
>
> which is an extension in this direction, and one that was adopted by the
> last version of RStudio for their RMarkdown work:
>
> http://www.rstudio.com/products/rstudio/download/preview/
>
Thanks for the links! The RStudio may be particularly useful, as they would
be wrestling with the same constraints as IPython. As a philosophy, we'll
try to keep the rendering incremental from top to bottom.
This requires server-side components (and pandoc, at that!), but if things
> gain traction in this direction, it may be better to collaborate rather
> than reinvent...
>
Agreed!
-Doug
>
> Cheers
>
> f
>
>
> On Thu, Jun 19, 2014 at 4:15 AM, Doug Blank <doug.blank at gmail.com> wrote:
>
>> On Wed, Jun 18, 2014 at 2:33 PM, MinRK <benjaminrk at gmail.com> wrote:
>>
>>> IPython 2.x uses CodeMirror 3.22
>>>
>>> IPython 3.x will use CodeMirror 4.x (but currently 3.24)
>>>
>>> Note that CodeMirror doesn’t do anything other than input. It is not
>>> involved in rendering markdown. We use marked
>>> <https://github.com/chjj/marked> for this, with gfm=True. If you are
>>> interested in what markdown rendering is available, the marked docs are the
>>> place to look.
>>>
>> Thanks, that is what I needed to know. I was looking for docs like:
>>
>> http://codemirror.net/mode/markdown/index.html
>>
>> (which doesn't seem to be 100% compatible with marked)
>>
>> But for marked, I could only find:
>>
>> https://github.com/chjj/marked/tree/master/test/tests
>>
>> Of course there is:
>>
>>
>> http://nbviewer.ipython.org/github/ipython/ipython/blob/2.x/examples/Notebook/Markdown%20Cells.ipynb
>>
>> but is not exhaustive, and requires a running kernel to see the source
>> markdown. It also points to:
>>
>> http://daringfireball.net/projects/markdown/syntax
>>
>> which might be 100% compatible (can't tell for certain), but is not the
>> easiest documentation for a new student to read. For example, it assumes
>> that the user understands HTML.
>>
>> We're looking for markdown documentation specific to notebooks, good for
>> beginners, kernel agnostic, covers LaTeX etc, and gives the output in terms
>> of rendered text. Anything like that exist?
>>
>> Thanks!
>>
>> -Doug
>>
>>
>>> -MinRK
>>>
>>>
>>>
>>> On Wed, Jun 18, 2014 at 9:13 AM, Doug Blank <doug.blank at gmail.com>
>>> wrote:
>>>
>>>> We are working on making some refinements to the CodeMirror markdown in
>>>> IPython, and trying to figure out exactly what version of CodeMirror is in
>>>> IPython.
>>>>
>>>> I see that ipython-components has been updated to CodeMirror 3.24:
>>>>
>>>>
>>>> https://github.com/ipython/ipython-components/commit/0e1db04d7ef79db0ef0cac8c78f01838d4b2ce2b
>>>>
>>>> What version of CodeMirror is in IPython 2.1?
>>>>
>>>> I was trying some of the items documented here in IPython 2.1 (like
>>>> references) but they do not render:
>>>>
>>>> http://codemirror.net/mode/markdown/index.html
>>>>
>>>> What is a better help document for everything that IPython + CodeMirror
>>>> supports?
>>>>
>>>> -Doug
>>>>
>>>>
>>>>
>>>> _______________________________________________
>>>> IPython-dev mailing list
>>>> IPython-dev at scipy.org
>>>> http://mail.scipy.org/mailman/listinfo/ipython-dev
>>>>
>>>>
>>>
>>> _______________________________________________
>>> IPython-dev mailing list
>>> IPython-dev at scipy.org
>>> http://mail.scipy.org/mailman/listinfo/ipython-dev
>>>
>>>
>>
>> _______________________________________________
>> IPython-dev mailing list
>> IPython-dev at scipy.org
>> http://mail.scipy.org/mailman/listinfo/ipython-dev
>>
>>
>
>
> --
> Fernando Perez (@fperez_org; http://fperez.org)
> fperez.net-at-gmail: mailing lists only (I ignore this when swamped!)
> fernando.perez-at-berkeley: contact me here for any direct mail
>
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20140619/88af947d/attachment.html>
More information about the IPython-dev
mailing list