Document how users (or template developers) can add static files

[choldgraf]

It's a bit unclear how custom CSS/JS can be controlled by either users or those who create their own templates. From the command line, it seems like --static provides some way to give a path to a directory w/ these assets, but I'm not sure how to name those files or make sure they actually get loaded by a template.

I think it'd be helpful in the documentation to have:

1. A guide explaining how to include custom CSS / JS with a template (e.g. if I want a template that links a CSS file in the template file itself how would I do that)
2. A guide explaining if it's possible, and if so how to use the --static parameter to control the static assets when voila is run

[choldgraf]

A ping on this one - I think this will be a common request from folks. Can somebody help me get this into the documentation? If you give a short step/by/step I can try it out and then make a PR

[SylvainCorlay]

Now that the default template includes a static directory, this may be a good place to start.

[choldgraf]

Woot - got a partially distill.pub style template working :-)

@SylvainCorlay how do you get the files in https://github.com/QuantStack/voila-gridstack to properly install? Just doing pip install -e won't put them in the proper share/ directory by itself, right?

[SylvainCorlay]

Just doing pip install -e won't put them in the proper share/ directory by itself, right?

Indeed, you need to actually install it without -e.

Using the -e argument prevents the installation of data files.

[maartenbreddels]

Yes, although I think we'd want to 'fix' that by having a custom 'develop' cmd class in setup.py. In voila we have a special case that we detect dev mode and also look in the repo dir.
Nice that you are getting some success with the template system, it's on the agenda for next week.

[choldgraf]

Cool, thanks for the clarification. I'm trying to see how far I could get w templating, will try to make some docs pushes after we give these sdss talks