Add docs for deploying to Binder

[jtpio]

Fixes #359.

cc @maartenbreddels @martinRenou

[Alexboiboi]

Hi, there
I don't know if it is the right place to ask this but I was wondering if there is a way to give the dark theme when deploying to mybinder?

?urlpath=voila/render/mynotebook.ipynb renders the notebook but how to assign options to it?

Also, is it possible to launch voila from a python script execution? (side question)

[jtpio]

@Alexboiboi the theme can be specified by creating a jupyter_config.json file with the following content:

{
    "VoilaConfiguration": {
        "theme": "dark"
    }
}

Other options can be specified as well. There is an example in the voila-demo repo if you want to check it out.

I think it would make sense to add that to the "Deploy to Binder" docs (or point to the voila-demo repo as reference).

Also, is it possible to launch voila from a python script execution? (side question)

To use on mybinder? Otherwise yes it's possible to do something like this:

from voila.app import Voila
v = Voila()
v.initialize(['.', '--no-browser'])
v.start()

[Alexboiboi]

@jtpio Thanks a lot for your precise answer, this was very helpful!

[jtpio]

Added a section about the jupyter_config.json file.

[jtpio]

This one is ready to go.

[martinRenou]

Ok for me!

[jtpio]

Cool, let's get that in then.