Blog post on using coordinates to model loops

[wtbarnes]

This blog post is a tutorial for using the sunpy.coordinates module for modeling loops on the Sun. Any feedback (on the code and/or text) is greatly appreciated!

[Cadair]

Oh man that renders lovely: https://deploy-preview-133--sunpy.netlify.com/posts/2018/2018-07-21-coronal-loop-coordinates.html

[Cadair]

The only comment with this is that some of the code in the cells is too wide for the width of the code cells. We should probably try and make the code cells wider?

[Cadair]

Also is there a "download this notebook" link we can build in somewhere?

[wtbarnes]

Yeah I agree that the code cells are annoyingly narrow. I tried to avoid long lines when writing the notebook so that it is more readable. Glancing at nbsphinx and even nbconvert, it doesn't seem there's an easy way to adjust the code cell width.

[Cadair]

I would take a guess that it's being limited by our theme css. @nabobalis ?

[wtbarnes]

Re: a download link, I have a PR ready for #132 that will automatically generate a link to the static notebook and the binder notebook at the top of each post. Because I'm bad at branching, it is easier to merge this PR first and then I'll submit the other.

[wtbarnes]

Oh true. That box on the left is pretty wide. Maybe making that a bit more narrow would help.

[nabobalis]

Maybe? We can change the CSS tho.

[nabobalis]

Looks good to me.

[Cadair]

We could also CSS out the input and output cell markers? That gives us quite a bit more space?

[nabobalis]

Probably? I don't think we touch those normally in the CSS.

[nabobalis]

Is the problem the code cells have scroll bars?

[wtbarnes]

Could do. That may involve a PR to nbsphinx

[Cadair]

Also @wtbarnes I would put your bio at the top.

[Cadair]

That may involve a PR to nbsphinx

We could just do it in the sunpy theme I would think.

[wtbarnes]

Feels like it might be too distracting at the top

[wtbarnes]

To strip out the In[],Out[] tags, I think you might have intervene at the nbconvert step which is controlled by nbsphinx... I may be wrong here.

[nabobalis]

Could we not somehow use these?

https://github.com/jupyter/nbconvert-examples/tree/master/latex_cell_style

[Cadair]

I think sunpy/sunpy-sphinx-theme#58 should do the job

[wtbarnes]

Sure, but I think the issue is getting nbsphinx to use your custom template (i.e. tpl file). See spatialaudio/nbsphinx#132. Currently, doesn't look like the nbsphinx supports custom templates.

[wtbarnes]

[wtbarnes]

@Cadair nice

[Cadair]

How much control does nbsphinx give you over the colour scheme of the cells? I don't like the lack of contrast in the current ones, not great for accessibility etc.

[wtbarnes]

I think it just depends on the syntax highlighter you're using.

[wtbarnes]

You can set the pygments style in the theme.conf file of the theme

[Cadair]

Nabil you wanna roll out a theme update before or after merging this?

[nabobalis]

Err, either?

[Cadair]

I leave it up to you.

[nabobalis]

Done. You can revert it back to normal now.

[nabobalis]

Once more

[wtbarnes]

🎉