Carl,<div><br></div><div>Very nice, I like the look of this.<br><div class="gmail_extra"><br><br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
A couple of months ago, I posted an idea on this list and got some<br>
feedback from Thomas and Matthias. The idea is to apply default CSS to<br>
Markdown cells.</blockquote><div><br></div><div> I see that you have just applied these styles to text cells, rather than the rendered_html class. Right now the tour version you are dealing with puts the heading cells in the markdown rather than using actual heading cells. I have a PR open that updates all example notebooks to use actual heading cells:</div>
<div><br></div><div>I think we want to have these styles applied to the heading cells, as well as HTML output, so I would use the rendered_html class. </div><div><br></div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Thomas suggested that the feature should be easy to disable, but on by<br>
default. I was also advised to expect a few iterations on the actual<br>
styles themselves. The PR wasn't made as I wanted to test the styles<br>
on a few real notebooks, to ensure the changes worked in practice.<br>
I've since had a chance to do that.<br>
<br></blockquote><div><br></div><div>But there are a few bigger issues here - I think I missed the earlier discussion - so I feel like I am playing catch up. Some general thoughts on this.</div><div><br></div><div>* There is a very specific look I have been trying to create with the notebook, namely that of a clean, empty piece of white paper. This means have a very simple, uncluttered look with an absolute minimum number of visual distractions and minimal styling. Even adding the subtle shading to the code cell's input area was a difficult decision, but one that I think does make sense. I think this is really important and is a key part of the notebook's user experience. In light of this, I think the style you have created, while very good looking, doesn't match these overall design goals. Because of this, I don't think it makes sense to have it as the default.</div>
<div>* I regularly use custom styles in markdown cells to customize the look of individual notebooks. This is such a simple and elegant solution for customization. We should create a place on the github wiki that points to css files on gists that have nice styles such as this, that users can plug into notebooks. If this turns out to be a nice way of working, we could think about including this customization point in the notebook's (yet to be written) configuration UI.</div>
<div>* I am willing to consider changing the notebook styling, but there has to be a clearly identified problem each change is solving. One change that I have thought about is that the current heading styles take up a bit too much vertical space. That makes it difficult to view notebooks on screens with small vertical real estate. This is a very specific problem that has a specific, focused solution.</div>
<div><br></div><div>Some specific comments about your style though:</div><div><br></div><div>* In some contexts it really is useful to emphasize the heading styles - I like how that is done here.</div><div>* In general, we are using a small amount of border radius on all of our rectangles with borders. The sharp corners of the heading divs look inconsistent with the rest of the UI look.</div>
<div>* I think the fill colors of the different heading levels need to have a more consistent color scheme. For example, right now the h1 color is grey, but the h2 level is the same as the code cells. Could you try to just lighten or darken the code cell's fill color for the different heading levels?</div>
<div>* I am finding that font size used in notebooks is very specific to the purpose of the notebook. For example, in presentations I up the font-size dramatically. I see you are using a larger font size (16pt for text) that may or may not make sense for users.</div>
<div>* There are many things that I do like about your style though and in some contexts I would use it. </div><div>* It would be wonderful if we could start to use less for all of our css - even cooler if users could enter css using less in markdown cells. That would make it *much* easier to tune the look with a few lines of css/less.</div>
<div><br></div><div>Cheers,</div><div><br></div><div>Brian</div><div><br></div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I'm attaching my version of the Brief Tour notebook, with the styles<br>
applied, in the hope that I could get some feedback on both the styles<br>
and the new version of the notebook. I would have used nbviewer, but<br>
it currently ignores the styles tag that I've stashed inside the<br>
topmost Markdown cell.<br>
<br>
There's no urgency here at all ~ there's still plenty to iron out on<br>
both fronts anyway ~ but I'd really appreciate any input.<br>
<br>
Thanks for your time<br>
<br>
Carl<br>
<br>
# Notes<br>
* The <hr> style rule is a hack and will be looked into some more<br>
* The Tour could really do with an example of a HTML widget<br>
communicating with the kernel, in a section called Widgets<br>
* The English hasn't been spell checked or proof read<br>
* The Acknowledgements could probably do with some editing. I<br>
didn't know much about the history of some of the libraries, and<br>
didn't know where to draw the line with what names to mention<br>
* The notebook is meant for people with no knowledge of IPython<br>
so it isn't going to teach a core dev much<br>
* The notebook is meant as a fun demo, so no real instructions on<br>
Notebook use are included<br>
<br>_______________________________________________<br>
IPython-dev mailing list<br>
<a href="mailto:IPython-dev@scipy.org">IPython-dev@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/ipython-dev" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-dev</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br>Brian E. Granger<br>Cal Poly State University, San Luis Obispo<br><a href="mailto:bgranger@calpoly.edu" target="_blank">bgranger@calpoly.edu</a> and <a href="mailto:ellisonbg@gmail.com" target="_blank">ellisonbg@gmail.com</a><br>
<br>
</div></div>