[IPython-dev] Making custom converter/template with nbconvert

[Rafał Skolasiński]

Hi Thomas,

Yes, that sounds like a logical way. But I still have few question about
how to do it.

First, do I also need to have custom preprocessor? At which point of
conversion it will be the most convenient to make changes?

Should my custom exporter class inherit from a TemplateExporter? Or maybe
separation into files should happen at this level?

And last, once I will have my exporter class will it be enough to specify
which exporter should be used in config file and provide config to
nbconvert via --config mycfg.py ?

Thanks for all your help!

Best,
Rafal

P.S. If there are any useful guides or FAQs about writing custom converters
that would be very helpful. I looked for some on my own but didn't have
much luck.

2014-12-16 23:13 GMT+01:00 Thomas Kluyver <takowl at gmail.com>:
>
> Hi Rafał,
>
> On 16 December 2014 at 13:40, Rafał Skolasiński <rjtskolasinski at gmail.com>
> wrote:
>
>> Unfortunately each unit must go into separate html file and here comes my
>> first question: what is the easiest way to force nbconverter to export one
>> notebook into few html files (let's say Heading 1 will start every unit and
>> at the same time will be the name of it)?
>
>
> I think you will need to make a custom exporter - nbconvert supports
> different output formats with exporter classes, which you can find here:
> https://github.com/ipython/ipython/tree/master/IPython/nbconvert/exporters
>
> Your case will be a bit trickier than most of those examples, because all
> the TemplateExporter subclasses assume that they are writing a single main
> output file. But there's no reason that an exporter class couldn't write
> several files from one notebook.
>
> Thomas
>
> _______________________________________________
> 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/20141218/ab8573d5/attachment.html>