[IPython-dev] first experiment creating Software Carpentry teaching materials using the IPython Notebook

MinRK benjaminrk at gmail.com
Sun Mar 24 14:51:58 EDT 2013


On Sun, Mar 24, 2013 at 11:45 AM, Greg Wilson <gvwilson at third-bit.com>wrote:

>  On 2013-03-24 2:14 PM, MinRK wrote:
>
>  > MRK:
>
>>  > We are extremely reticent to extend the markdown syntax, because
>>  > maintaining such a thing is well outside our core competency.
>>
>> GVW:
>> Understood.  Am I right that if you could take Markdown rendering out
>> of the core entirely and use someone else's library, you would?
>>
>
>  We already do - we use pagedown, stackexchange's markdown
> implementation.  It has a few small patches for the notebook.
>
> GVW:
> Sorry, I meant, "If you could use someone else's GitHub-compatible
> Markdown renderer" --- or are there reasons to stick to StackExchange's
> dialect?
>

Ah - yes.  A javascript implementation of GHM would be great.


>
>  GVW:
>
>> Indenting four spaces in a Markdown cell mostly works --- the code is
>> colorized, but the background color is white instead of gray.  On the
>> other hand, since this code *isn't* actually being executed, that may
>> be a good thing.  It'll do for now...
>>
>
>  This is a style question - we can tweak the style of the highlighted
> code inside the cell, but it is important that it appear distinct from a
> real code cell.
>
> GVW:
> Agreed.
>
>   GVW:
>
>>
>> 2: Marking cells with particular classes, which will then allow:
>>
>>     2.1: Selectively showing/hiding different kinds of material in a
>>          single notebook.
>>
>>     2.2: Styling (both during display, and when exporting to other
>>          formats like LaTeX).
>>
>
>  Current plan is to release 1.0 in July.
>
>  With one clarification on #2:  There is not a hook for you to add css
> classes to the cells live in the notebook, but this can certainly be added.
>  The cell metadata is how you would do this, but interpreting the metadata
> to add the class to the div will need to be added.
>
> Understood --- but that seems like it _ought_ to be a pretty simple
> extension (he said hopefully).
>

It certainly should be - one thing we would need to do to support such an
extension is add a hook for the 'cell-metadata-changed' event.


> Thanks,
> Greg
>
>
> _______________________________________________
> 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/20130324/9f87ad5a/attachment.html>


More information about the IPython-dev mailing list