<div dir="ltr">Hi Ariel,<div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Jul 25, 2015 at 10:58 PM, Ariel Rokem <span dir="ltr"><<a href="mailto:arokem@gmail.com" target="_blank">arokem@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hi Eleftherios, <div><br></div><div>I am happy to have you finally chime in on the discussion surrounding the webpage. The previous email thread was indeed supposed to spur this discussion, but it did fairly quickly turn into a discussion of github workflow and technical issues surrounding redirection instead. So - better late than never! </div><div><br></div></div></blockquote><div><br></div><div>Okay.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div></div><div>As I mentioned in my first email in that previous thread (can't link to it, because the archives on mail.<a href="http://scipy.org" target="_blank">scipy.org</a> are down...), this redesign was the result of conversations at the Berkeley coding sprint back in May. While talking to some relative newcomers, we noticed that the content in the old webpage was really confusing, and gave a somewhat misleading picture of the current state of affairs in the nipy community. For example, I don't think that anyone here really thinks that neuroimaging in Python is only 6 projects, or that one of the first projects people should try out is pbrain (which was one of the six previously mentioned on the front page). So, I don't think that going to the old version of the page is a good solution. <br></div></div></blockquote><div><br></div><div>Okay but this new website as it is now is not ready to be online too. It is still misleading and I find it difficult to understand what the portal is about. It needs much more work to be useful. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div></div><div><br></div><div>Like almost everything else around here, the webpage is of course work in progress. For example, I can relate to the objections regarding the background image on the front page. I had full intention of replacing the background image with something (possibly several things rotating?) more indicative of the subject matter. I just haven't had the time to do that yet. If someone else wants to jump in and do that, this is the file that would need to be replaced:</div></div></blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><br></div><div><div><a href="https://github.com/nipy/nipy.github.com/blob/master/images/rect1600x800.png" target="_blank">https://github.com/nipy/nipy.github.com/blob/master/images/rect1600x800.png</a></div></div><div><br></div></div></blockquote><div>I think from now on when a new website like this is created which affects other projects it shouldn't replace immediately the existing website but have a link in the existing website saying that there is a new website coming. In that way the transition is smoother and it gives you the developer the time to make the website better and get more feedback. </div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div></div><div>I am sure that a bit of logic could be used to put in several different attractive images of brain data from which one would be chosen randomly every time you land on the page.</div><div><br></div></div></blockquote><div>Yes, you can put a carousel in the website and remove that background with many images. You should also remove the mission with the form it is now. It doesn't communicate.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div></div><div>Concerning choice of design/technology: as Vanessa pointed out, the technology used for these pages is <a href="http://jekyllrb.com/" target="_blank">Jekyll</a>. It has the following advantages: </div><div><br></div><div>1. It is the 'native' technology on Github's platform. That means that we can version control on the markdown from which the site gets generated, and the site itself gets built on Github, rather than needing to be built on anyone's machine every time changes are made. This makes it relatively easy to extend the website, work on it collaboratively using the standard github workflow, and to add additional content. I've even put some instructions in <a href="http://nipy.org/contribute/" target="_blank">http://nipy.org/contribute/</a> on how to add such content, especially articles/blog posts. Happy to have people write little articles in that vein, and make things a little bit more lively. It really doesn't have to be a dissertation - writing down a few lines reporting on some new cool project you've seen, or reporting from a conference you've attended from the nipy point of view would be wonderful. </div><div> </div><div>2. Reasonably good-looking, with plenty of customization possible. This is, of course, a matter of taste, so I don't expect anyone to agree with me. Whether having more colors on a page or not is better is really not something I expect anyone to agree with me on. I certainly would not object to changes to the current design that wouldn't be too gaudy. Concerning a comment Gael made: what does a "structured" layout mean? Is that a web-design term? I am (surprise!) not a web designer ;-) </div></div></blockquote><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>The only disadvantage of Jekyll I can see is that it is Ruby-based. I think that point 1 above outweighs that disadvantage. Point 2 is really a matter for some discussion, and additional work. By the way, whether to use Jekyll is also a discussion that has come up in the context of Software Carpentry. I think that no one in that community regrets choosing jekyll to manage a much more complicated network of web sites, but we can ask them for more advice, if someone thinks that would be useful. </div><div><br></div></div></blockquote><div><br></div><div>As I said in my previous e-mail this website can be created using Pelican too or with Sphinx and Bootstrap and it will be more pythonic. About option 2. Jetkyll can be good looking because of bootstrap. We have exactly the same good looks with Sphinx or Pelican. By the way also Pelican supports both markdown and rst.</div><div><br></div><div>What it seems as advantage is 1. but in practice it is not a big advantage because even if people submit their markdown scripts the website will be updated only when those are merged and still you will need someone checking if they render correctly. I prefer if people who submit content check the final website first in their machine before updating the final website. </div><div><br></div><div>We can still use Jekyll only for the portal but the websites of the rest of the projects will have to use sphinx anyway. So, why bother introducing new tech.</div><div><br></div><div>So, my final suggestion is to use Pelican for the portal which supports everything that Jekyll supports and works in github fine. And for the other websites e.g. dipy, nibabel etc. use sphinx with the same or similar theme used in the portal but with some alternations to create a unique look for each project.</div><div><br></div><div>Some immediate actions: </div><div>a) For now I think you should at least add this information <a href="http://nipy.org/project-directory/" target="_blank">http://nipy.org/project-directory/</a> to the first page and explain what is your vision of this portal. </div><div>b) Definitely change this background picture maybe add a neuro-related picture. You don't need to wait for others to do that. You can do that by yourself too. I am sure you have many cool pictures around. </div><div>c) Then let's set a meeting together and with other people who want to help and I can show you how Pelican/Bootstrap work so you can then see the benefits by yourself. Don't worry nothing from the content that you added in <a href="http://nipy.org">nipy.org</a> is going to be lost. All these markdowns can also be used with Pelican.</div><div><br></div><div>I will be available after Wednesday to help you with this.</div><div><br></div><div>Cheers,</div><div>Eleftherios</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div></div><div>Cheers, </div><span><font color="#888888"><div><br></div><div>Ariel </div></font></span><div><div><div><br></div><div><br></div><div><div class="gmail_extra"><div class="gmail_quote">On Sat, Jul 25, 2015 at 6:46 AM, Eleftherios Garyfallidis <span dir="ltr"><<a href="mailto:garyfallidis@gmail.com" target="_blank">garyfallidis@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Hi Gael, Vanessa and Ariel,<div><br></div><div>Gael I think the previous e-mail thread was about moving the pages into <a href="http://github.io" target="_blank">github.io</a> and not about the design, the technology or the content of <a href="http://nipy.org" target="_blank">nipy.org</a>. This being the portal of all projects needs to communicate the ideas better and use libraries that can be used in other projects too. Hopefully also be as Pythonic as possible and as useful and attractive as possible.</div><div><br></div><div>So, my point is that the new portal, although it has some nice ideas, for examle it is using bootstrap which allows for better and more responsive viewing</div><div>from different devices, it is not ready for prime time. And it shouldn't be online with the form that is now. So, I would recommend to use the previous website with updated links to the new github pages until this one is in a better form.</div><div><br></div><div>Now about the technology used for creating the website. From my understanding Ariel is using the default engine promoted by github which is jekyll which at the end is using bootstrap. But bootstrap can be used with sphinx and with pelican too which are both Python projects.</div><div> </div><div>So we could actually have two better options. For the portal we can use: </div><div><br></div><div>a) Pelican which is an alternative of Octpress/Jekyll in Python. I used it to make my  own website and it is easy to use for creating static websites (like the portal). Link here <a href="http://garyfallidis.github.io" target="_blank">http://garyfallidis.github.io</a> and here <a href="https://github.com/Garyfallidis/website-dev" target="_blank">https://github.com/Garyfallidis/website-dev</a> . Pelican supports both markdown and restructuredtext.</div><div><br></div><div>b) It is now possible to use Sphinx with bootstrap directly. See here <a href="https://readthedocs.org/projects/sphinx-bootstrap-theme/" target="_blank">https://readthedocs.org/projects/sphinx-bootstrap-theme/</a> and here <a href="https://pypi.python.org/pypi/sphinx-bootstrap-theme/" target="_blank">https://pypi.python.org/pypi/sphinx-bootstrap-theme/</a></div><div>The option is possibly the best solution as we could just update our template engine (to use bootstrap) and continue using sphinx as before. But now we can use any template we want and have a much more responsive website.</div><div><br></div><div>Ideally the portal should have a main theme and then the different projects would make some alterations to this theme to create their individual image. For example in Dipy our main colors are black and orange so we will alternate the theme so we can use mainly those colors is our website.<br></div><div><br></div><div>Vanessa of course I am writing this e-mail because I am willing up to my capacity to help Ariel or anyone else who wants to improve the look and feel of the organization. <br></div><div><br></div><div>Ariel in summary, I think the portal is not well designed right now and the content needs some more work before it is presented. I am happy to help and I think you will find it useful to have a look in the links that I have in this e-mail before we meet. In the meantime, I would strongly suggest to upload the old portal until we have something more solid. I hope this is okay.</div><div><br></div><div>Cheers,</div><div>Eleftherios</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote"><span>On Sat, Jul 25, 2015 at 4:41 AM, Gael Varoquaux <span dir="ltr"><<a href="mailto:gael.varoquaux@normalesup.org" target="_blank">gael.varoquaux@normalesup.org</a>></span> wrote:<br></span><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span>On Fri, Jul 24, 2015 at 08:57:48PM -0400, Eleftherios Garyfallidis wrote:<br></span>
> It seems that <a href="http://nipy.org" rel="noreferrer" target="_blank">nipy.org</a> has recently changed. The previous page was much<span><br>
<span>> better from what we have now.<br>
<br>
</span>I agree with you that the previous page was much better in term of design<br>
(more colors, a more structured layout, and an image that looked like a<br>
brain clearly visible) and of content (clear list of main projects and<br>
subprojects).<br>
<br>
However, the change was advertised. I understand that you missed it: we<br>
all have too much mails and too many things to do.<br>
<br>
I think that you could make proposals and maybe pull requests to shape<br>
the website toward something that you like better. It would be great.<br>
<br>
Gaël<br>
</span><div><div>_______________________________________________<br>
Neuroimaging mailing list<br>
<a href="mailto:Neuroimaging@python.org" target="_blank">Neuroimaging@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/neuroimaging" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/neuroimaging</a><br>
</div></div></blockquote></div><br></div>
<br>_______________________________________________<br>
Neuroimaging mailing list<br>
<a href="mailto:Neuroimaging@python.org" target="_blank">Neuroimaging@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/neuroimaging" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/neuroimaging</a><br>
<br></blockquote></div><br></div></div></div></div></div>
<br>_______________________________________________<br>
Neuroimaging mailing list<br>
<a href="mailto:Neuroimaging@python.org" target="_blank">Neuroimaging@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/neuroimaging" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/neuroimaging</a><br>
<br></blockquote></div><br></div></div></div>