[IPython-dev] CodeMirror versions?

[Doug Blank]

On Thu, Jun 19, 2014 at 7:37 AM, Matthias Bussonnier <
bussonniermatthias at gmail.com> wrote:

>
> 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.
>
>
>
> This is the original definition of markdown.
> all other implementation are deviation of the original one.
>
> This is one of the issues with markdown that most extensions have slight
> variations.
>
> Even our way of including TeX in markdown is not teal markdown.
>
> Except for Latex, we are relatively close to GFM:
>
> https://help.github.com/articles/github-flavored-markdown
>

Great, thanks! That is very useful, as it specifies things that work that
IPython's own documentation implies otherwise. For example, on page:

http://nbviewer.ipython.org/github/ipython/ipython/blob/2.x/examples/Notebook/Markdown%20Cells.ipynb

it says:

"Because Markdown is a superset of HTML you can even add things like HTML
tables"

implying that the only way to get tables is through HTML, which is
incorrect.

Looks like we'll be writing some documentation...

-Doug


>
> --
> M
>
>
> Le 19 juin 2014 à 13:15, Doug Blank a écrit :
>
> 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:
>
>
>
>
>
> 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
>
>
>
> _______________________________________________
> 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/1e4a6a10/attachment.html>